@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.12

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

@@ -0,0 +1,101 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,li:`li`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/Data/Currency`}),`
+`,(0,c.jsxs)(t.h1,{id:`валютные-подписи-через-ryuzaki13react-foundation-libcurrency`,children:[`Валютные подписи через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/currency`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль связывает общий OData-параметр `,(0,c.jsx)(t.code,{children:`p_curr`}),` с отображаемой подписью показателя. Он определяет один из двух режимов валюты и добавляет соответствующий суффикс к label.`]}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5`,children:`Назначение`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#currencymode`,children:(0,c.jsx)(t.code,{children:`CurrencyMode`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#resolvecurrencymodefromodataparameters`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyModeFromODataParameters`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#resolvecurrencyawarelabel`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyAwareLabel`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D1%8B%D0%B9-pipeline`,children:`Готовый pipeline`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%B8-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Ограничения и ошибки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#api-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA`,children:`API-справочник`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение`,children:`Назначение`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`wrapped OData params
+{ p_curr: { value: true } }
+              │
+              ▼
+      CurrencyMode "rub"
+              │
+              ▼
+"Выручка" + ["за тн", "руб/тн"]
+              │
+              ▼
+       "Выручка руб/тн"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не форматирует денежное число, не конвертирует валюту и не строит OData query. Для чисел используйте `,(0,c.jsx)(t.code,{children:`/formatters`}),`, для OData params — `,(0,c.jsx)(t.code,{children:`/odata-service`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { resolveCurrencyAwareLabel, resolveCurrencyModeFromODataParameters } from "@ryuzaki13/react-foundation-lib/currency";
+
+import type { CurrencyMode } from "@ryuzaki13/react-foundation-lib/currency";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль ESM, не требует React или browser API. Параметры должны иметь публичную wrapped-форму из `,(0,c.jsx)(t.code,{children:`/odata-service`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`currencymode`,children:(0,c.jsx)(t.code,{children:`CurrencyMode`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type CurrencyMode = "internal" | "rub";
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`internal`}),` — внутренний режим;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`rub`}),` — рублёвый режим.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`null`}),` используется resolver-функцией, когда режим определить нельзя.`]}),`
+`,(0,c.jsx)(t.h2,{id:`resolvecurrencymodefromodataparameters`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyModeFromODataParameters`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const mode = resolveCurrencyModeFromODataParameters(params);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция читает только собственное поле `,(0,c.jsx)(t.code,{children:`p_curr.value`}),`:`]}),`
+`,(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.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`поля `,(0,c.jsx)(t.code,{children:`p_curr`}),` нет`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: false } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"internal"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: true } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"rub"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: "true" } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ p_curr: { value: 1 } }`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Строка `,(0,c.jsx)(t.code,{children:`"true"`}),` намеренно не приводится к boolean. Нормализуйте внешний payload на OData boundary, а не внутри UI label.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Пример с helper `,(0,c.jsx)(t.code,{children:`/odata-service`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { wrapODataParams } from "@ryuzaki13/react-foundation-lib/odata-service";
+
+const params = wrapODataParams({ p_curr: true });
+const mode = resolveCurrencyModeFromODataParameters(params);
+// "rub".
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`resolvecurrencyawarelabel`,children:(0,c.jsx)(t.code,{children:`resolveCurrencyAwareLabel`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const label = resolveCurrencyAwareLabel("Выручка", ["за тн", "руб/тн"], "rub");
+// "Выручка руб/тн".
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пара `,(0,c.jsx)(t.code,{children:`currencyLabels`}),` имеет фиксированный смысл:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`readonly[(internalLabel, rubLabel)];
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Mode`}),(0,c.jsx)(t.th,{style:{textAlign:`right`},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:`internal`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`0`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`rub`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`1`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Точные правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`без `,(0,c.jsx)(t.code,{children:`currencyLabels`}),` возвращается исходный `,(0,c.jsx)(t.code,{children:`label`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`при `,(0,c.jsx)(t.code,{children:`null`}),`/`,(0,c.jsx)(t.code,{children:`undefined`}),` mode возвращается исходный `,(0,c.jsx)(t.code,{children:`label`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`суффикс обрезается через `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`пустой суффикс не добавляется;`}),`
+`,(0,c.jsx)(t.li,{children:`обычно между label и суффиксом добавляется один пробел;`}),`
+`,(0,c.jsx)(t.li,{children:`если обрезанный суффикс начинается с запятой, дополнительный пробел не добавляется.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`resolveCurrencyAwareLabel("Выручка", [", за тн", ", руб/тн"], "rub");
+// "Выручка, руб/тн".
+
+resolveCurrencyAwareLabel("Выручка", ["", "   "], "rub");
+// "Выручка".
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Исходный `,(0,c.jsx)(t.code,{children:`label`}),` не обрезается и не нормализуется.`]}),`
+`,(0,c.jsx)(t.h2,{id:`готовый-pipeline`,children:`Готовый pipeline`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function buildMetricLabel(
+	baseLabel: string,
+	currencyLabels: readonly [string, string] | undefined,
+	params: WrappedODataParameters | undefined
+) {
+	const mode = resolveCurrencyModeFromODataParameters(params);
+	return resolveCurrencyAwareLabel(baseLabel, currencyLabels, mode);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Resolver чистый: одинаковый вход даёт одинаковую строку и не меняет params/labels.`}),`
+`,(0,c.jsx)(t.h2,{id:`ограничения-и-ошибки`,children:`Ограничения и ошибки`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Поддерживается только параметр с точным id `,(0,c.jsx)(t.code,{children:`p_curr`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Поддерживаются только два режима; код валюты `,(0,c.jsx)(t.code,{children:`USD`}),`, `,(0,c.jsx)(t.code,{children:`EUR`}),` и exchange rate не обрабатываются.`]}),`
+`,(0,c.jsx)(t.li,{children:`Функция не проверяет грамматику и единицы измерения.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Запятая должна входить в сам суффикс, если нужна форма `,(0,c.jsx)(t.code,{children:`"Выручка, руб"`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Не передавайте плоский `,(0,c.jsx)(t.code,{children:`{ p_curr: true }`}),`: ожидается `,(0,c.jsx)(t.code,{children:`{ p_curr: { value: true } }`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Не используйте label helper для финансовых вычислений.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`api-справочник`,children:`API-справочник`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(0,c.jsx)(t.th,{children:`Результат`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`CurrencyMode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"internal" | "rub"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveCurrencyModeFromODataParameters`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`CurrencyMode | null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`resolveCurrencyAwareLabel`})}),(0,c.jsx)(t.td,{children:`Итоговая display-строка`})]})]})]})]})}function s(e={}){let{wrapper:t}={...n(),...e.components};return t?(0,c.jsx)(t,{...e,children:(0,c.jsx)(o,{...e})}):o(e)}var c;function l(){return(l=e((()=>{c=t(),r(),a()})))()}l();export{s as default};

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

