@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.8

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

@@ -0,0 +1,273 @@
+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`,ol:`ol`,p:`p`,pre:`pre`,table:`table`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,...n(),...e.components};return(0,c.jsxs)(c.Fragment,{children:[(0,c.jsx)(i,{title:`Foundation Lib/API/Formatters/Strings`}),`
+`,(0,c.jsx)(t.h1,{id:`строковые-форматтеры`,children:`Строковые форматтеры`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль содержит небольшие предсказуемые функции для подготовки пользовательского текста: обрезки пробелов, безопасного преобразования в строку, удаления ведущих нулей, сокращения длинного текста и выбора русской формы слова.`}),`
+`,(0,c.jsx)(t.p,{children:`Все функции экспортируются через один публичный entrypoint:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	formatRussianPlural,
+	normalizeRequiredText,
+	normalizeText,
+	normalizeTextSpaces,
+	normalizeTextToLower,
+	normalizeTextWithFallback,
+	selectRussianPluralForm,
+	startsWithIgnoringZeros,
+	stripInnerSpaces,
+	stripLeadingZeros,
+	toSafeString,
+	truncateText
+} from "@ryuzaki13/react-foundation-lib/formatters";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Импорта `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters/strings`}),` нет: каталог `,(0,c.jsx)(t.code,{children:`strings`}),` — внутренняя организация исходников, а не отдельный package subpath.`]}),`
+`,(0,c.jsx)(t.h2,{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.jsx)(t.th,{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:`undefined`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeText`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"  Иван  "`}),` → `,(0,c.jsx)(t.code,{children:`"Иван"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить текст с fallback`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTextWithFallback`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`null`}),` → заданный fallback`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить обязательную строку`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeRequiredText`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`null`}),` → `,(0,c.jsx)(t.code,{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:`normalizeTextToLower`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"  Admin "`}),` → `,(0,c.jsx)(t.code,{children:`"admin"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Безопасно выполнить `,(0,c.jsx)(t.code,{children:`String(value)`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toSafeString`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`null`}),` → `,(0,c.jsx)(t.code,{children:`""`}),`, `,(0,c.jsx)(t.code,{children:`42`}),` → `,(0,c.jsx)(t.code,{children:`"42"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Схлопнуть разные пробелы`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTextSpaces`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"  Иван\\u00a0 Иванов "`}),` → `,(0,c.jsx)(t.code,{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:`stripInnerSpaces`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"1 234\\u00a0567"`}),` → `,(0,c.jsx)(t.code,{children:`"1234567"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Удалить ведущие нули у целого числа`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stripLeadingZeros`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`"-00042"`}),` → `,(0,c.jsx)(t.code,{children:`"-42"`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Сравнить начало без ведущих нулей`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`startsWithIgnoringZeros`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`("000123", "12")`}),` → `,(0,c.jsx)(t.code,{children:`true`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Обрезать длинный текст`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`truncateText`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`("abcdef", 3)`}),` → `,(0,c.jsx)(t.code,{children:`"abc..."`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Выбрать русскую форму слова`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`selectRussianPluralForm`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`22`}),` → форма `,(0,c.jsx)(t.code,{children:`few`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить число вместе со словом`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatRussianPlural`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`22`}),` → `,(0,c.jsx)(t.code,{children:`"22 файла"`})]})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`базовые-понятия-для-начинающих`,children:`Базовые понятия для начинающих`}),`
+`,(0,c.jsxs)(t.h3,{id:`unknown-не-означает-строку`,children:[(0,c.jsx)(t.code,{children:`unknown`}),` не означает строку`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Значение типа `,(0,c.jsx)(t.code,{children:`unknown`}),` может оказаться строкой, числом, объектом, `,(0,c.jsx)(t.code,{children:`null`}),` или чем угодно ещё. Функции этого модуля обрабатывают такие значения по-разному:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`normalizeText*`}),` считают текстом только настоящее значение типа `,(0,c.jsx)(t.code,{children:`string`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`toSafeString`}),` преобразует почти любое значение через встроенную функцию `,(0,c.jsx)(t.code,{children:`String`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`stripLeadingZeros`}),` предназначена для строки, которая изображает целое число.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не подменяйте одну операцию другой. Например, `,(0,c.jsx)(t.code,{children:`normalizeText(42)`}),` вернёт `,(0,c.jsx)(t.code,{children:`undefined`}),`, а `,(0,c.jsx)(t.code,{children:`toSafeString(42)`}),` — строку `,(0,c.jsx)(t.code,{children:`"42"`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`undefined-null-и-пустая-строка-различаются`,children:[(0,c.jsx)(t.code,{children:`undefined`}),`, `,(0,c.jsx)(t.code,{children:`null`}),` и пустая строка различаются`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`undefined`}),` обычно означает «значение не задано»;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` обычно означает «значение явно отсутствует»;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`""`}),` — строка, но в ней нет символов;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"   "`}),` — непустая строка на уровне JavaScript, однако после `,(0,c.jsx)(t.code,{children:`trim()`}),` она становится пустой.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeText`}),` объединяет эти случаи в удобный результат: содержательная строка либо `,(0,c.jsx)(t.code,{children:`undefined`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`нормализация-текста`,children:`Нормализация текста`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetextvalue`,children:(0,c.jsx)(t.code,{children:`normalizeText(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function normalizeText(value: unknown): string | undefined;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`проверяет, что значение является строкой;`}),`
+`,(0,c.jsxs)(t.li,{children:[`удаляет пробелы в начале и конце через `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если после этого строка пуста.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeText("  документ  "); // "документ"
+normalizeText(""); // undefined
+normalizeText("   "); // undefined
+normalizeText(null); // undefined
+normalizeText(100); // undefined
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Она не схлопывает пробелы внутри строки и не меняет регистр:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeText("  Иван   Иванов  "); // "Иван   Иванов"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Типичный сценарий — подготовка необязательного поля перед сохранением:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const description = normalizeText(form.description);
+
+// description имеет тип string | undefined
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetextwithfallbackvalue-fallback`,children:(0,c.jsx)(t.code,{children:`normalizeTextWithFallback(value, fallback?)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function normalizeTextWithFallback(value: unknown, fallback?: string): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает результат `,(0,c.jsx)(t.code,{children:`normalizeText(value)`}),`. Если содержательного текста нет, возвращает `,(0,c.jsx)(t.code,{children:`fallback`}),`. По умолчанию fallback равен пустой строке.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTextWithFallback("  Готово  "); // "Готово"
+normalizeTextWithFallback(null); // ""
+normalizeTextWithFallback("   ", "Не указано"); // "Не указано"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Важно: fallback возвращается буквально. Функция не обрезает и не проверяет сам fallback.`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizerequiredtextvalue`,children:(0,c.jsx)(t.code,{children:`normalizeRequiredText(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function normalizeRequiredText(value: unknown): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это короткая форма `,(0,c.jsx)(t.code,{children:`normalizeTextWithFallback(value, "")`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeRequiredText("  Отчёт  "); // "Отчёт"
+normalizeRequiredText(undefined); // ""
+normalizeRequiredText(42); // ""
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте её там, где вызывающему коду всегда нужна строка. Название `,(0,c.jsx)(t.code,{children:`Required`}),` не выполняет валидацию обязательности: пустой ввод всё равно превращается в `,(0,c.jsx)(t.code,{children:`""`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetexttolowervalue`,children:(0,c.jsx)(t.code,{children:`normalizeTextToLower(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function normalizeTextToLower(value: unknown): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обрезает внешние пробелы, затем вызывает `,(0,c.jsx)(t.code,{children:`toLowerCase()`}),`. Если вход не является содержательной строкой, возвращает `,(0,c.jsx)(t.code,{children:`""`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTextToLower("  AdMiN  "); // "admin"
+normalizeTextToLower(null); // ""
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция использует обычный `,(0,c.jsx)(t.code,{children:`toLowerCase`}),`, а не locale-aware `,(0,c.jsx)(t.code,{children:`toLocaleLowerCase`}),`. Для большинства технических ключей это ожидаемое поведение.`]}),`
+`,(0,c.jsx)(t.h3,{id:`tosafestringvalue`,children:(0,c.jsx)(t.code,{children:`toSafeString(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function toSafeString(value: unknown): string;
+`})}),`
+`,(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:`String`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`toSafeString(null); // ""
+toSafeString(undefined); // ""
+toSafeString(42); // "42"
+toSafeString(false); // "false"
+toSafeString([1, 2]); // "1,2"
+toSafeString({ id: 1 }); // "[object Object]"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Последние два примера показывают ограничение: функция гарантирует строковый тип, но не создаёт красивое представление сложных объектов. Для объектов нужен осмысленный formatter или сериализатор.`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizetextspacesvalue`,children:(0,c.jsx)(t.code,{children:`normalizeTextSpaces(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function normalizeTextSpaces(value: unknown): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция сначала применяет семантику `,(0,c.jsx)(t.code,{children:`normalizeRequiredText`}),`, затем заменяет любую последовательность следующих пробельных символов одним обычным пробелом:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`стандартные пробельные символы JavaScript (`,(0,c.jsx)(t.code,{children:`\\s`}),`), включая табуляцию и перенос строки;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`неразрывный пробел `,(0,c.jsx)(t.code,{children:`U+00A0`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`узкий неразрывный пробел `,(0,c.jsx)(t.code,{children:`U+202F`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`normalizeTextSpaces("  Иван\\t\\nИванов  "); // "Иван Иванов"
+normalizeTextSpaces("1\\u00a0234\\u202f567"); // "1 234 567"
+normalizeTextSpaces(123); // ""
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте функцию для обычного пользовательского текста. Для машинных идентификаторов схлопывание пробелов может менять смысл значения.`}),`
+`,(0,c.jsx)(t.h2,{id:`удаление-пробелов-и-ведущих-нулей`,children:`Удаление пробелов и ведущих нулей`}),`
+`,(0,c.jsx)(t.h3,{id:`stripinnerspacesvalue`,children:(0,c.jsx)(t.code,{children:`stripInnerSpaces(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function stripInnerSpaces(value: string): string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Удаляет из всей строки:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`обычный пробел;`}),`
+`,(0,c.jsxs)(t.li,{children:[`неразрывный пробел `,(0,c.jsx)(t.code,{children:`U+00A0`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`узкий неразрывный пробел `,(0,c.jsx)(t.code,{children:`U+202F`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stripInnerSpaces("1 234 567"); // "1234567"
+stripInnerSpaces("1\\u00a0234\\u202f567"); // "1234567"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Несмотря на слово `,(0,c.jsx)(t.code,{children:`Inner`}),` в имени, удаляются все перечисленные пробелы, в том числе в начале и конце. Табуляция и перевод строки не удаляются:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stripInnerSpaces("\\t1 2\\n"); // "\\t12\\n"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`stripleadingzerosvalue`,children:(0,c.jsx)(t.code,{children:`stripLeadingZeros(value)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function stripLeadingZeros(value: string): string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция предназначена для строкового представления целого числа:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsx)(t.li,{children:`обрезает внешние пробелы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`проверяет формат `,(0,c.jsx)(t.code,{children:`необязательный минус + цифры`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`удаляет лишние нули в начале цифровой части;`}),`
+`,(0,c.jsx)(t.li,{children:`оставляет один ноль, если число состояло только из нулей.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stripLeadingZeros("00042"); // "42"
+stripLeadingZeros("-00042"); // "-42"
+stripLeadingZeros("0000"); // "0"
+stripLeadingZeros("-0000"); // "-0"
+stripLeadingZeros("   "); // "0"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если строка не похожа на целое число, она возвращается только с обрезанными внешними пробелами:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stripLeadingZeros("+00042"); // "+00042"
+stripLeadingZeros("001.50"); // "001.50"
+stripLeadingZeros("000A12"); // "000A12"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте эту функцию для дробей, артикулов или кодов, где ведущие нули значимы.`}),`
+`,(0,c.jsx)(t.h3,{id:`startswithignoringzerosvalue-searchtext`,children:(0,c.jsx)(t.code,{children:`startsWithIgnoringZeros(value, searchText)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function startsWithIgnoringZeros(value: string, searchText: string): boolean;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обе строки приводятся к нижнему регистру, из их начала удаляются все нули, затем выполняется обычный `,(0,c.jsx)(t.code,{children:`startsWith`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`startsWithIgnoringZeros("000ABC123", "abc"); // true
+startsWithIgnoringZeros("00012345", "0012"); // true
+startsWithIgnoringZeros("00123", "24"); // false
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция не вызывает `,(0,c.jsx)(t.code,{children:`trim()`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`startsWithIgnoringZeros(" 00123", "123"); // false
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если искомая строка состоит только из нулей, после удаления нулей получается `,(0,c.jsx)(t.code,{children:`""`}),`. Любая строка начинается с пустой строки, поэтому результат будет `,(0,c.jsx)(t.code,{children:`true`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`startsWithIgnoringZeros("ABC", "000"); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если такое поведение не подходит поисковому интерфейсу, заранее проверяйте нормализованный поисковый запрос.`}),`
+`,(0,c.jsx)(t.h2,{id:`обрезка-длинного-текста`,children:`Обрезка длинного текста`}),`
+`,(0,c.jsx)(t.h3,{id:`truncatetextvalue-maxlength`,children:(0,c.jsx)(t.code,{children:`truncateText(value, maxLength)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function truncateText(value: unknown, maxLength: number): string | undefined;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сначала применяется `,(0,c.jsx)(t.code,{children:`normalizeText`}),`. Если строка длиннее `,(0,c.jsx)(t.code,{children:`maxLength`}),`, берутся первые `,(0,c.jsx)(t.code,{children:`maxLength`}),` кодовых единиц и добавляется `,(0,c.jsx)(t.code,{children:`...`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`truncateText("  abcdef  ", 3); // "abc..."
+truncateText("abc", 3); // "abc"
+truncateText("   ", 10); // undefined
+truncateText(123, 10); // undefined
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`maxLength`}),` ограничивает только исходную часть. Три точки добавляются сверху, поэтому длина результата может быть `,(0,c.jsx)(t.code,{children:`maxLength + 3`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте целое неотрицательное число. Функция не валидирует параметр. Кроме того, JavaScript `,(0,c.jsx)(t.code,{children:`slice`}),` считает UTF-16 code units, поэтому граница может разрезать emoji или сложный Unicode-символ. Для строгого UI-ограничения по визуальным символам нужен отдельный Unicode-aware механизм.`]}),`
+`,(0,c.jsx)(t.h2,{id:`русские-формы-множественного-числа`,children:`Русские формы множественного числа`}),`
+`,(0,c.jsxs)(t.h3,{id:`модель-one-few-many-other`,children:[`Модель `,(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.p,{children:`Русский язык использует разные формы слова:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`one`}),`: `,(0,c.jsx)(t.code,{children:`1 файл`}),`, `,(0,c.jsx)(t.code,{children:`21 файл`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`few`}),`: `,(0,c.jsx)(t.code,{children:`2 файла`}),`, `,(0,c.jsx)(t.code,{children:`24 файла`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`many`}),`: `,(0,c.jsx)(t.code,{children:`5 файлов`}),`, `,(0,c.jsx)(t.code,{children:`11 файлов`}),`, `,(0,c.jsx)(t.code,{children:`100 файлов`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`other`}),`: обычно дробные значения, например `,(0,c.jsx)(t.code,{children:`1.5 файла`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль использует `,(0,c.jsx)(t.code,{children:`Intl.PluralRules("ru-RU")`}),`, поэтому не нужно самостоятельно писать правила с остатками от деления.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type RussianPluralForms = {
+	one: string;
+	few: string;
+	many: string;
+	other?: string;
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Поле `,(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.h3,{id:`selectrussianpluralformvalue-forms`,children:(0,c.jsx)(t.code,{children:`selectRussianPluralForm(value, forms)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function selectRussianPluralForm(value: number, forms: RussianPluralForms): string;
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const fileForms = {
+	one: "файл",
+	few: "файла",
+	many: "файлов",
+	other: "файла"
+};
+
+selectRussianPluralForm(1, fileForms); // "файл"
+selectRussianPluralForm(2, fileForms); // "файла"
+selectRussianPluralForm(5, fileForms); // "файлов"
+selectRussianPluralForm(1.5, fileForms); // "файла"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для `,(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`}),` и `,(0,c.jsx)(t.code,{children:`-Infinity`}),` функция выбрасывает `,(0,c.jsx)(t.code,{children:`RangeError`}),`, потому что выбрать грамматическую форму для нечислового количества нельзя.`]}),`
+`,(0,c.jsx)(t.h3,{id:`formatrussianpluralvalue-forms`,children:(0,c.jsx)(t.code,{children:`formatRussianPlural(value, forms)`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function formatRussianPlural(value: number, forms: RussianPluralForms): string;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Добавляет число перед выбранной формой через пробел:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatRussianPlural(1, fileForms); // "1 файл"
+formatRussianPlural(22, fileForms); // "22 файла"
+formatRussianPlural(100, fileForms); // "100 файлов"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Само число вставляется через обычное строковое преобразование JavaScript. Локализованное форматирование числа не выполняется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`formatRussianPlural(1.5, fileForms); // "1.5 файла", не "1,5 файла"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужно локализовать число, объедините `,(0,c.jsx)(t.code,{children:`selectRussianPluralForm`}),` с числовым форматтером:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { formatNumber, selectRussianPluralForm } from "@ryuzaki13/react-foundation-lib/formatters";
+
+const count = 1234.5;
+const label = \`\${formatNumber(count, "decimal")} \${selectRussianPluralForm(count, fileForms)}\`;
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`практический-пример-нормализация-формы`,children:`Практический пример: нормализация формы`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { normalizeText, normalizeTextSpaces, normalizeTextToLower, stripLeadingZeros } from "@ryuzaki13/react-foundation-lib/formatters";
+
+const draft = {
+	name: "  Иван   Иванов  ",
+	login: "  IVANOV  ",
+	comment: "   ",
+	sequence: "00042"
+};
+
+const snapshot = {
+	name: normalizeTextSpaces(draft.name), // "Иван Иванов"
+	login: normalizeTextToLower(draft.login), // "ivanov"
+	comment: normalizeText(draft.comment), // undefined
+	sequence: stripLeadingZeros(draft.sequence) // "42"
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Такая нормализация подходит для явно выбранной границы сохранения. Не применяйте её автоматически на каждом нажатии клавиши: пользовательский draft обычно должен сохранять введённый текст буквально до сохранения.`}),`
+`,(0,c.jsx)(t.h2,{id:`частые-ошибки`,children:`Частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`использовать-tosafestring-как-универсальный-formatter`,children:[`Использовать `,(0,c.jsx)(t.code,{children:`toSafeString`}),` как универсальный formatter`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`toSafeString({ id: 1 })`}),` возвращает `,(0,c.jsx)(t.code,{children:`"[object Object]"`}),`. Функция защищает от `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),`, но не знает, как должен выглядеть доменный объект.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидать-что-stripinnerspaces-удалит-все-whitespace`,children:[`Ожидать, что `,(0,c.jsx)(t.code,{children:`stripInnerSpaces`}),` удалит все whitespace`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Она удаляет только три конкретных вида пробела. Для схлопывания табуляций и переносов строки используйте `,(0,c.jsx)(t.code,{children:`normalizeTextSpaces`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`удалять-нули-у-идентификаторов`,children:`Удалять нули у идентификаторов`}),`
+`,(0,c.jsxs)(t.p,{children:[`Коды `,(0,c.jsx)(t.code,{children:`"000123"`}),` и `,(0,c.jsx)(t.code,{children:`"123"`}),` могут быть разными бизнес-идентификаторами. `,(0,c.jsx)(t.code,{children:`stripLeadingZeros`}),` меняет значение и должна применяться только там, где строка действительно означает целое число.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`считать-что-truncatetext-возвращает-строку-заданной-длины`,children:[`Считать, что `,(0,c.jsx)(t.code,{children:`truncateText`}),` возвращает строку заданной длины`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Три точки не входят в `,(0,c.jsx)(t.code,{children:`maxLength`}),`. При `,(0,c.jsx)(t.code,{children:`maxLength = 10`}),` итоговая строка может содержать 13 кодовых единиц.`]}),`
+`,(0,c.jsx)(t.h3,{id:`передавать-строку-в-plural-api`,children:`Передавать строку в plural API`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно: функция ожидает number.
+// formatRussianPlural("5", fileForms);
+
+formatRussianPlural(Number("5"), fileForms);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Перед преобразованием внешней строки убедитесь, что получилось конечное число.`}),`
+`,(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:`API`}),(0,c.jsx)(t.th,{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:`normalizeText`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string | undefined`})}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTextWithFallback`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`unknown`}),`, `,(0,c.jsx)(t.code,{children:`string?`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeRequiredText`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTextToLower`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toSafeString`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsxs)(t.td,{children:[`теоретически `,(0,c.jsx)(t.code,{children:`String(value)`}),` для экзотического объекта`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeTextSpaces`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stripInnerSpaces`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`нет для корректного типа`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stripLeadingZeros`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`нет для корректного типа`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`startsWithIgnoringZeros`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`string`}),`, `,(0,c.jsx)(t.code,{children:`string`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:`нет для корректных типов`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`truncateText`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`unknown`}),`, `,(0,c.jsx)(t.code,{children:`number`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string | undefined`})}),(0,c.jsx)(t.td,{children:`нет при обычных значениях`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`selectRussianPluralForm`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`number`}),`, формы`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`RangeError`}),` для не-конечного числа`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`formatRussianPlural`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`number`}),`, формы`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`RangeError`}),` для не-конечного числа`]})]})]})]}),`
+`,(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:`../number/README.mdx`,children:`Числа и числовые строки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`../boolean/README.mdx`,children:`Форматтеры boolean и ABAP-флагов`})}),`
+`]})]})}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};