@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.8

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

@@ -0,0 +1,417 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-C5-IVaAZ.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-Dx5UE11l.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Date`}),`
+`,(0,c.jsx)(t.h1,{id:`даты-время-и-календарные-диапазоны`,children:`Даты, время и календарные диапазоны`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль решает четыре связанные задачи:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`парсит даты из JavaScript, ISO, OData и ABAP-представлений;`}),`
+`,(0,c.jsx)(t.li,{children:`форматирует их через встроенные или пользовательские presets;`}),`
+`,(0,c.jsx)(t.li,{children:`выполняет календарную арифметику без скрытого timezone-сдвига;`}),`
+`,(0,c.jsx)(t.li,{children:`строит обычные, относительные и учебные диапазоны дат.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Все функции и типы экспортируются через общий entrypoint:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	formatDateAsDate,
+	getCalendarPeriod,
+	normalizeDateRange,
+	parseDate,
+	parseDateTZ
+} from "@ryuzaki13/react-foundation-lib/formatters";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Импорта `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters/date`}),` нет.`]}),`
+`,(0,c.jsx)(t.h2,{id:`самое-важное-две-timezone-семантики`,children:`Самое важное: две timezone-семантики`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль различает календарные компоненты и абсолютный момент времени.`}),`
+`,(0,c.jsx)(t.h3,{id:`floating-сохранить-видимые-компоненты`,children:`Floating: сохранить видимые компоненты`}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычные `,(0,c.jsx)(t.code,{children:`parseDateValue`}),` и `,(0,c.jsx)(t.code,{children:`parseDate`}),` намеренно не пересчитывают ISO/OData timezone в timezone компьютера пользователя.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const date = parseDate("2026-03-03T18:03:50+05:00");
+
+date?.getFullYear(); // 2026
+date?.getMonth(); // 2, то есть март
+date?.getHours(); // 18
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это полезно для календарных UI-значений: расписания, периода отчёта, дня документа, фильтра «с/по». Пользователь видит те компоненты, которые пришли от сервиса.`}),`
+`,(0,c.jsx)(t.h3,{id:`instant-сохранить-реальный-момент`,children:`Instant: сохранить реальный момент`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`parseDateValueTZ`}),` и `,(0,c.jsx)(t.code,{children:`parseDateTZ`}),` применяют явный timezone и сохраняют Unix instant:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const date = parseDateTZ("2026-03-03T18:03:50+05:00");
+
+date?.toISOString(); // "2026-03-03T13:03:50.000Z"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Локальные getters такого `,(0,c.jsx)(t.code,{children:`Date`}),` зависят от timezone среды. Используйте TZ-вариант, когда значение означает настоящий момент события: timestamp аудита, время серверного события, instant для сортировки между часовыми поясами.`]}),`
+`,(0,c.jsx)(t.h3,{id:`простое-правило-выбора`,children:`Простое правило выбора`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Значение означает`}),(0,c.jsx)(t.th,{children:`Использовать`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Видимую календарную дату/время`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`parseDate`}),`, `,(0,c.jsx)(t.code,{children:`parseDateValue`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Абсолютный момент времени`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`parseDateTZ`}),`, `,(0,c.jsx)(t.code,{children:`parseDateValueTZ`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Строку для обычного UI`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`formatDate*`}),` — внутри floating parser`]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не выбирайте вариант по наличию буквы `,(0,c.jsx)(t.code,{children:`Z`}),` во входе. Выбирайте по бизнес-смыслу данных.`]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { formatDateAsDate, formatDateAsDateTime, formatDateAsODataDate, parseDate } from "@ryuzaki13/react-foundation-lib/formatters";
+
+formatDateAsDate("20260303"); // "03.03.2026"
+formatDateAsDateTime("2026-03-03T18:03:00"); // "03.03.2026 18:03"
+formatDateAsODataDate(new Date(2026, 2, 3)); // "2026-03-03"
+
+const date = parseDate("03.03.2026"); // Date | null
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для невалидного значения formatter по умолчанию возвращает пустую строку:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDateAsDate("not-a-date"); // ""
+formatDateAsDate("not-a-date", { fallback: "—" }); // "—"
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`поддерживаемые-входы`,children:`Поддерживаемые входы`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`parseDateValue`}),`/`,(0,c.jsx)(t.code,{children:`parseDate`}),` принимают `,(0,c.jsx)(t.code,{children:`unknown`}),`, но распознают только конкретные контракты.`]}),`
+`,(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.th,{children:[(0,c.jsx)(t.code,{children:`source`}),` detailed-result`]})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Date`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`new Date(...)`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`date-object`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Unix seconds`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`1_772_563_200`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`timestamp`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Unix milliseconds`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`1_772_563_200_000`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`timestamp`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`OData v2 ticks`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`/Date(1772563200000+0500)/`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odata-ticks`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`OData literal`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`datetime'2026-03-03T18:03:50'`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`odata-literal`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`ABAP date`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`20260303`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`abap-compact`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`ABAP timestamp`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`20260303180350`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`abap-timestamp`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Dotted`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`03.03.2026`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`abap-dotted`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Slash`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`03/03/2026`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`slash-date`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`ISO local`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`2026-03-03T18:03:50`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`iso-local`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`ISO zoned`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`2026-03-03T18:03:50Z`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`iso-zoned`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`ISO duration`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`PT02H30M`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`iso-duration`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Slash-формат интерпретируется как `,(0,c.jsx)(t.code,{children:`MM/DD/YYYY`}),`, а не `,(0,c.jsx)(t.code,{children:`DD/MM/YYYY`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseDate("12/31/2026"); // 31 декабря
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Невалидные календарные компоненты отклоняются, а не переносятся автоматически:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseDate("31.02.2026"); // null
+parseDate("2026-13-01"); // null
+`})}),`
+`,(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:`"null"`}),`/`,(0,c.jsx)(t.code,{children:`"undefined"`}),` без учёта регистра считаются пустыми.`]}),`
+`,(0,c.jsx)(t.h2,{id:`detailed-parsing`,children:`Detailed parsing`}),`
+`,(0,c.jsx)(t.h3,{id:`parsedatevaluevalue`,children:(0,c.jsx)(t.code,{children:`parseDateValue(value)`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает tagged union:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ParsedDateValue =
+	{ kind: "date-time"; source: DateInputSource; date: Date } | { kind: "duration"; source: "iso-duration"; durationMs: number };
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const parsed = parseDateValue("PT02H30M");
+
+if (parsed?.kind === "duration") {
+	parsed.durationMs; // 9_000_000
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте этот API, когда нужно отличить duration от календарной даты или знать распознанный источник.`}),`
+`,(0,c.jsx)(t.h3,{id:`parsedatevaluetzvalue`,children:(0,c.jsx)(t.code,{children:`parseDateValueTZ(value)`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает такую же структуру, но timestamp, ISO zoned и OData ticks интерпретируются как instant. Форматы без timezone всё равно остаются локальными календарными компонентами.`}),`
+`,(0,c.jsxs)(t.h3,{id:`parsedatevalue-и-parsedatetzvalue`,children:[(0,c.jsx)(t.code,{children:`parseDate(value)`}),` и `,(0,c.jsx)(t.code,{children:`parseDateTZ(value)`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращают только `,(0,c.jsx)(t.code,{children:`Date | null`}),`. Duration также превращается в `,(0,c.jsx)(t.code,{children:`Date`}),`, построенный из длительности относительно Unix epoch. Если продолжительность важна именно как величина, используйте `,(0,c.jsx)(t.code,{children:`parseDateValue`}),`, а не `,(0,c.jsx)(t.code,{children:`Date`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`unix-seconds-и-milliseconds`,children:`Unix seconds и milliseconds`}),`
+`,(0,c.jsxs)(t.p,{children:[`Число с абсолютным значением меньше `,(0,c.jsx)(t.code,{children:`1e12`}),` считается секундами, иначе миллисекундами:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseDate(1_772_563_200); // seconds
+parseDate(1_772_563_200_000); // milliseconds
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это эвристика. Не передавайте маленькое число как «год» или «дни с начала периода».`}),`
+`,(0,c.jsx)(t.h3,{id:`iso-duration`,children:`ISO duration`}),`
+`,(0,c.jsx)(t.p,{children:`Поддерживаются годы, месяцы, дни, часы, минуты, секунды и знак. Для duration:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`год приблизительно равен 365 суткам;`}),`
+`,(0,c.jsx)(t.li,{children:`месяц приблизительно равен 30 суткам;`}),`
+`,(0,c.jsx)(t.li,{children:`доли секунды ограничиваются миллисекундами;`}),`
+`,(0,c.jsxs)(t.li,{children:[`полностью пустое `,(0,c.jsx)(t.code,{children:`P`}),`/`,(0,c.jsx)(t.code,{children:`PT`}),` не считается duration.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для календарных расчётов «через один месяц» используйте `,(0,c.jsx)(t.code,{children:`addCalendarMonths`}),`, а не duration `,(0,c.jsx)(t.code,{children:`P1M`}),`: календарный месяц не всегда равен 30 дням.`]}),`
+`,(0,c.jsx)(t.h2,{id:`строгий-парсинг-по-шаблону`,children:`Строгий парсинг по шаблону`}),`
+`,(0,c.jsx)(t.h3,{id:`parsedatebypatternvalue-pattern-options`,children:(0,c.jsx)(t.code,{children:`parseDateByPattern(value, pattern, options?)`})}),`
+`,(0,c.jsx)(t.p,{children:`Поддерживает токены:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Токен`}),(0,c.jsx)(t.th,{children:`Значение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`dd`})}),(0,c.jsx)(t.td,{children:`день, ровно 2 цифры`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`MM`})}),(0,c.jsx)(t.td,{children:`месяц, ровно 2 цифры`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yyyy`})}),(0,c.jsx)(t.td,{children:`год, ровно 4 цифры`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yy`})}),(0,c.jsx)(t.td,{children:`год, ровно 2 цифры`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`HH`})}),(0,c.jsx)(t.td,{children:`часы, ровно 2 цифры`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`mm`})}),(0,c.jsx)(t.td,{children:`минуты, ровно 2 цифры`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ss`})}),(0,c.jsx)(t.td,{children:`секунды, ровно 2 цифры`})]})]})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseDateByPattern("03-03-2026 18:05", "dd-MM-yyyy HH:mm");
+parseDateByPattern("03.03.26", "dd.MM.yy");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Двузначные годы `,(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.jsxs)(t.p,{children:[`Литералы шаблона сравниваются буквально. Токенов переменной длины (`,(0,c.jsx)(t.code,{children:`d`}),`, `,(0,c.jsx)(t.code,{children:`M`}),`, `,(0,c.jsx)(t.code,{children:`H`}),`) нет.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Опция `,(0,c.jsx)(t.code,{children:`precision`}),` может быть:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`day`}),` — нужны год, месяц и день;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`month`}),` — нужны год и месяц, день становится `,(0,c.jsx)(t.code,{children:`1`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`year`}),` — нужен год, дата становится 1 января.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если вход не является строкой, функция делегирует обычному `,(0,c.jsx)(t.code,{children:`parseDateValue`}),`, а pattern не применяется.`]}),`
+`,(0,c.jsx)(t.h3,{id:`parsedatebyformatvalue-dateformat-options`,children:(0,c.jsx)(t.code,{children:`parseDateByFormat(value, dateFormat?, options?)`})}),`
+`,(0,c.jsx)(t.p,{children:`Принимает:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`имя зарегистрированного preset;`}),`
+`,(0,c.jsxs)(t.li,{children:[`style alias `,(0,c.jsx)(t.code,{children:`short`}),`, `,(0,c.jsx)(t.code,{children:`medium`}),`, `,(0,c.jsx)(t.code,{children:`long`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`ручной pattern;`}),`
+`,(0,c.jsx)(t.li,{children:`человекочитаемую строку, созданную Intl preset текущей locale.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseDateByFormat("03.03.2026", "date");
+parseDateByFormat("3 марта 2026 г.", "date-long");
+parseDateByFormat("2026/03/03", "yyyy/MM/dd");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Опции:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ParseDateByFormatOptions = {
+	defaultFormat?: string;
+	locale?: string;
+	precision?: "day" | "month" | "year";
+	referenceDate?: Date;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`referenceDate`}),` задаёт год для presets `,(0,c.jsx)(t.code,{children:`month-short`}),`, `,(0,c.jsx)(t.code,{children:`month-medium`}),`, `,(0,c.jsx)(t.code,{children:`month-long`}),`, которые выводят день и месяц без года. По умолчанию используется текущий календарный год, поэтому для тестов передавайте reference явно.`]}),`
+`,(0,c.jsx)(t.h2,{id:`форматирование`,children:`Форматирование`}),`
+`,(0,c.jsx)(t.h3,{id:`formatdatevalue-presetorname-options`,children:(0,c.jsx)(t.code,{children:`formatDate(value, presetOrName?, options?)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function formatDate(
+	value: unknown,
+	presetOrName?: string | DateFormatPreset,
+	options?: { fallback?: string; precision?: DateFormatPrecision }
+): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию используется preset `,(0,c.jsx)(t.code,{children:`date`}),` и precision `,(0,c.jsx)(t.code,{children:`day`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDate("20260303"); // "03.03.2026"
+formatDate("20260303", "abap-date"); // "20260303"
+formatDate("bad", "date", { fallback: "—" }); // "—"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Неизвестное имя preset выбрасывает `,(0,c.jsx)(t.code,{children:`Error`}),` до форматирования входа:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDate("bad", "unknown"); // Error: preset не найден
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`precision`,children:`Precision`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDate(date, "date-long", { precision: "day" }); // день, месяц, год
+formatDate(date, "date-long", { precision: "month" }); // месяц и год
+formatDate(date, "date-long", { precision: "year" }); // год
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для pattern preset лишние токены даты удаляются вместе с промежуточными литералами. Time-only preset не приобретает календарные части.`}),`
+`,(0,c.jsx)(t.h2,{id:`готовые-datetime-wrappers`,children:`Готовые date/time wrappers`}),`
+`,(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:`formatDateAsDate`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`03.03.2026`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsDateTime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`03.03.2026 18:03`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsTime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`18:03`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsTimeSeconds`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`18:03:50`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsDateShort`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`03.03.2026`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsDateMedium`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`3 мар. 2026 г.`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsDateLong`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`3 марта 2026 г.`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsMonthShort`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`03.03`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsMonthMedium`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`3 мар.`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsMonthLong`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`3 марта`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsMonthYearMedium`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`мар. 2026`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsMonthYearLong`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`март 2026`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsTimeShort`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`18:03`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsTimeMedium`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`18:03:50`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsTimeLong`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`18:03:50`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsDatetimeShort`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`03.03.2026, 18:03`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsDatetimeMedium`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`3 мар. 2026 г., 18:03:50`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsDatetimeLong`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`3 марта 2026 г., 18:03:50`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Точный punctuation и пробельные символы Intl могут слегка зависеть от JavaScript runtime/ICU. Не разбирайте человекочитаемый результат вручную, если нужен машинный контракт.`}),`
+`,(0,c.jsx)(t.h2,{id:`машинные-wrappers-abapodata`,children:`Машинные wrappers ABAP/OData`}),`
+`,(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:`formatDateAsAbapYear`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yyyy`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsAbapMonth`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yyyyMM`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsAbapDate`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yyyyMMdd`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsAbapDatetime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yyyyMMddHHmmss`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsODataDate`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yyyy-MM-dd`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsODataDatetime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`yyyy-MM-ddTHH:mm:ss`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatDateAsODataTime`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`PT00H00M00S`})})]})]})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDateAsAbapDate(new Date(2026, 2, 3)); // "20260303"
+formatDateAsODataDatetime(new Date(2026, 2, 3, 18, 5, 9));
+// "2026-03-03T18:05:09"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Эти строки собираются из локальных календарных компонентов и не добавляют timezone marker.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`formatDateAsODataTime`}),` принимает как дату, так и ISO duration:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDateAsODataTime("PT02H30M05S"); // "PT02H30M05S"
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`formatdaterange`,children:(0,c.jsx)(t.code,{children:`formatDateRange`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Форматирует две границы одним preset и соединяет через `,(0,c.jsx)(t.code,{children:`-`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatDateRange("20260301", "20260331");
+// "01.03.2026 - 31.03.2026"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если хотя бы одна граница не распарсилась или отформатировалась в пустой результат, возвращается общий fallback. Функция не сортирует границы. Для нормализации порядка сначала используйте `,(0,c.jsx)(t.code,{children:`normalizeDateRange`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`presets`,children:`Presets`}),`
+`,(0,c.jsx)(t.h3,{id:`встроенные-имена`,children:`Встроенные имена`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`DEFAULT_DATE_PRESET_NAMES`}),` содержит:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`date, date-short, date-medium, date-long
+month-short, month-medium, month-long
+month-year-medium, month-year-long
+datetime, datetime-seconds
+datetime-short, datetime-medium, datetime-long
+time, time-seconds
+time-short, time-medium, time-long
+odata-date, odata-datetime
+abap-datetime, abap-date, abap-month, abap-year
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`DATE_FORMAT_STYLE_PRESET_NAMES`}),` связывает aliases `,(0,c.jsx)(t.code,{children:`short`}),`, `,(0,c.jsx)(t.code,{children:`medium`}),`, `,(0,c.jsx)(t.code,{children:`long`}),` с `,(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.jsxs)(t.h3,{id:`getdatepreset-и-getdatepresetnames`,children:[(0,c.jsx)(t.code,{children:`getDatePreset`}),` и `,(0,c.jsx)(t.code,{children:`getDatePresetNames`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const preset = getDatePreset("date-long");
+const names = getDatePresetNames();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getDatePreset`}),` возвращает реестровый объект, не clone. Не мутируйте его. `,(0,c.jsx)(t.code,{children:`getDatePresetNames`}),` возвращает новый массив в порядке регистрации.`]}),`
+`,(0,c.jsx)(t.h3,{id:`registerdatepresetconfig`,children:(0,c.jsx)(t.code,{children:`registerDatePreset(config)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`registerDatePreset({
+	name: "report-date",
+	pattern: "dd/MM/yyyy",
+	invalidFallback: "—"
+});
+
+formatDate("20260303", "report-date"); // "03/03/2026"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Недостающие поля берутся из `,(0,c.jsx)(t.code,{children:`DATE_FORMAT_DEFAULTS`}),`: locale `,(0,c.jsx)(t.code,{children:`ru-RU`}),`, стандартные Intl date fields и пустой invalid fallback.`]}),`
+`,(0,c.jsx)(t.p,{children:`Вместо pattern можно использовать:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`intlOptions`}),` для единого formatter-а;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`intlDateOptions`}),` + `,(0,c.jsx)(t.code,{children:`intlTimeOptions`}),` + optional `,(0,c.jsx)(t.code,{children:`intlJoiner`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`durationPattern`}),` для ISO durations.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Настройки `,(0,c.jsx)(t.code,{children:`timeZone`}),` и `,(0,c.jsx)(t.code,{children:`timeZoneName`}),` намеренно удаляются: модуль сохраняет календарную семантику и не должен скрыто сдвигать компоненты.`]}),`
+`,(0,c.jsx)(t.p,{children:`Регистрация глобальна. Делайте её один раз на старте до компиляции formatter pipeline. Имя и конфигурация не проходят полноценную пользовательскую валидацию.`}),`
+`,(0,c.jsx)(t.h3,{id:`объектный-preset`,children:`Объектный preset`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const preset: DateFormatPreset = {
+	name: "inline",
+	pattern: "yyyy/MM/dd HH:mm",
+	locale: "ru-RU",
+	invalidFallback: "—"
+};
+
+formatDate(value, preset);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Объектный preset не регистрируется. Скомпилированная версия кешируется в `,(0,c.jsx)(t.code,{children:`WeakMap`}),` по identity объекта, поэтому переиспользуйте один стабильный объект вместо создания нового на каждую ячейку.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`resolvedateformatname-и-resolvedateformatpreset`,children:[(0,c.jsx)(t.code,{children:`resolveDateFormatName`}),` и `,(0,c.jsx)(t.code,{children:`resolveDateFormatPreset`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`resolveDateFormatName`}),` trim-ит вход, применяет default для пустого значения и преобразует style alias:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveDateFormatName(" medium "); // "date-medium"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`resolveDateFormatPreset`}),` возвращает:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`имя, если такой preset зарегистрирован;`}),`
+`,(0,c.jsx)(t.li,{children:`кешируемый объектный pattern preset, если имя не найдено.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const presetOrName = resolveDateFormatPreset("yyyy/MM/dd");
+formatDate(value, presetOrName);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Эта функция считает любую неизвестную непустую строку ручным pattern. Если строка не содержит поддерживаемых tokens, результат будет в основном literal-текстом.`}),`
+`,(0,c.jsx)(t.h3,{id:`resetdatepresets`,children:(0,c.jsx)(t.code,{children:`resetDatePresets()`})}),`
+`,(0,c.jsx)(t.p,{children:`Удаляет пользовательские presets и восстанавливает встроенные. Используйте прежде всего в тестах.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Публичной функции `,(0,c.jsx)(t.code,{children:`clearDateFormatCache`}),` нет. Сброс реестра выполняется только `,(0,c.jsx)(t.code,{children:`resetDatePresets`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`проверки-формата`,children:`Проверки формата`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isDateFormatStyle("short"); // true
+isDateFormatPrecision("month"); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это type guards для строго заданных строк.`}),`
+`,(0,c.jsx)(t.h2,{id:`pattern-constants`,children:`Pattern constants`}),`
+`,(0,c.jsx)(t.p,{children:`Экспортируются:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`DATE_PATTERN_DATE_TOKENS`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`DATE_PATTERN_TIME_TOKENS`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`DATE_PATTERN_TOKENS`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`DATE_PATTERN_TOKEN_RE`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Массивы заморожены. Регулярное выражение имеет флаг `,(0,c.jsx)(t.code,{children:`g`}),`, поэтому при ручном вызове `,(0,c.jsx)(t.code,{children:`test`}),`/`,(0,c.jsx)(t.code,{children:`exec`}),` учитывайте изменяемый `,(0,c.jsx)(t.code,{children:`lastIndex`}),` или сбрасывайте его перед новым независимым проходом.`]}),`
+`,(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:`createCalendarDate(2026, 2, 3, 18, 5); // месяц zero-based: 2 === март
+getStartOfDay(date); // 00:00:00.000
+getEndOfDay(date); // 23:59:59.000
+getStartOfMonth(date); // первое число, 00:00
+getStartOfYear(date); // 1 января, 00:00
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createCalendarDate`}),` повторяет нормализующее поведение конструктора `,(0,c.jsx)(t.code,{children:`new Date`}),`: например, лишний день переносится в следующий месяц. Она не является валидатором пользовательских компонентов.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Обратите внимание: `,(0,c.jsx)(t.code,{children:`getEndOfDay`}),` возвращает миллисекунды `,(0,c.jsx)(t.code,{children:`000`}),`, а не `,(0,c.jsx)(t.code,{children:`999`}),`. Для включительного сравнения значений с миллисекундами в последней секунде дня это может быть важно.`]}),`
+`,(0,c.jsx)(t.h3,{id:`неделя`,children:`Неделя`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getStartOfWeek(date); // понедельник по умолчанию
+getStartOfWeek(date, 0); // воскресенье
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`weekStartsOn`}),` использует нумерацию `,(0,c.jsx)(t.code,{children:`Date.getDay()`}),`: `,(0,c.jsx)(t.code,{children:`0`}),` — воскресенье, `,(0,c.jsx)(t.code,{children:`1`}),` — понедельник. Целые значения нормализуются по модулю 7, нецелое значение заменяется на `,(0,c.jsx)(t.code,{children:`1`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сдвиги`,children:`Сдвиги`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`addCalendarDays(date, 1);
+addCalendarMonths(date, -1);
+addCalendarYears(date, 1);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Результаты создаются на начале суток. Используется нативное календарное переполнение JavaScript. Например, сдвиг 31 января на один месяц может перейти в март, потому что «31 февраля» нормализуется конструктором `,(0,c.jsx)(t.code,{children:`Date`}),`. Если нужен clamp к последнему дню целевого месяца, реализуйте это явным отдельным правилом.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сравнение-дня`,children:`Сравнение дня`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isSameCalendarDay(left, right);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сравнивает только локальные year/month/day. Для не-`,(0,c.jsx)(t.code,{children:`Date`}),` возвращает `,(0,c.jsx)(t.code,{children:`false`}),`; валидность `,(0,c.jsx)(t.code,{children:`Date#getTime()`}),` отдельно не проверяет.`]}),`
+`,(0,c.jsx)(t.h2,{id:`обычные-диапазоны-дат`,children:`Обычные диапазоны дат`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type DateRange = readonly [Date, Date];
+type NullableDateRange = readonly [Date | null, Date | null];
+type DateRangeInput = Date | null | NullableDateRange;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`проверки-и-копирование`,children:`Проверки и копирование`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`isValidDate(value)`}),` — настоящий конечный `,(0,c.jsx)(t.code,{children:`Date`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`isDateRangeTuple(value)`}),` — runtime-проверка массива;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cloneDate(date)`}),` — новый `,(0,c.jsx)(t.code,{children:`Date`}),` с тем же timestamp;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`orderDates(left, right)`}),` — упорядоченная пара, но те же исходные objects.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`resolvedaterangepairvalue`,children:(0,c.jsx)(t.code,{children:`resolveDateRangePair(value)`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализует форму диапазона без клонирования и без изменения времени:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`одиночная дата → `,(0,c.jsx)(t.code,{children:`[date, date]`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`две валидные даты → упорядоченная пара;`}),`
+`,(0,c.jsx)(t.li,{children:`одна валидная граница → эта дата в обеих позициях;`}),`
+`,(0,c.jsxs)(t.li,{children:[`ни одной даты → `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizedaterangevalue-options`,children:(0,c.jsx)(t.code,{children:`normalizeDateRange(value, options?)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const range = normalizeDateRange([end, start]);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`По умолчанию:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`упорядочивает границы;`}),`
+`,(0,c.jsx)(t.li,{children:`клонирует их;`}),`
+`,(0,c.jsx)(t.li,{children:`start приводит к началу суток;`}),`
+`,(0,c.jsx)(t.li,{children:`end приводит к концу суток.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeDateRange(value, { timeMode: "preserve" });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`preserve`}),` сохраняет время после упорядочивания, но всё равно возвращает новые `,(0,c.jsx)(t.code,{children:`Date`}),` objects.`]}),`
+`,(0,c.jsx)(t.h3,{id:`requiredaterangevalue-options`,children:(0,c.jsx)(t.code,{children:`requireDateRange(value, options?)`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает нормализованный диапазон либо выбрасывает `,(0,c.jsx)(t.code,{children:`Error("Диапазон дат не задан")`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`countcalendardaysindaterangevalue`,children:(0,c.jsx)(t.code,{children:`countCalendarDaysInDateRange(value)`})}),`
+`,(0,c.jsx)(t.p,{children:`Считает календарные дни включительно и не зависит от DST-длины локальных суток:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`countCalendarDaysInDateRange([new Date(2026, 2, 1), new Date(2026, 2, 1)]); // 1
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для пустого диапазона возвращает `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`календарные-периоды`,children:`Календарные периоды`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getCalendarPeriod(value, options?)`}),` строит включительные границы выбранного периода:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getCalendarPeriod(date, { selectionMode: "day" });
+getCalendarPeriod(date, { selectionMode: "week", weekEndDay: "saturday" });
+getCalendarPeriod(date, { selectionMode: "month" });
+getCalendarPeriod(date, { selectionMode: "year" });
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию mode — `,(0,c.jsx)(t.code,{children:`day`}),`, а week заканчивается в воскресенье. Неделя всегда начинается в понедельник; `,(0,c.jsx)(t.code,{children:`weekEndDay`}),` может быть `,(0,c.jsx)(t.code,{children:`friday`}),`, `,(0,c.jsx)(t.code,{children:`saturday`}),` или `,(0,c.jsx)(t.code,{children:`sunday`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`isDateInsideCalendarPeriod(value, period)`}),` проверяет включение календарного дня. `,(0,c.jsx)(t.code,{children:`isCalendarPeriodWithinDateBounds(period, { minDate, maxDate })`}),` требует, чтобы весь период помещался между необязательными границами.`]}),`
+`,(0,c.jsx)(t.h2,{id:`относительные-диапазоны`,children:`Относительные диапазоны`}),`
+`,(0,c.jsx)(t.p,{children:`Все resolver-ы принимают явный контекст:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const context = { referenceDate: new Date(2026, 2, 15, 12) };
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(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:`resolveTodayRange`})}),(0,c.jsx)(t.td,{children:`начало и конец reference day`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveYesterdayRange`})}),(0,c.jsx)(t.td,{children:`начало и конец предыдущего дня`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveMonthStartToTodayRange`})}),(0,c.jsx)(t.td,{children:`с 1-го числа по сегодня`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveMonthStartToYesterdayRange`})}),(0,c.jsx)(t.td,{children:`с 1-го числа по вчера`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveMonthAgoRange`})}),(0,c.jsx)(t.td,{children:`тот же календарный день прошлого месяца — сегодня`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`На первом числе `,(0,c.jsx)(t.code,{children:`resolveMonthStartToYesterdayRange`}),` прижимает end к началу текущего месяца, чтобы не получить инвертированный диапазон.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeDateRangeReferenceDate`}),` просто возвращает начало суток reference date.`]}),`
+`,(0,c.jsx)(t.p,{children:`Передавайте reference date явно, особенно в тестах, SSR и timezone-sensitive сценариях.`}),`
+`,(0,c.jsx)(t.h2,{id:`учебный-календарь`,children:`Учебный календарь`}),`
+`,(0,c.jsx)(t.p,{children:`Учебный год начинается 1 сентября и заканчивается 31 августа. Учебная неделя отображает понедельник–субботу; воскресенье относится к следующей учебной неделе.`}),`
+`,(0,c.jsx)(t.h3,{id:`ключ-даты-и-времени`,children:`Ключ даты и времени`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatEducationDateKey(new Date(2026, 2, 3)); // "2026-03-03"
+parseEducationDateKey("2026-03-03"); // Date
+formatEducationTimeKey(new Date(2026, 2, 3, 9, 5)); // "09:05"
+createEducationDateTime("2026-03-03", "09:05:30"); // Date
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Парсер date key строгий: только `,(0,c.jsx)(t.code,{children:`YYYY-MM-DD`}),` и реальная дата. Time key — `,(0,c.jsx)(t.code,{children:`HH:mm`}),` или `,(0,c.jsx)(t.code,{children:`HH:mm:ss`}),`, с проверкой диапазонов.`]}),`
+`,(0,c.jsx)(t.p,{children:`Ключ не несёт timezone-семантики и строится из локальных календарных компонентов. Он подходит для URL, query key и SQL-параметра только если это соответствует контракту сервиса.`}),`
+`,(0,c.jsx)(t.h3,{id:`учебный-год`,children:`Учебный год`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getEducationYear(date); // год, в котором учебный год начался
+getEducationYearRange(date); // { year, start, end }
+isEducationDateInCurrentYear(value, now); // boolean
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для даты в августе 2026 функция `,(0,c.jsx)(t.code,{children:`getEducationYear`}),` вернёт `,(0,c.jsx)(t.code,{children:`2025`}),`; для сентября 2026 — `,(0,c.jsx)(t.code,{children:`2026`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`учебная-неделя`,children:`Учебная неделя`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getEducationWeekStartDate(date); // понедельник
+getEducationWeekRange(date); // понедельник–суббота
+getEducationWeekDays(date); // 6 ключей YYYY-MM-DD
+getCurrentEducationWeekKey(now);
+normalizeEducationWeekKey(input, now);
+resolveEducationWeekKey(input, now);
+isCurrentEducationWeek(key, now);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeEducationWeekKey`}),` возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если ключ невалиден, находится вне текущего учебного года или его понедельник вышел за границы учебного года.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`resolveEducationWeekKey`}),` в таком случае возвращает текущую учебную неделю.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getEducationWeekDays`}),` имеет особый fallback: невалидная строка silently заменяется неделей текущей системной даты. Если это нежелательно, сначала вызовите `,(0,c.jsx)(t.code,{children:`parseEducationDateKey`}),`/`,(0,c.jsx)(t.code,{children:`normalizeEducationWeekKey`}),` самостоятельно.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для детерминированных тестов всегда передавайте `,(0,c.jsx)(t.code,{children:`now`}),` в функции, где он поддержан.`]}),`
+`,(0,c.jsx)(t.h2,{id:`практические-рецепты`,children:`Практические рецепты`}),`
+`,(0,c.jsx)(t.h3,{id:`ui-фильтр-диапазона`,children:`UI-фильтр диапазона`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const range = normalizeDateRange([draft.start, draft.end]);
+
+if (!range) {
+	return undefined;
+}
+
+const [from, to] = range;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`машинный-ключ-без-utc-сдвига`,children:`Машинный ключ без UTC-сдвига`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const date = parseDate(userValue);
+const key = date ? formatDateAsODataDate(date) : undefined;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`настоящий-timestamp-события`,children:`Настоящий timestamp события`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const eventInstant = parseDateTZ(api.createdAt);
+const unixMs = eventInstant?.getTime();
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`безопасный-пользовательский-preset`,children:`Безопасный пользовательский preset`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`export function configureDateFormatters(): void {
+	registerDatePreset({
+		name: "document-date-time",
+		pattern: "dd.MM.yyyy HH:mm:ss",
+		invalidFallback: "—"
+	});
+}
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`использовать-new-dateyyyy-mm-dd-для-календарной-даты`,children:[`Использовать `,(0,c.jsx)(t.code,{children:`new Date("YYYY-MM-DD")`}),` для календарной даты`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нативный parsing может включить UTC-семантику и сдвинуть видимый день. Используйте `,(0,c.jsx)(t.code,{children:`parseDate`}),` или `,(0,c.jsx)(t.code,{children:`parseEducationDateKey`}),` в зависимости от контракта.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ожидать-timezone-conversion-от-обычного-formatter-а`,children:`Ожидать timezone conversion от обычного formatter-а`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`formatDate`}),` использует floating parsing. Для instant сначала разберите `,(0,c.jsx)(t.code,{children:`parseDateTZ`}),`, а дальнейшее локальное/UTC отображение проектируйте явно.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`считать-getendofday-концом-с-999`,children:[`Считать `,(0,c.jsx)(t.code,{children:`getEndOfDay`}),` концом с `,(0,c.jsx)(t.code,{children:`.999`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущий контракт — `,(0,c.jsx)(t.code,{children:`23:59:59.000`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидать-clamp-от-addcalendarmonths`,children:[`Ожидать clamp от `,(0,c.jsx)(t.code,{children:`addCalendarMonths`})]}),`
+`,(0,c.jsx)(t.p,{children:`Функция использует native overflow. Последний день месяца требует отдельного правила.`}),`
+`,(0,c.jsx)(t.h3,{id:`использовать-human-readable-output-как-api-payload`,children:`Использовать human-readable output как API payload`}),`
+`,(0,c.jsx)(t.p,{children:`Intl-форматы локализованы. Для API используйте ABAP/OData wrappers или отдельный transport serializer.`}),`
+`,(0,c.jsx)(t.h3,{id:`регистрировать-preset-при-каждом-рендере`,children:`Регистрировать preset при каждом рендере`}),`
+`,(0,c.jsx)(t.p,{children:`Реестр глобальный, а компиляция должна выполняться один раз. Настраивайте presets на bootstrap-stage.`}),`
+`,(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:`Публичный API`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Parsing`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`parseDateValue`}),`, `,(0,c.jsx)(t.code,{children:`parseDateValueTZ`}),`, `,(0,c.jsx)(t.code,{children:`parseDate`}),`, `,(0,c.jsx)(t.code,{children:`parseDateTZ`}),`, `,(0,c.jsx)(t.code,{children:`parseDateByPattern`}),`, `,(0,c.jsx)(t.code,{children:`parseDateByFormat`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Universal format`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`formatDate`}),`, `,(0,c.jsx)(t.code,{children:`formatDateRange`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`UI wrappers`}),(0,c.jsxs)(t.td,{children:[`все `,(0,c.jsx)(t.code,{children:`formatDateAsDate*`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsMonth*`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsTime*`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsDatetime*`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Machine wrappers`}),(0,c.jsxs)(t.td,{children:[(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:`formatDateAsODataDate`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsODataDatetime`}),`, `,(0,c.jsx)(t.code,{children:`formatDateAsODataTime`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Presets`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`DATE_FORMAT_DEFAULTS`}),`, `,(0,c.jsx)(t.code,{children:`DEFAULT_DATE_PRESET_NAMES`}),`, `,(0,c.jsx)(t.code,{children:`DATE_FORMAT_STYLE_PRESET_NAMES`}),`, `,(0,c.jsx)(t.code,{children:`getDatePreset`}),`, `,(0,c.jsx)(t.code,{children:`getDatePresetNames`}),`, `,(0,c.jsx)(t.code,{children:`registerDatePreset`}),`, `,(0,c.jsx)(t.code,{children:`resetDatePresets`}),`, `,(0,c.jsx)(t.code,{children:`resolveDateFormatName`}),`, `,(0,c.jsx)(t.code,{children:`resolveDateFormatPreset`}),`, type guards`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Calendar`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`createCalendarDate`}),`, `,(0,c.jsx)(t.code,{children:`getStartOfDay`}),`, `,(0,c.jsx)(t.code,{children:`getEndOfDay`}),`, `,(0,c.jsx)(t.code,{children:`getStartOfWeek`}),`, `,(0,c.jsx)(t.code,{children:`getStartOfMonth`}),`, `,(0,c.jsx)(t.code,{children:`getStartOfYear`}),`, `,(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:`isSameCalendarDay`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Ranges`}),(0,c.jsxs)(t.td,{children:[(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`}),`, `,(0,c.jsx)(t.code,{children:`resolveDateRangePair`}),`, `,(0,c.jsx)(t.code,{children:`normalizeDateRange`}),`, `,(0,c.jsx)(t.code,{children:`requireDateRange`}),`, `,(0,c.jsx)(t.code,{children:`countCalendarDaysInDateRange`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Periods`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`getCalendarPeriod`}),`, `,(0,c.jsx)(t.code,{children:`isDateInsideCalendarPeriod`}),`, `,(0,c.jsx)(t.code,{children:`isCalendarPeriodWithinDateBounds`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Relative ranges`}),(0,c.jsxs)(t.td,{children:[(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:`resolveMonthStartToTodayRange`}),`, `,(0,c.jsx)(t.code,{children:`resolveMonthStartToYesterdayRange`}),`, `,(0,c.jsx)(t.code,{children:`resolveMonthAgoRange`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Education`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`parseEducationDateKey`}),`, `,(0,c.jsx)(t.code,{children:`formatEducationDateKey`}),`, `,(0,c.jsx)(t.code,{children:`formatEducationTimeKey`}),`, `,(0,c.jsx)(t.code,{children:`createEducationDateTime`}),`, `,(0,c.jsx)(t.code,{children:`getEducationYear`}),`, `,(0,c.jsx)(t.code,{children:`getEducationYearRange`}),`, `,(0,c.jsx)(t.code,{children:`isEducationDateInCurrentYear`}),`, `,(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.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Pattern metadata`}),(0,c.jsxs)(t.td,{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.jsxs)(t.p,{children:[`Соответствующие types (`,(0,c.jsx)(t.code,{children:`DateFormatPreset`}),`, `,(0,c.jsx)(t.code,{children:`FormatDateOptions`}),`, range/period/education types и parse options) экспортируются из того же `,(0,c.jsx)(t.code,{children:`/formatters`}),` entrypoint.`]}),`
+`,(0,c.jsx)(t.h3,{id:`каталог-публичных-типов`,children:`Каталог публичных типов`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Область`}),(0,c.jsx)(t.th,{children:`Типы`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Parsing и format`}),(0,c.jsxs)(t.td,{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.jsx)(t.code,{children:`ResolveDateFormatPresetOptions`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Диапазоны`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`NullableDateRange`}),`, `,(0,c.jsx)(t.code,{children:`DateRange`}),`, `,(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.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Периоды`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`CalendarPeriod`}),`, `,(0,c.jsx)(t.code,{children:`CalendarPeriodOptions`}),`, `,(0,c.jsx)(t.code,{children:`CalendarPeriodSelectionMode`}),`, `,(0,c.jsx)(t.code,{children:`CalendarWeekEndDay`}),`, `,(0,c.jsx)(t.code,{children:`CalendarPeriodDateBounds`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Учебный календарь`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`EducationDateKey`}),`, `,(0,c.jsx)(t.code,{children:`EducationYearRange`}),`, `,(0,c.jsx)(t.code,{children:`EducationWeekRange`})]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Импортируйте их с модификатором `,(0,c.jsx)(t.code,{children:`type`}),`, чтобы подчеркнуть отсутствие runtime-значения:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type { DateFormatPresetConfig, DateRange, NormalizeDateRangeOptions } from "@ryuzaki13/react-foundation-lib/formatters";
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`связанная-документация`,children:`Связанная документация`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`../README.mdx`,children:[`Обзор `,(0,c.jsx)(t.code,{children:`formatters`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../pipeline/README.mdx`,children:`Formatter pipeline`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../number/README.mdx`,children:`Числовые форматтеры`})}),`
+`]})]})}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};