@@ -0,0 +1,208 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,li:`li`,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/Date/Segments`}),`
+`,(0,c.jsxs)(t.h1,{id:`сегменты-даты-и-времени-через-ryuzaki13react-foundation-libdate-segments`,children:[`Сегменты даты и времени через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/date-segments`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль разбирает строковую маску на редактируемые сегменты и литералы, преобразует `,(0,c.jsx)(t.code,{children:`Date`}),` в значения полей и строго собирает `,(0,c.jsx)(t.code,{children:`Date`}),` обратно. Он предназначен для segment-based date/time inputs.`]}),`
+`,(0,c.jsx)(t.p,{children:`Документ объясняет маски, индексы, local time, двухзначный год, неполный ввод и все публичные типы.`}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,children:`Назначение и границы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D0%B0%D0%B7%D0%BE%D0%B2%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F`,children:`Базовые понятия`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5-tokens`,children:`Поддерживаемые tokens`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#parsedatesegmentmask`,children:(0,c.jsx)(t.code,{children:`parseDateSegmentMask`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#iseditabledatesegment`,children:(0,c.jsx)(t.code,{children:`isEditableDateSegment`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#datetoindexedsegmentvalues`,children:(0,c.jsx)(t.code,{children:`dateToIndexedSegmentValues`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#arealldatesegmentsempty`,children:(0,c.jsx)(t.code,{children:`areAllDateSegmentsEmpty`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#indexedsegmentstodate`,children:(0,c.jsx)(t.code,{children:`indexedSegmentsToDate`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9-input-pipeline`,children:`Полный input pipeline`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#local-time-%D0%B8-%D0%BA%D0%B0%D0%BB%D0%B5%D0%BD%D0%B4%D0%B0%D1%80%D0%BD%D0%B0%D1%8F-%D1%81%D0%B5%D0%BC%D0%B0%D0%BD%D1%82%D0%B8%D0%BA%D0%B0`,children:`Local time и календарная семантика`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#api-%D0%B8-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`API и ошибки`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы`,children:`Назначение и границы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`"dd.MM.yyyy HH:mm"
+          │ parseDateSegmentMask
+          ▼
+[day, ".", month, ".", year, " ", hours, ":", minutes]
+          │ пользователь вводит значения по индексам
+          ▼
+Map { 0:"03", 2:"03", 4:"2026", 6:"18", 8:"03" }
+          │ indexedSegmentsToDate
+          ▼
+new Date(2026, 2, 3, 18, 3)
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не рендерит input, не управляет focus/caret, не форматирует итоговую дату для UI/backend и не парсит ISO/OData строку. Для общего парсинга/форматирования используйте `,(0,c.jsx)(t.code,{children:`/formatters`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	areAllDateSegmentsEmpty,
+	dateToIndexedSegmentValues,
+	indexedSegmentsToDate,
+	isEditableDateSegment,
+	parseDateSegmentMask
+} from "@ryuzaki13/react-foundation-lib/date-segments";
+
+import type {
+	DateMaskSegment,
+	DateSegmentId,
+	EditableDateSegment,
+	LiteralDateSegment
+} from "@ryuzaki13/react-foundation-lib/date-segments";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль не зависит от React/DOM и использует локальные getters/constructor стандартного `,(0,c.jsx)(t.code,{children:`Date`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`базовые-понятия`,children:`Базовые понятия`}),`
+`,(0,c.jsx)(t.p,{children:`Маска состоит из двух видов сегментов.`}),`
+`,(0,c.jsx)(t.p,{children:`Editable segment:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface EditableDateSegment {
+	kind: "editable";
+	id: DateSegmentId;
+	token: string;
+	length: number;
+	min: number;
+	max: number;
+	placeholder: string;
+	ariaLabel: string;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Literal segment:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface LiteralDateSegment {
+	kind: "literal";
+	text: string;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Литералы — точки, двоеточия, пробелы, слова и неподдерживаемые символы маски. Они показываются пользователю, но не имеют редактируемого значения.`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`DateMaskSegment`}),` — discriminated union. Поле `,(0,c.jsx)(t.code,{children:`kind`}),` позволяет безопасно сузить тип.`]}),`
+`,(0,c.jsx)(t.h2,{id:`поддерживаемые-tokens`,children:`Поддерживаемые tokens`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Token`}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`id`})}),(0,c.jsx)(t.th,{style:{textAlign:`right`},children:`Длина`}),(0,c.jsx)(t.th,{children:`Диапазон`}),(0,c.jsx)(t.th,{children:`Placeholder`}),(0,c.jsx)(t.th,{children:`ARIA label`})]})}),(0,c.jsxs)(t.tbody,{children:[(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:(0,c.jsx)(t.code,{children:`year`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`4`}),(0,c.jsx)(t.td,{children:`1–9999`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ГГГГ`})}),(0,c.jsx)(t.td,{children:`Год`})]}),(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:(0,c.jsx)(t.code,{children:`year`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`4`}),(0,c.jsx)(t.td,{children:`1–9999`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`гггг`})}),(0,c.jsx)(t.td,{children:`Год`})]}),(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:(0,c.jsx)(t.code,{children:`year`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`0–99`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`гг`})}),(0,c.jsx)(t.td,{children:`Год`})]}),(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:(0,c.jsx)(t.code,{children:`month`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`1–12`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`мм`})}),(0,c.jsx)(t.td,{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:(0,c.jsx)(t.code,{children:`day`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`1–31`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ДД`})}),(0,c.jsx)(t.td,{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:(0,c.jsx)(t.code,{children:`day`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`1–31`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`дд`})}),(0,c.jsx)(t.td,{children:`День`})]}),(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:(0,c.jsx)(t.code,{children:`hours`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`0–23`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`чч`})}),(0,c.jsx)(t.td,{children:`Часы`})]}),(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:(0,c.jsx)(t.code,{children:`hours`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`0–23`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`чч`})}),(0,c.jsx)(t.td,{children:`Часы`})]}),(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:(0,c.jsx)(t.code,{children:`minutes`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`0–59`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`мм`})}),(0,c.jsx)(t.td,{children:`Минуты`})]}),(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:(0,c.jsx)(t.code,{children:`seconds`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:`0–59`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`сс`})}),(0,c.jsx)(t.td,{children:`Секунды`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Обратите внимание:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`MM`}),` — месяц, `,(0,c.jsx)(t.code,{children:`mm`}),` — минуты;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`dd`}),`/`,(0,c.jsx)(t.code,{children:`DD`}),` — день;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`hh`}),` и `,(0,c.jsx)(t.code,{children:`HH`}),` оба означают 24-часовой диапазон `,(0,c.jsx)(t.code,{children:`0..23`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`одиночные `,(0,c.jsx)(t.code,{children:`d`}),`, `,(0,c.jsx)(t.code,{children:`M`}),`, `,(0,c.jsx)(t.code,{children:`H`}),`, `,(0,c.jsx)(t.code,{children:`m`}),`, `,(0,c.jsx)(t.code,{children:`s`}),` не являются tokens и станут literal text;`]}),`
+`,(0,c.jsx)(t.li,{children:`tokens регистрозависимы.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`parsedatesegmentmask`,children:(0,c.jsx)(t.code,{children:`parseDateSegmentMask`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const segments = parseDateSegmentMask("dd.MM.yyyy HH:mm");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Результат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`[
+	{ kind: "editable", id: "day", token: "dd", length: 2 /* ... */ },
+	{ kind: "literal", text: "." },
+	{ kind: "editable", id: "month", token: "MM", length: 2 /* ... */ },
+	{ kind: "literal", text: "." },
+	{ kind: "editable", id: "year", token: "yyyy", length: 4 /* ... */ },
+	{ kind: "literal", text: " " },
+	{ kind: "editable", id: "hours", token: "HH", length: 2 /* ... */ },
+	{ kind: "literal", text: ":" },
+	{ kind: "editable", id: "minutes", token: "mm", length: 2 /* ... */ }
+];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Соседние literal characters объединяются в один segment:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`parseDateSegmentMask("Дата: dd");
+// literal "Дата: ", затем editable day.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пустая маска возвращает пустой массив. Parser не валидирует обязательность года/месяца/дня и допускает повтор одного `,(0,c.jsx)(t.code,{children:`id`}),`; корректный набор задаёт host.`]}),`
+`,(0,c.jsx)(t.h2,{id:`iseditabledatesegment`,children:(0,c.jsx)(t.code,{children:`isEditableDateSegment`})}),`
+`,(0,c.jsx)(t.p,{children:`Type guard:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const editable = segments.filter(isEditableDateSegment);
+// EditableDateSegment[].
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Он проверяет только `,(0,c.jsx)(t.code,{children:`segment.kind === "editable"`}),` и рассчитан на значения, полученные из parser или соответствующие публичному типу.`]}),`
+`,(0,c.jsx)(t.h2,{id:`datetoindexedsegmentvalues`,children:(0,c.jsx)(t.code,{children:`dateToIndexedSegmentValues`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция создаёт `,(0,c.jsx)(t.code,{children:`Map<number, string>`}),`, где key — индекс segment в полном массиве, включая literals.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const segments = parseDateSegmentMask("dd.MM.yyyy HH:mm");
+const values = dateToIndexedSegmentValues(new Date(2026, 2, 3, 18, 3), segments);
+
+console.log([...values.entries()]);
+// [[0,"03"], [2,"03"], [4,"2026"], [6,"18"], [8,"03"]]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Индексы `,(0,c.jsx)(t.code,{children:`1`}),`, `,(0,c.jsx)(t.code,{children:`3`}),`, `,(0,c.jsx)(t.code,{children:`5`}),`, `,(0,c.jsx)(t.code,{children:`7`}),` отсутствуют, потому что это literals.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`null`}),`, `,(0,c.jsx)(t.code,{children:`undefined`}),` или invalid `,(0,c.jsx)(t.code,{children:`Date`}),` каждая editable позиция получает `,(0,c.jsx)(t.code,{children:`""`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`dateToIndexedSegmentValues(null, segments);
+dateToIndexedSegmentValues(new Date("bad"), segments);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Двухзначный year берёт последние две цифры полного года. Значения дополняются нулями слева до длины segment.`}),`
+`,(0,c.jsx)(t.h2,{id:`arealldatesegmentsempty`,children:(0,c.jsx)(t.code,{children:`areAllDateSegmentsEmpty`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const empty = areAllDateSegmentsEmpty(segments, values);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, если у каждого editable segment значение отсутствует или является пустой строкой.`]}),`
+`,(0,c.jsx)(t.p,{children:`Literal segments игнорируются. Строка из пробелов truthy и считается заполненной. Функция не проверяет длину/числовой формат.`}),`
+`,(0,c.jsx)(t.h2,{id:`indexedsegmentstodate`,children:(0,c.jsx)(t.code,{children:`indexedSegmentsToDate`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const date = indexedSegmentsToDate(segments, values);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает строгий valid `,(0,c.jsx)(t.code,{children:`Date`}),` или `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`полный-ввод`,children:`Полный ввод`}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждый editable segment должен иметь строку длиной не меньше `,(0,c.jsx)(t.code,{children:`segment.length`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`values.set(dayIndex, "3"); // Для token dd длины недостаточно.
+indexedSegmentsToDate(segments, values); // null.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверка длины не гарантирует numeric input. `,(0,c.jsx)(t.code,{children:`"ab"`}),` пройдёт length-check, но `,(0,c.jsx)(t.code,{children:`parseInt`}),` не даст valid component и итог будет `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`календарная-строгость`,children:`Календарная строгость`}),`
+`,(0,c.jsxs)(t.p,{children:[`После сборки компоненты сверяются с полученным `,(0,c.jsx)(t.code,{children:`Date`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// 31 февраля не превращается автоматически в март.
+indexedSegmentsToDate(segments, february31Values); // null.
+
+// 24:00 не принимается.
+indexedSegmentsToDate(segments, hour24Values); // null.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверяются month `,(0,c.jsx)(t.code,{children:`1..12`}),`, day `,(0,c.jsx)(t.code,{children:`1..31`}),`, hours `,(0,c.jsx)(t.code,{children:`0..23`}),`, minutes/seconds `,(0,c.jsx)(t.code,{children:`0..59`}),`, а затем реальная календарная дата.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`отсутствующие-части-и-defaultdate`,children:[`Отсутствующие части и `,(0,c.jsx)(t.code,{children:`defaultDate`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если маска не содержит некоторый тип segment, компонент берётся из `,(0,c.jsx)(t.code,{children:`defaultDate`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const timeSegments = parseDateSegmentMask("HH:mm");
+const values = new Map([
+	[0, "09"],
+	[2, "15"]
+]);
+
+const result = indexedSegmentsToDate(timeSegments, values, {
+	defaultDate: new Date(2026, 2, 3, 18, 3)
+});
+// 3 марта 2026, 09:15 local time.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Default fallback без options — `,(0,c.jsx)(t.code,{children:`new Date(1970, 0, 1, 0, 0, 0, 0)`}),` в local timezone.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`defaultDate`}),` не валидируется отдельно. Invalid fallback обычно приведёт к `,(0,c.jsx)(t.code,{children:`null`}),` после итоговой проверки.`]}),`
+`,(0,c.jsx)(t.h3,{id:`двухзначный-год`,children:`Двухзначный год`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для token `,(0,c.jsx)(t.code,{children:`yy`}),`:`]}),`
+`,(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,{style:{textAlign:`right`},children:`Полный год`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`00`}),`–`,(0,c.jsx)(t.code,{children:`69`})]}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2000–2069`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`70`}),`–`,(0,c.jsx)(t.code,{children:`99`})]}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`1970–1999`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Порог фиксирован и не зависит от текущего года.`}),`
+`,(0,c.jsx)(t.h2,{id:`полный-input-pipeline`,children:`Полный input pipeline`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const segments = parseDateSegmentMask("dd.MM.yyyy");
+const [values, setValues] = useState(() => dateToIndexedSegmentValues(initialDate, segments));
+
+function updateSegment(index: number, value: string) {
+	setValues((current) => {
+		const next = new Map(current);
+		next.set(index, value);
+		return next;
+	});
+}
+
+function commit() {
+	if (areAllDateSegmentsEmpty(segments, values)) {
+		onChange(null);
+		return;
+	}
+
+	const nextDate = indexedSegmentsToDate(segments, values);
+	if (nextDate === null) {
+		showValidationError("Введите корректную дату");
+		return;
+	}
+
+	onChange(nextDate);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`UI самостоятельно отвечает за digits-only input, `,(0,c.jsx)(t.code,{children:`aria-label`}),`, focus movement, paste, validation message и controlled state.`]}),`
+`,(0,c.jsx)(t.h2,{id:`local-time-и-календарная-семантика`,children:`Local time и календарная семантика`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функции используют `,(0,c.jsx)(t.code,{children:`getFullYear`}),`, `,(0,c.jsx)(t.code,{children:`getMonth`}),`, `,(0,c.jsx)(t.code,{children:`getDate`}),`, `,(0,c.jsx)(t.code,{children:`getHours`}),` и `,(0,c.jsx)(t.code,{children:`new Date(year, ...)`}),`. Это local calendar/time, а не UTC.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не смешивайте segment input с автоматическим timezone conversion. Перед отправкой в OData/backend примените formatter, соответствующий контракту API.`}),`
+`,(0,c.jsx)(t.h2,{id:`api-и-ошибки`,children:`API и ошибки`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(0,c.jsx)(t.th,{children:`Результат`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`parseDateSegmentMask`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`DateMaskSegment[]`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isEditableDateSegment`})}),(0,c.jsx)(t.td,{children:`Type guard`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`dateToIndexedSegmentValues`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Map<number, string>`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`areAllDateSegmentsEmpty`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`indexedSegmentsToDate`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Date | null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`DateSegmentId`})}),(0,c.jsx)(t.td,{children:`year/month/day/hours/minutes/seconds`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`EditableDateSegment`})}),(0,c.jsx)(t.td,{children:`Metadata редактируемого segment`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`LiteralDateSegment`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{ kind: "literal"; text: string }`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`DateMaskSegment`})}),(0,c.jsx)(t.td,{children:`Union editable/literal`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Типичные ошибки:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Перепутать `,(0,c.jsx)(t.code,{children:`MM`}),` и `,(0,c.jsx)(t.code,{children:`mm`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Хранить values по порядковому номеру editable fields вместо полного segment index.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Передать однозначную строку `,(0,c.jsx)(t.code,{children:`"3"`}),` для token длины `,(0,c.jsx)(t.code,{children:`2`}),` и ожидать автодополнение при сборке.`]}),`
+`,(0,c.jsx)(t.li,{children:`Ожидать UTC.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Считать `,(0,c.jsx)(t.code,{children:`min/max`}),` metadata заменой UI input validation.`]}),`
+`,(0,c.jsx)(t.li,{children:`Использовать произвольную маску с повторяющимися year/month segments.`}),`
+`,(0,c.jsx)(t.li,{children:`Нормализовать пользовательский partial draft до команды commit.`}),`
+`]})]})}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};