@ryuzaki13/react-foundation-ui 1.8.6 → 1.8.7

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

@@ -0,0 +1,648 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-CViB2sFm.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B8F5vBhs.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/Crypto`}),`
+`,(0,c.jsxs)(t.h1,{id:`идентификаторы-и-строковые-hash-через-ryuzaki13react-foundation-libcrypto`,children:[`Идентификаторы и строковые hash через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/crypto`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`crypto`}),` предоставляет небольшие функции для двух разных задач:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`получить детерминированный компактный hash из строки;`}),`
+`,(0,c.jsx)(t.li,{children:`создать случайный UUID версии 4.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Детерминированный результат всегда повторяется для той же строки. Случайный UUID, наоборот, создаётся заново при каждом вызове. Это принципиально разные виды идентификаторов, и выбирать между ними нужно по смыслу задачи.`}),`
+`,(0,c.jsx)(t.p,{children:`Несмотря на имя entrypoint, строковые hash этого модуля не являются криптографическими. Они не подходят для паролей, подписей, access token, проверки безопасности или сокрытия персональных данных.`}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика, который использует опубликованный пакет без доступа к исходному коду. Здесь объясняются базовые понятия, точные форматы результатов, browser runtime, Unicode, коллизии, React/SSR, тестирование и безопасные границы применения.`}),`
+`,(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-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F`,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%BC%D0%B8%D0%BD%D0%B8%D0%BC%D0%B0%D0%BB%D1%8C%D0%BD%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%BA%D0%B0%D0%BA-%D0%B2%D1%8B%D0%B1%D1%80%D0%B0%D1%82%D1%8C-api`,children:`Как выбрать API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D1%8B%D1%81%D1%82%D1%80%D1%8B%D0%B9-%D1%81%D1%82%D0%B0%D1%80%D1%82`,children:`Быстрый старт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%B1%D1%89%D0%B8%D0%B5-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0-%D1%81%D1%82%D1%80%D0%BE%D0%BA%D0%BE%D0%B2%D1%8B%D1%85-hash`,children:`Общие правила строковых hash`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#hashstring`,children:(0,c.jsx)(t.code,{children:`hashString`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#hashstring128`,children:(0,c.jsx)(t.code,{children:`hashString128`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#hashstring128base64url`,children:(0,c.jsx)(t.code,{children:`hashString128Base64Url`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#stringtoelementid`,children:(0,c.jsx)(t.code,{children:`stringToElementId`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#uuidv4`,children:(0,c.jsx)(t.code,{children:`uuidv4`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%B4%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D0%BA%D0%B0-%D1%81%D0%BB%D0%BE%D0%B6%D0%BD%D1%8B%D1%85-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85`,children:`Подготовка сложных данных`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C`,children:`Безопасность`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%BE%D0%BB%D0%BB%D0%B8%D0%B7%D0%B8%D0%B8-%D0%B8-%D0%BE%D0%B1%D1%80%D0%B5%D0%B7%D0%B0%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82%D0%B0`,children:`Коллизии и обрезание результата`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#browser-nodejs-%D0%B8-ssr`,children:`Browser, Node.js и SSR`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#react-%D1%80%D0%B5%D1%86%D0%B5%D0%BF%D1%82%D1%8B`,children:`React-рецепты`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5`,children:`Тестирование`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%BE%D0%B8%D0%B7%D0%B2%D0%BE%D0%B4%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D1%8C`,children:`Производительность`})}),`
+`,(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-%D1%87%D0%B0%D1%81%D1%82%D1%8B%D0%B5-%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:`#%D0%BA%D1%80%D0%B0%D1%82%D0%BA%D0%B8%D0%B9-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA-api`,children:`Краткий справочник API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D1%8B-%D0%B8-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D1%8B`,children:`Вопросы и ответы`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`назначение-и-границы-модуля`,children:`Назначение и границы модуля`}),`
+`,(0,c.jsxs)(t.h3,{id:`что-делает-crypto`,children:[`Что делает `,(0,c.jsx)(t.code,{children:`crypto`})]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`строит короткий 32-bit hash в base36;`}),`
+`,(0,c.jsx)(t.li,{children:`строит более длинный строковый hash в 32-символьном hexadecimal формате;`}),`
+`,(0,c.jsx)(t.li,{children:`кодирует тот же длинный hash в компактный URL-safe base64 без padding;`}),`
+`,(0,c.jsx)(t.li,{children:`добавляет префикс к длинному hash для получения DOM-like ID;`}),`
+`,(0,c.jsx)(t.li,{children:`создаёт UUID v4 через Web Crypto;`}),`
+`,(0,c.jsxs)(t.li,{children:[`использует native `,(0,c.jsx)(t.code,{children:`crypto.randomUUID`}),`, если он доступен;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`имеет fallback UUID через `,(0,c.jsx)(t.code,{children:`crypto.getRandomValues`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`чего-модуль-не-делает`,children:`Чего модуль не делает`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не шифрует и не расшифровывает данные;`}),`
+`,(0,c.jsx)(t.li,{children:`не вычисляет SHA-256, SHA-512, HMAC или цифровую подпись;`}),`
+`,(0,c.jsx)(t.li,{children:`не хеширует пароли безопасным password hashing алгоритмом;`}),`
+`,(0,c.jsx)(t.li,{children:`не гарантирует отсутствие коллизий;`}),`
+`,(0,c.jsx)(t.li,{children:`не проверяет уникальность результата по базе данных;`}),`
+`,(0,c.jsx)(t.li,{children:`не нормализует регистр, пробелы, Unicode или JSON;`}),`
+`,(0,c.jsx)(t.li,{children:`не сериализует объект автоматически;`}),`
+`,(0,c.jsx)(t.li,{children:`не хранит созданные UUID;`}),`
+`,(0,c.jsxs)(t.li,{children:[`не создаёт React hydration-safe ID вместо `,(0,c.jsx)(t.code,{children:`useId`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`не превращает UUID в право доступа или security token.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`две-группы-api`,children:`Две группы API`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Группа`}),(0,c.jsx)(t.th,{children:`Функции`}),(0,c.jsx)(t.th,{children:`Свойство`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Детерминированные hash`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`hashString`}),`, `,(0,c.jsx)(t.code,{children:`hashString128`}),`, `,(0,c.jsx)(t.code,{children:`hashString128Base64Url`}),`, `,(0,c.jsx)(t.code,{children:`stringToElementId`})]}),(0,c.jsx)(t.td,{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:`uuidv4`})}),(0,c.jsx)(t.td,{children:`Каждый вызов должен создавать новое случайное значение.`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.jsx)(t.p,{children:`Установите пакет:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install @ryuzaki13/react-foundation-lib
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Импортируйте функции только из опубликованного subpath `,(0,c.jsx)(t.code,{children:`/crypto`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { hashString, hashString128, hashString128Base64Url, stringToElementId, uuidv4 } from "@ryuzaki13/react-foundation-lib/crypto";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Корневой импорт пакета не поддерживается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+import { uuidv4 } from "@ryuzaki13/react-foundation-lib";
+
+// Правильно.
+import { uuidv4 } from "@ryuzaki13/react-foundation-lib/crypto";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Entrypoint `,(0,c.jsx)(t.code,{children:`/crypto`}),` не импортирует React и не содержит hooks.`]}),`
+`,(0,c.jsx)(t.p,{children:`Модуль поставляется как ESM. Часть API использует browser globals:`}),`
+`,(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:`Требуемые возможности runtime`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString`})}),(0,c.jsxs)(t.td,{children:[`Обычные `,(0,c.jsx)(t.code,{children:`String`}),`, `,(0,c.jsx)(t.code,{children:`Number`}),` и bitwise operations`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString128`})}),(0,c.jsxs)(t.td,{children:[`Дополнительно `,(0,c.jsx)(t.code,{children:`Math.imul`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString128Base64Url`})}),(0,c.jsxs)(t.td,{children:[`Дополнительно глобальный `,(0,c.jsx)(t.code,{children:`btoa`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stringToElementId`})}),(0,c.jsxs)(t.td,{children:[`Глобальный `,(0,c.jsx)(t.code,{children:`btoa`}),`, потому что вызывает предыдущую функцию`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`uuidv4`})}),(0,c.jsxs)(t.td,{children:[`Глобальный Web Crypto `,(0,c.jsx)(t.code,{children:`crypto`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Наличие одноимённых API в конкретной версии Node.js не является частью browser-oriented контракта пакета. Проверяйте среду, если вызываете эти функции вне браузера.`}),`
+`,(0,c.jsx)(t.h2,{id:`минимальные-понятия`,children:`Минимальные понятия`}),`
+`,(0,c.jsx)(t.h3,{id:`идентификатор`,children:`Идентификатор`}),`
+`,(0,c.jsx)(t.p,{children:`Идентификатор — строка, по которой приложение отличает одну сущность от другой:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const userId = "user-42";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Хороший идентификатор должен соответствовать задаче. Иногда он должен повторяться для одинакового входа, а иногда должен быть новым для каждой созданной сущности.`}),`
+`,(0,c.jsx)(t.h3,{id:`детерминированность`,children:`Детерминированность`}),`
+`,(0,c.jsx)(t.p,{children:`Детерминированная функция всегда возвращает одинаковый результат для одинакового входа:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString128("user:42") === hashString128("user:42"); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это удобно для:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`cache-like ключей;`}),`
+`,(0,c.jsx)(t.li,{children:`стабильных DOM ID по известному business key;`}),`
+`,(0,c.jsx)(t.li,{children:`fingerprint нормализованной конфигурации;`}),`
+`,(0,c.jsx)(t.li,{children:`группировки или быстрого предварительного сравнения.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`случайность`,children:`Случайность`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`uuidv4()`}),` использует криптографически стойкий генератор случайных байтов среды:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = uuidv4();
+const second = uuidv4();
+
+console.log(first === second); // Практически ожидается false.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Случайный UUID удобен, когда новая сущность должна получить новый ID независимо от её содержимого.`}),`
+`,(0,c.jsx)(t.h3,{id:`hash`,children:`Hash`}),`
+`,(0,c.jsx)(t.p,{children:`Hash-функция превращает вход произвольной длины в результат ограниченной длины:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`"user:42" → "fa3326027b653e8049d56072c88378f0"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Поскольку возможных входных строк бесконечно много, а возможных результатов конечное количество, две разные строки теоретически могут получить одинаковый hash. Это называется коллизией.`}),`
+`,(0,c.jsx)(t.h3,{id:`hash-не-является-шифрованием`,children:`Hash не является шифрованием`}),`
+`,(0,c.jsx)(t.p,{children:`Шифрование предполагает возможность расшифровать данные при наличии ключа. Эти hash-функции не имеют операции обратного восстановления.`}),`
+`,(0,c.jsx)(t.p,{children:`Но отсутствие обратной функции не делает их безопасным способом скрыть данные. Короткий или предсказуемый вход можно подобрать перебором:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString128("user@example.com"); // Это не безопасная анонимизация email.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`base36`,children:`Base36`}),`
+`,(0,c.jsxs)(t.p,{children:[`Base36 использует цифры `,(0,c.jsx)(t.code,{children:`0-9`}),` и латинские буквы `,(0,c.jsx)(t.code,{children:`a-z`}),`. Например, десятичное число можно записать короче за счёт 36 возможных символов.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`hashString`}),` возвращает именно такой формат:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`d5nw5e
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`hexadecimal`,children:`Hexadecimal`}),`
+`,(0,c.jsx)(t.p,{children:`Hexadecimal, или base16, использует:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`0123456789abcdef
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`hashString128`}),` всегда возвращает 32 lowercase hex-символа.`]}),`
+`,(0,c.jsx)(t.h3,{id:`base64-url-safe`,children:`Base64 URL-safe`}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычный base64 может содержать `,(0,c.jsx)(t.code,{children:`+`}),`, `,(0,c.jsx)(t.code,{children:`/`}),` и padding `,(0,c.jsx)(t.code,{children:`=`}),`. URL-safe вариант заменяет проблемные символы:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`+`}),` → `,(0,c.jsx)(t.code,{children:`-`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`/`}),` → `,(0,c.jsx)(t.code,{children:`_`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`завершающие `,(0,c.jsx)(t.code,{children:`=`}),` удаляются.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`hashString128Base64Url`}),` возвращает 22 символа из набора:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`A-Z a-z 0-9 - _
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`uuid-v4`,children:`UUID v4`}),`
+`,(0,c.jsx)(t.p,{children:`UUID v4 — случайный идентификатор стандартного формата:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+`})}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`общая длина — 36 символов;`}),`
+`,(0,c.jsx)(t.li,{children:`дефисы находятся в фиксированных позициях;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`4`}),` обозначает версию 4;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`первый символ группы `,(0,c.jsx)(t.code,{children:`y`}),` соответствует UUID variant.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Пример:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`550e8400-e29b-41d4-a716-446655440000
+`})}),`
+`,(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:`Нужен очень короткий non-security hash`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен стабильный длинный hash для сравнения/config fingerprint`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString128`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен компактный URL-safe вариант длинного hash`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString128Base64Url`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен стабильный DOM-like ID по строке`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stringToElementId`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен новый случайный ID для создаваемой сущности`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`uuidv4`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужна связь label/input внутри React-компонента с SSR`}),(0,c.jsxs)(t.td,{children:[`React `,(0,c.jsx)(t.code,{children:`useId`}),`, не этот модуль`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен password hash`}),(0,c.jsx)(t.td,{children:`Специализированный password hasher`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужна криптографическая целостность или подпись`}),(0,c.jsx)(t.td,{children:`Web Crypto/серверная crypto-система`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нужен уникальный business ID с централизованной проверкой`}),(0,c.jsx)(t.td,{children:`Backend/database contract`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.h3,{id:`стабильный-hash`,children:`Стабильный hash`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { hashString128 } from "@ryuzaki13/react-foundation-lib/crypto";
+
+const fingerprint = hashString128("customer:42");
+
+console.log(fingerprint); // Одна и та же строка всегда даст тот же результат.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`стабильный-id-dom-элемента`,children:`Стабильный ID DOM-элемента`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { stringToElementId } from "@ryuzaki13/react-foundation-lib/crypto";
+
+const rowId = stringToElementId("customer:42");
+const cellId = stringToElementId("customer:42:name", "cell");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Примерный формат:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`row-<22 URL-safe символа>
+cell-<22 URL-safe символа>
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`новый-uuid`,children:`Новый UUID`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { uuidv4 } from "@ryuzaki13/react-foundation-lib/crypto";
+
+const draft = {
+	id: uuidv4(),
+	title: "Новая запись"
+};
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`общие-правила-строковых-hash`,children:`Общие правила строковых hash`}),`
+`,(0,c.jsx)(t.h3,{id:`вход-всегда-строка`,children:`Вход всегда строка`}),`
+`,(0,c.jsxs)(t.p,{children:[`Все hash-функции принимают `,(0,c.jsx)(t.code,{children:`string`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString128("42"); // Корректно.
+hashString128(42); // Ошибка TypeScript.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Число `,(0,c.jsx)(t.code,{children:`42`}),` и строка `,(0,c.jsx)(t.code,{children:`"42"`}),` — разные типы. Если вы осознанно преобразуете значение, делайте это явно:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString128(String(42));
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`обрабатывается-точная-последовательность-utf-16-code-units`,children:`Обрабатывается точная последовательность UTF-16 code units`}),`
+`,(0,c.jsxs)(t.p,{children:[`JavaScript хранит строки как последовательности UTF-16 code units. Реализация проходит строку через `,(0,c.jsx)(t.code,{children:`charCodeAt`}),`.`]}),`
+`,(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:`порядок символов;`}),`
+`,(0,c.jsx)(t.li,{children:`composed/decomposed форма Unicode;`}),`
+`,(0,c.jsx)(t.li,{children:`каждый code unit surrogate pair.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString128("User") !== hashString128("user");
+hashString128("A") !== hashString128(" A ");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`unicode-не-нормализуется`,children:`Unicode не нормализуется`}),`
+`,(0,c.jsx)(t.p,{children:`Визуально одинаковые строки могут иметь разное внутреннее представление:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const composed = "Café";
+const decomposed = "Cafe\\u0301";
+
+console.log(composed === decomposed); // false
+console.log(hashString128(composed) === hashString128(decomposed)); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если доменная модель считает их одинаковыми, нормализуйте строку на явно выбранной boundary:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const canonical = input.normalize("NFC");
+const hash = hashString128(canonical);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если буквальная форма важна, не нормализуйте её.`}),`
+`,(0,c.jsx)(t.h3,{id:`пустая-строка-допустима`,children:`Пустая строка допустима`}),`
+`,(0,c.jsx)(t.p,{children:`Функции не отклоняют пустой вход:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString("");
+hashString128("");
+hashString128Base64Url("");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пустая строка имеет свой стабильный hash. Проверять обязательность входа должен вызывающий код.`}),`
+`,(0,c.jsx)(t.h3,{id:`разные-hash-не-означают-разную-силу-защиты`,children:`Разные hash не означают разную силу защиты`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`hashString128`}),` и `,(0,c.jsx)(t.code,{children:`hashString128Base64Url`}),` кодируют один и тот же внутренний результат разными способами. Base64Url-версия короче, но не безопаснее и не слабее hex-версии с точки зрения коллизий.`]}),`
+`,(0,c.jsx)(t.h2,{id:`hashstring`,children:(0,c.jsx)(t.code,{children:`hashString`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает компактный FNV-1a-like 32-bit hash в base36.`}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare function hashString(input: string): string;
+`})}),`
+`,(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:`0-9`}),` и `,(0,c.jsx)(t.code,{children:`a-z`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`lowercase;`}),`
+`,(0,c.jsx)(t.li,{children:`переменная длина от 1 до 7 символов;`}),`
+`,(0,c.jsx)(t.li,{children:`результат соответствует unsigned 32-bit значению, записанному в base36.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`примеры-текущей-реализации`,children:`Примеры текущей реализации`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString(""); // "ztntfp"
+hashString("user:42"); // "d5nw5e"
+hashString("строка"); // "hb03a2"
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`компактный ключ небольшой UI-коллекции;`}),`
+`,(0,c.jsx)(t.li,{children:`некритичный short fingerprint;`}),`
+`,(0,c.jsx)(t.li,{children:`bucket/group key, где коллизия дополнительно обрабатывается;`}),`
+`,(0,c.jsx)(t.li,{children:`диагностическая метка, не являющаяся источником истины.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`когда-не-использовать`,children:`Когда не использовать`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`primary key;`}),`
+`,(0,c.jsx)(t.li,{children:`проверка уникальности большого набора;`}),`
+`,(0,c.jsx)(t.li,{children:`security decision;`}),`
+`,(0,c.jsx)(t.li,{children:`контроль целостности данных;`}),`
+`,(0,c.jsx)(t.li,{children:`password/token/signature;`}),`
+`,(0,c.jsx)(t.li,{children:`ситуация, где коллизия приводит к потере или перезаписи данных.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`32-bit пространство сравнительно мало. Не делайте вывод, что разные входы обязательно имеют разные результаты.`}),`
+`,(0,c.jsx)(t.h2,{id:`hashstring128`,children:(0,c.jsx)(t.code,{children:`hashString128`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает длинный non-cryptographic hash в hexadecimal формате.`}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-1`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare function hashString128(input: string): string;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`формат-результата-1`,children:`Формат результата`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`ровно 32 символа;`}),`
+`,(0,c.jsxs)(t.li,{children:[`только `,(0,c.jsx)(t.code,{children:`0-9`}),` и `,(0,c.jsx)(t.code,{children:`a-f`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`lowercase;`}),`
+`,(0,c.jsx)(t.li,{children:`четыре внутренних unsigned 32-bit слова записываются по 8 hex-символов.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = hashString128("user:42");
+
+console.log(result); // "fa3326027b653e8049d56072c88378f0"
+console.log(result.length); // 32
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`когда-использовать-1`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`fingerprint канонической строки конфигурации;`}),`
+`,(0,c.jsx)(t.li,{children:`стабильный cache-like key;`}),`
+`,(0,c.jsx)(t.li,{children:`сравнение версий данных с допустимым non-adversarial collision risk;`}),`
+`,(0,c.jsx)(t.li,{children:`стабильная техническая метка, для которой 32-bit hash слишком короток.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`важное-ограничение`,children:`Важное ограничение`}),`
+`,(0,c.jsxs)(t.p,{children:[`Название `,(0,c.jsx)(t.code,{children:`128`}),` описывает формат из 128 output bits, а не криптографическую стойкость. Внутри используется собственное быстрое смешивание четырёх 32-bit состояний. Не приравнивайте функцию к MD5, SHA-256 или другому cryptographic digest.`]}),`
+`,(0,c.jsx)(t.h2,{id:`hashstring128base64url`,children:(0,c.jsx)(t.code,{children:`hashString128Base64Url`})}),`
+`,(0,c.jsx)(t.p,{children:`Возвращает тот же длинный внутренний hash в более компактной URL-safe форме.`}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-2`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare function hashString128Base64Url(input: string): string;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`формат-результата-2`,children:`Формат результата`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`ровно 22 символа;`}),`
+`,(0,c.jsxs)(t.li,{children:[`символы `,(0,c.jsx)(t.code,{children:`A-Z`}),`, `,(0,c.jsx)(t.code,{children:`a-z`}),`, `,(0,c.jsx)(t.code,{children:`0-9`}),`, `,(0,c.jsx)(t.code,{children:`-`}),`, `,(0,c.jsx)(t.code,{children:`_`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`без `,(0,c.jsx)(t.code,{children:`+`}),`, `,(0,c.jsx)(t.code,{children:`/`}),` и padding `,(0,c.jsx)(t.code,{children:`=`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`регистр имеет значение.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = hashString128Base64Url("user:42");
+
+console.log(result); // "-jMmAntlPoBJ1WByyIN48A"
+console.log(result.length); // 22
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Результат может начинаться с `,(0,c.jsx)(t.code,{children:`-`}),` или `,(0,c.jsx)(t.code,{children:`_`}),`. Это допустимая часть Base64Url-алфавита.`]}),`
+`,(0,c.jsx)(t.h3,{id:`когда-использовать-2`,children:`Когда использовать`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`segment технического URL;`}),`
+`,(0,c.jsx)(t.li,{children:`компактный ключ для browser storage;`}),`
+`,(0,c.jsx)(t.li,{children:`DOM-like ID вместе с безопасным префиксом;`}),`
+`,(0,c.jsx)(t.li,{children:`data attribute;`}),`
+`,(0,c.jsxs)(t.li,{children:[`короткое представление того же результата, который можно было записать через `,(0,c.jsx)(t.code,{children:`hashString128`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`runtime`,children:`Runtime`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция преобразует 16 байтов через глобальный `,(0,c.jsx)(t.code,{children:`btoa`}),`. В среде без `,(0,c.jsx)(t.code,{children:`btoa`}),` будет выброшена ошибка. Функция не содержит fallback и не перехватывает её.`]}),`
+`,(0,c.jsx)(t.h3,{id:`это-не-кодирование-исходной-строки`,children:`Это не кодирование исходной строки`}),`
+`,(0,c.jsxs)(t.p,{children:[`Base64Url здесь кодирует байты hash, а не исходный `,(0,c.jsx)(t.code,{children:`input`}),`. Декодирование результата вернёт 16 байтов hash и не восстановит исходную строку.`]}),`
+`,(0,c.jsx)(t.h2,{id:`stringtoelementid`,children:(0,c.jsx)(t.code,{children:`stringToElementId`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Добавляет префикс к результату `,(0,c.jsx)(t.code,{children:`hashString128Base64Url`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-3`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare function stringToElementId(input: string, prefix?: string): string;
+`})}),`
+`,(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.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:`input`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsx)(t.td,{children:`Строка, определяющая стабильную часть ID.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`prefix`})}),(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:`"row"`})}),(0,c.jsx)(t.td,{children:`Читаемая часть перед hash.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`формула-результата`,children:`Формула результата`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"`${prefix}-${hashString128Base64Url(input)}`;\n"})}),`
+`,(0,c.jsx)(t.h3,{id:`примеры-текущей-реализации-1`,children:`Примеры текущей реализации`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stringToElementId("user:42");
+// "row--jMmAntlPoBJ1WByyIN48A"
+
+stringToElementId("user:42", "cell");
+// "cell--jMmAntlPoBJ1WByyIN48A"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Двойной дефис в примере корректен: первый добавлен между prefix и hash, второй является первым символом Base64Url hash.`}),`
+`,(0,c.jsx)(t.h3,{id:`стабильность`,children:`Стабильность`}),`
+`,(0,c.jsxs)(t.p,{children:[`Одинаковые `,(0,c.jsx)(t.code,{children:`input`}),` и `,(0,c.jsx)(t.code,{children:`prefix`}),` дают одинаковый результат:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stringToElementId("row:42", "cell") === stringToElementId("row:42", "cell"); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Разные префиксы разводят namespaces:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stringToElementId("42", "row");
+stringToElementId("42", "cell");
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`prefix-не-очищается`,children:`Prefix не очищается`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция вставляет `,(0,c.jsx)(t.code,{children:`prefix`}),` буквально. Она не удаляет пробелы и не экранирует CSS:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stringToElementId("42", "my row"); // Содержит пробел в ID.
+stringToElementId("42", ""); // Начинается с дефиса.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте короткий контролируемый prefix из букв, цифр, `,(0,c.jsx)(t.code,{children:`_`}),` или `,(0,c.jsx)(t.code,{children:`-`}),`. Не передавайте произвольный пользовательский ввод как prefix.`]}),`
+`,(0,c.jsx)(t.h3,{id:`поиск-элемента`,children:`Поиск элемента`}),`
+`,(0,c.jsx)(t.p,{children:`При default или безопасном prefix можно использовать:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const id = stringToElementId("row:42");
+const element = document.getElementById(id);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если ID участвует в CSS selector и его состав не полностью контролируется, экранируйте значение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"const element = document.querySelector(`#${CSS.escape(id)}`);\n"})}),`
+`,(0,c.jsxs)(t.h3,{id:`когда-выбрать-react-useid`,children:[`Когда выбрать React `,(0,c.jsx)(t.code,{children:`useId`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для связи `,(0,c.jsx)(t.code,{children:`label`}),`, `,(0,c.jsx)(t.code,{children:`input`}),`, `,(0,c.jsx)(t.code,{children:`aria-describedby`}),` и других элементов внутри React-компонента обычно лучше `,(0,c.jsx)(t.code,{children:`useId`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const id = useId();
+
+return (
+	<>
+		<label htmlFor={id}>Имя</label>
+		<input id={id} />
+	</>
+);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useId`}),` согласован с React SSR и hydration. `,(0,c.jsx)(t.code,{children:`stringToElementId`}),` нужен, когда ID должен определяться внешним стабильным business/technical key, одинаковым в разных местах.`]}),`
+`,(0,c.jsx)(t.h3,{id:`коллизия-всё-ещё-возможна`,children:`Коллизия всё ещё возможна`}),`
+`,(0,c.jsx)(t.p,{children:`Добавление prefix не делает hash уникальным. Если два input получили одинаковый hash и prefix совпадает, ID тоже совпадёт.`}),`
+`,(0,c.jsx)(t.h2,{id:`uuidv4`,children:(0,c.jsx)(t.code,{children:`uuidv4`})}),`
+`,(0,c.jsx)(t.p,{children:`Создаёт случайный UUID версии 4 через глобальный Web Crypto API.`}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-4`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`declare function uuidv4(): string;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`алгоритм-выбора`,children:`Алгоритм выбора`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Если `,(0,c.jsx)(t.code,{children:`crypto.randomUUID`}),` доступен, функция сразу возвращает его результат.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Иначе создаёт `,(0,c.jsx)(t.code,{children:`Uint8Array(16)`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Заполняет его через `,(0,c.jsx)(t.code,{children:`crypto.getRandomValues`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Устанавливает version bits для UUID v4.`}),`
+`,(0,c.jsx)(t.li,{children:`Устанавливает variant bits.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Форматирует байты как lowercase строку `,(0,c.jsx)(t.code,{children:`8-4-4-4-12`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`xxxxxxxx-xxxx-4xxx-[89ab]xxx-xxxxxxxxxxxx
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`пример-создания-сущности`,children:`Пример создания сущности`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Draft = {
+	id: string;
+	title: string;
+};
+
+export function createDraft(title: string): Draft {
+	return {
+		id: uuidv4(),
+		title
+	};
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`функция-не-проверяет-результат-native-api`,children:`Функция не проверяет результат native API`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если существует `,(0,c.jsx)(t.code,{children:`crypto.randomUUID`}),`, его результат возвращается как есть. Дополнительная проверка UUID-формата не выполняется. В обычном браузере Web Crypto соблюдает контракт; в тестовом mock ответственность лежит на тесте.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибки-не-перехватываются`,children:`Ошибки не перехватываются`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если глобальный `,(0,c.jsx)(t.code,{children:`crypto`}),` отсутствует либо недоступны и `,(0,c.jsx)(t.code,{children:`randomUUID`}),`, и `,(0,c.jsx)(t.code,{children:`getRandomValues`}),`, функция выбросит runtime error. Она не имеет Math.random fallback и не возвращает `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Это правильная граница: слабая псевдослучайность не подменяет Web Crypto незаметно.`}),`
+`,(0,c.jsx)(t.h3,{id:`uuid-не-гарантируется-базой-данных`,children:`UUID не гарантируется базой данных`}),`
+`,(0,c.jsx)(t.p,{children:`Вероятность случайного совпадения очень мала, но математическая гарантия отсутствует. Для authoritative storage всё равно используйте unique constraint и корректно обрабатывайте конфликт.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-обрезайте-uuid-без-оценки-риска`,children:`Не обрезайте UUID без оценки риска`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`uuidv4().slice(0, 8);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Такой результат содержит только небольшую часть UUID и резко уменьшает пространство вариантов. Это может быть приемлемо для временной UI-метки, но не для долговечного уникального ключа.`}),`
+`,(0,c.jsx)(t.h3,{id:`uuid-не-является-автоматически-security-token`,children:`UUID не является автоматически security token`}),`
+`,(0,c.jsx)(t.p,{children:`UUID v4 создаётся из криптографической случайности, но его назначение — идентификация. Требования к session token, reset link или access credential включают не только случайность, но также хранение, срок жизни, отзыв, transport и threat model. Используйте контракт системы безопасности, а не предположение «UUID выглядит случайным».`}),`
+`,(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:`const config = { page: 1, sort: "name" };
+
+hashString128(config); // Ошибка TypeScript: ожидается string.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сначала нужен детерминированный serializer.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-обычный-jsonstringify-может-быть-недостаточен`,children:[`Почему обычный `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),` может быть недостаточен`]}),`
+`,(0,c.jsx)(t.p,{children:`Порядок object keys может различаться:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = { page: 1, sort: "name" };
+const second = { sort: "name", page: 1 };
+
+JSON.stringify(first) !== JSON.stringify(second);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если модель считает эти объекты одинаковыми, используйте каноническое представление. В foundation-пакете для JSON-like технических значений есть `,(0,c.jsx)(t.code,{children:`stableStringify`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { hashString128 } from "@ryuzaki13/react-foundation-lib/crypto";
+import { stableStringify } from "@ryuzaki13/react-foundation-lib/utils";
+
+const fingerprint = hashString128(stableStringify(config));
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Перед использованием определите доменные правила:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`важен ли порядок массивов;`}),`
+`,(0,c.jsx)(t.li,{children:`нужно ли сохранять внешний whitespace;`}),`
+`,(0,c.jsx)(t.li,{children:`одинаковы ли uppercase/lowercase;`}),`
+`,(0,c.jsx)(t.li,{children:`как представляются даты;`}),`
+`,(0,c.jsxs)(t.li,{children:[`допустимы ли `,(0,c.jsx)(t.code,{children:`undefined`}),`, функции или циклические ссылки;`]}),`
+`,(0,c.jsx)(t.li,{children:`на какой boundary выполняется нормализация.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Hash не исправляет неоднозначную сериализацию. Он только детерминированно обрабатывает полученную строку.`}),`
+`,(0,c.jsx)(t.h3,{id:`составной-строковый-ключ`,children:`Составной строковый ключ`}),`
+`,(0,c.jsx)(t.p,{children:`Простое объединение может быть неоднозначным:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"`${first}:${second}`;\n"})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если значения сами содержат `,(0,c.jsx)(t.code,{children:`:`}),`, разные пары способны сформировать одинаковую строку. Используйте однозначную serialization scheme:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const canonical = stableStringify([first, second]);
+const key = hashString128Base64Url(canonical);
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`безопасность`,children:`Безопасность`}),`
+`,(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.jsx)(t.th,{children:`Почему`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`UI/cache fingerprint некритичных данных`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:`Быстро и детерминированно.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Stable DOM-like ID`}),(0,c.jsx)(t.td,{children:`Да, с учётом коллизий`}),(0,c.jsx)(t.td,{children:`Есть компактный URL-safe формат и prefix.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Случайный ID новой сущности`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`uuidv4`}),` использует Web Crypto.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Проверка пароля`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:`Нужен slow password hashing с salt и политикой параметров.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Подпись запроса`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:`Нужен keyed cryptographic MAC/signature.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Проверка загруженного файла по trusted digest`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:`Нужен cryptographic digest и доверенный expected value.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Сокрытие email/телефона`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:`Предсказуемый вход можно подобрать перебором.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Access token`}),(0,c.jsx)(t.td,{children:`Не автоматически`}),(0,c.jsx)(t.td,{children:`UUID не заменяет полный security contract.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Уникальность записи в базе`}),(0,c.jsx)(t.td,{children:`Недостаточно`}),(0,c.jsx)(t.td,{children:`Нужен unique constraint/authoritative allocation.`})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`не-принимайте-security-decision-по-этим-hash`,children:`Не принимайте security decision по этим hash`}),`
+`,(0,c.jsx)(t.p,{children:`Нельзя предоставлять доступ, считать payload доверенным или пропускать validation только потому, что hash совпал. Non-cryptographic hash не защищён от намеренно подобранных коллизий.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-храните-hash-как-доказательство-исходного-секрета`,children:`Не храните hash как доказательство исходного секрета`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString128(password);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Так хранить пароль нельзя. Функция быстрая, не использует salt и специально не предназначена для сопротивления перебору.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-путайте-base64url-с-безопасностью`,children:`Не путайте Base64Url с безопасностью`}),`
+`,(0,c.jsx)(t.p,{children:`Base64Url — только формат записи байтов. Он не шифрует и не подписывает значение.`}),`
+`,(0,c.jsx)(t.h2,{id:`коллизии-и-обрезание-результата`,children:`Коллизии и обрезание результата`}),`
+`,(0,c.jsx)(t.h3,{id:`что-гарантирует-детерминированность`,children:`Что гарантирует детерминированность`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`одинаковая точная строка даёт одинаковый hash;`}),`
+`,(0,c.jsx)(t.li,{children:`если два hash различаются, исходные строки точно различались;`}),`
+`,(0,c.jsx)(t.li,{children:`если два hash совпали, исходные строки могли быть одинаковыми или попасть в коллизию.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Последний пункт особенно важен: совпадение hash не доказывает равенство исходных данных.`}),`
+`,(0,c.jsx)(t.h3,{id:`сохраняйте-исходный-ключ-если-ошибка-недопустима`,children:`Сохраняйте исходный ключ, если ошибка недопустима`}),`
+`,(0,c.jsx)(t.p,{children:`Для map/cache можно хранить bucket по hash, а внутри дополнительно сравнивать каноническую строку:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Entry<T> = {
+	canonical: string;
+	value: T;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Так коллизия hash не смешает разные данные.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-обрезайте-длинный-hash-без-причины`,children:`Не обрезайте длинный hash без причины`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`hashString128Base64Url(input).slice(0, 8);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обрезание уменьшает число возможных результатов и повышает вероятность коллизии. Если короткая форма обязательна, оцените размер набора, последствия совпадения и наличие secondary equality check.`}),`
+`,(0,c.jsx)(t.h3,{id:`hex-и-base64url-имеют-одинаковую-collision-policy`,children:`Hex и Base64Url имеют одинаковую collision policy`}),`
+`,(0,c.jsx)(t.p,{children:`32 hex-символа и 22 Base64Url-символа представляют один внутренний результат. Выбирайте по требованиям к формату, а не по предполагаемой «надёжности».`}),`
+`,(0,c.jsx)(t.h3,{id:`версионируйте-долговечный-fingerprint`,children:`Версионируйте долговечный fingerprint`}),`
+`,(0,c.jsx)(t.p,{children:`Если результат сохраняется в БД, URL или файле на годы, алгоритм становится частью формата данных. Добавьте версию схемы:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:"const fingerprint = `v1:${hashString128(canonical)}`;\n"})}),`
+`,(0,c.jsxs)(t.p,{children:[`Тогда будущая замена алгоритма сможет использовать `,(0,c.jsx)(t.code,{children:`v2:`}),` и явную миграцию. Не предполагайте, что внутренний алгоритм любой utility-функции никогда не изменится между major versions.`]}),`
+`,(0,c.jsx)(t.h2,{id:`browser-nodejs-и-ssr`,children:`Browser, Node.js и SSR`}),`
+`,(0,c.jsx)(t.h3,{id:`чистые-строковые-варианты`,children:`Чистые строковые варианты`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`hashString`}),` и `,(0,c.jsx)(t.code,{children:`hashString128`}),` используют стандартные операции JavaScript и не обращаются к DOM или Web Crypto.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`btoa-boundary`,children:[(0,c.jsx)(t.code,{children:`btoa`}),` boundary`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`hashString128Base64Url`}),` и `,(0,c.jsx)(t.code,{children:`stringToElementId`}),` используют глобальный `,(0,c.jsx)(t.code,{children:`btoa`}),`. В browser он обычно доступен. В server/test runtime его наличие нужно проверить или предоставить совместимый polyfill на уровне среды.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не добавляйте случайный локальный encoder с другим byte order: server и client должны выдавать одинаковый результат.`}),`
+`,(0,c.jsx)(t.h3,{id:`web-crypto-boundary`,children:`Web Crypto boundary`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`uuidv4`}),` обращается к глобальному `,(0,c.jsx)(t.code,{children:`crypto`}),`. В runtime без Web Crypto функция завершится ошибкой.`]}),`
+`,(0,c.jsx)(t.h3,{id:`hydration`,children:`Hydration`}),`
+`,(0,c.jsxs)(t.p,{children:[`Не вызывайте `,(0,c.jsx)(t.code,{children:`uuidv4()`}),` прямо во время server и client render одного и того же компонента:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`// Неправильно для SSR и нестабильно при повторных рендерах.
+const id = uuidv4();
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Server и client создадут разные строки, а каждый render создаст новый UUID.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для DOM/ARIA ID используйте `,(0,c.jsx)(t.code,{children:`useId`}),`. Для ID новой domain entity вызывайте `,(0,c.jsx)(t.code,{children:`uuidv4`}),` в момент пользовательской команды или на authoritative creation boundary.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Детерминированный `,(0,c.jsx)(t.code,{children:`stringToElementId`}),` может совпасть на server и client только если:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`обе стороны получили совершенно одинаковый input и prefix;`}),`
+`,(0,c.jsx)(t.li,{children:`обе стороны используют ту же версию алгоритма;`}),`
+`,(0,c.jsxs)(t.li,{children:[`обе среды поддерживают нужный `,(0,c.jsx)(t.code,{children:`btoa`}),` contract.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`react-рецепты`,children:`React-рецепты`}),`
+`,(0,c.jsx)(t.h3,{id:`новый-id-при-добавлении-элемента`,children:`Новый ID при добавлении элемента`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function DraftList() {
+	const [items, setItems] = useState<Array<{ id: string; title: string }>>([]);
+
+	const addItem = () => {
+		setItems((current) => [
+			...current,
+			{
+				id: uuidv4(),
+				title: "Новый элемент"
+			}
+		]);
+	};
+
+	return (
+		<button type="button" onClick={addItem}>
+			Добавить
+		</button>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`UUID создаётся только при команде добавления, а не при каждом render.`}),`
+`,(0,c.jsx)(t.h3,{id:`client-only-id-сохранённый-в-state`,children:`Client-only ID, сохранённый в state`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function ClientOnlyDraft() {
+	const [id] = useState(() => uuidv4());
+
+	return <span>{id}</span>;
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Такой вариант сохраняет ID между client renders, но не решает SSR hydration. В development Strict Mode initializer может быть вызван повторно для проверки чистоты; использовать UUID как side effect вне state нельзя.`}),`
+`,(0,c.jsx)(t.h3,{id:`стабильный-row-id-по-business-key`,children:`Стабильный row ID по business key`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function CustomerRow({ customerId }: { customerId: string }) {
+	const rowId = stringToElementId(customerId, "customer-row");
+
+	return <tr id={rowId}>{/* Ячейки строки. */}</tr>;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`customerId`}),` изменится, изменится и DOM ID. Если две строки имеют одинаковый customer ID, они получат одинаковый DOM ID.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование`,children:`Тестирование`}),`
+`,(0,c.jsx)(t.h3,{id:`проверяйте-детерминированность-и-формат`,children:`Проверяйте детерминированность и формат`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { describe, expect, it } from "vitest";
+import { hashString128, hashString128Base64Url } from "@ryuzaki13/react-foundation-lib/crypto";
+
+describe("fingerprint", () => {
+	it("стабилен для одинакового входа", () => {
+		expect(hashString128("row:42")).toBe(hashString128("row:42"));
+	});
+
+	it("имеет ожидаемый формат", () => {
+		expect(hashString128("row:42")).toMatch(/^[0-9a-f]{32}$/);
+		expect(hashString128Base64Url("row:42")).toMatch(/^[0-9A-Za-z_-]{22}$/);
+	});
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Тест `,(0,c.jsx)(t.code,{children:`hash(a) !== hash(b)`}),` для одной выбранной пары не доказывает отсутствие коллизий вообще.`]}),`
+`,(0,c.jsx)(t.h3,{id:`test-vectors-текущей-реализации`,children:`Test vectors текущей реализации`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Input`}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`hashString`})}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`hashString128`})}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`hashString128Base64Url`})})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`""`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ztntfp`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`c431d55b3afb3e003e41d50fc08b3e54`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`xDHVWzr7PgA-QdUPwIs-VA`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"user:42"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`d5nw5e`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`fa3326027b653e8049d56072c88378f0`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`-jMmAntlPoBJ1WByyIN48A`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"строка"`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hb03a2`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`86aac3ec19e5093dc3b2f1985cfd3b49`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hqrD7BnlCT3DsvGYXP07SQ`})})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Exact vectors полезны, если hash является частью сериализуемого формата. Если формат не долговечный, часто достаточно проверять детерминированность и regex.`}),`
+`,(0,c.jsxs)(t.h3,{id:`mock-native-randomuuid`,children:[`Mock native `,(0,c.jsx)(t.code,{children:`randomUUID`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { afterEach, expect, it, vi } from "vitest";
+
+afterEach(() => {
+	vi.unstubAllGlobals();
+});
+
+it("использует native randomUUID", () => {
+	const randomUUID = vi.fn(() => "00000000-0000-4000-8000-000000000000");
+	vi.stubGlobal("crypto", { randomUUID } as unknown as Crypto);
+
+	expect(uuidv4()).toBe("00000000-0000-4000-8000-000000000000");
+	expect(randomUUID).toHaveBeenCalledOnce();
+});
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`mock-fallback-getrandomvalues`,children:[`Mock fallback `,(0,c.jsx)(t.code,{children:`getRandomValues`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("устанавливает version и variant bits", () => {
+	const getRandomValues = vi.fn((bytes: Uint8Array) => {
+		bytes.set([0, 1, 2, 3, 4, 5, 0xff, 7, 0xff, 9, 10, 11, 12, 13, 14, 15]);
+		return bytes;
+	});
+
+	vi.stubGlobal("crypto", { getRandomValues } as unknown as Crypto);
+
+	expect(uuidv4()).toBe("00010203-0405-4f07-bf09-0a0b0c0d0e0f");
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Всегда восстанавливайте global mocks после теста, иначе они повлияют на другие test cases.`}),`
+`,(0,c.jsx)(t.h3,{id:`проверка-реального-uuid-без-mock`,children:`Проверка реального UUID без mock`}),`
+`,(0,c.jsx)(t.p,{children:`Если среда предоставляет Web Crypto:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(uuidv4()).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не фиксируйте конкретное случайное значение без mock.`}),`
+`,(0,c.jsx)(t.h2,{id:`производительность`,children:`Производительность`}),`
+`,(0,c.jsx)(t.h3,{id:`сложность-hash`,children:`Сложность hash`}),`
+`,(0,c.jsxs)(t.p,{children:[`Каждая hash-функция проходит строку один раз. Временная сложность — `,(0,c.jsx)(t.code,{children:`O(n)`}),`, где `,(0,c.jsx)(t.code,{children:`n`}),` является числом UTF-16 code units.`]}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритмы работают быстро и синхронно. Но длинная строка всё равно блокирует текущий JavaScript thread на время обработки.`}),`
+`,(0,c.jsx)(t.h3,{id:`не-хешируйте-одно-и-то-же-на-каждом-render-без-необходимости`,children:`Не хешируйте одно и то же на каждом render без необходимости`}),`
+`,(0,c.jsx)(t.p,{children:`Для большого canonical payload можно вычислять fingerprint на boundary изменения или мемоизировать по стабильной ссылке:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const fingerprint = useMemo(() => hashString128(stableStringify(config)), [config]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`useMemo`}),` помогает только если зависимость `,(0,c.jsx)(t.code,{children:`config`}),` действительно стабильна между неизменившимися renders.`]}),`
+`,(0,c.jsx)(t.h3,{id:`uuid-и-hex-table`,children:`UUID и hex table`}),`
+`,(0,c.jsxs)(t.p,{children:[`Fallback `,(0,c.jsx)(t.code,{children:`uuidv4`}),` создаёт таблицу из 256 hex-строк при каждом вызове. Для обычного создания ID это несущественно. Не используйте функцию как tight-loop генератор миллионов значений на UI thread без измерений.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ограничения-и-частые-ошибки`,children:`Ограничения и частые ошибки`}),`
+`,(0,c.jsxs)(t.h3,{id:`использование-hashstring-как-уникального-primary-key`,children:[`Использование `,(0,c.jsx)(t.code,{children:`hashString`}),` как уникального primary key`]}),`
+`,(0,c.jsx)(t.p,{children:`32-bit hash слишком мал для такого обещания. Используйте UUID/backend ID или храните исходный ключ и обрабатывайте коллизии.`}),`
+`,(0,c.jsx)(t.h3,{id:`hash-пароля-или-токена`,children:`Hash пароля или токена`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const storedPassword = hashString128(password); // Небезопасно.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Эта функция быстрая, несолёная и non-cryptographic.`}),`
+`,(0,c.jsx)(t.h3,{id:`нестабильная-сериализация-объекта`,children:`Нестабильная сериализация объекта`}),`
+`,(0,c.jsx)(t.p,{children:`Если порядок ключей или нормализация входа плавают, hash тоже будет меняться. Сначала создайте canonical string.`}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-одинакового-hash-для-визуально-одинакового-unicode`,children:`Ожидание одинакового hash для визуально одинакового Unicode`}),`
+`,(0,c.jsx)(t.p,{children:`Unicode normalization не выполняется. Выберите NFC/NFD policy явно, если это требуется доменом.`}),`
+`,(0,c.jsx)(t.h3,{id:`обрезание-uuid-или-hash`,children:`Обрезание UUID или hash`}),`
+`,(0,c.jsxs)(t.p,{children:[`Обрезание уменьшает пространство результатов. Нельзя сохранять прежние гарантии после `,(0,c.jsx)(t.code,{children:`.slice(...)`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`uuidv4-внутри-render`,children:[(0,c.jsx)(t.code,{children:`uuidv4()`}),` внутри render`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Новый UUID будет создаваться при каждом render и может нарушить SSR hydration. Создавайте entity ID на command boundary; для DOM relationships используйте `,(0,c.jsx)(t.code,{children:`useId`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`небезопасный-prefix`,children:`Небезопасный prefix`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`stringToElementId`}),` не очищает prefix. Пробелы, кавычки или CSS-special characters останутся в строке.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-server-portability`,children:`Ожидание server portability`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`btoa`}),` и global Web Crypto могут отсутствовать в server/test runtime. Тестируйте целевую среду и не подменяйте алгоритм несовместимой реализацией.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сравнение-только-по-hash`,children:`Сравнение только по hash`}),`
+`,(0,c.jsx)(t.p,{children:`Совпавший hash не доказывает полное равенство. Для критичных данных сравнивайте исходную canonical string или содержимое.`}),`
+`,(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.jsx)(t.th,{children:`Runtime`}),(0,c.jsx)(t.th,{children:`Security`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`1–7 base36 символов`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsx)(t.td,{children:`Обычный JS`}),(0,c.jsx)(t.td,{children:`Non-cryptographic, 32-bit`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString128`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`32 lowercase hex-символа`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsxs)(t.td,{children:[`Обычный JS + `,(0,c.jsx)(t.code,{children:`Math.imul`})]}),(0,c.jsx)(t.td,{children:`Non-cryptographic`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`hashString128Base64Url`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsx)(t.td,{children:`22 URL-safe символа`}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsxs)(t.td,{children:[`Дополнительно `,(0,c.jsx)(t.code,{children:`btoa`})]}),(0,c.jsx)(t.td,{children:`Тот же hash, другой формат`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stringToElementId`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`input`}),`, optional `,(0,c.jsx)(t.code,{children:`prefix`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:"${prefix}-${22 symbols}"})}),(0,c.jsx)(t.td,{children:`Да`}),(0,c.jsxs)(t.td,{children:[`Дополнительно `,(0,c.jsx)(t.code,{children:`btoa`})]}),(0,c.jsx)(t.td,{children:`Коллизия возможна`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`uuidv4`})}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:`UUID v4 string`}),(0,c.jsx)(t.td,{children:`Нет`}),(0,c.jsx)(t.td,{children:`Global Web Crypto`}),(0,c.jsx)(t.td,{children:`Random ID, не security system`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsx)(t.h3,{id:`какую-hash-функцию-выбрать-по-умолчанию`,children:`Какую hash-функцию выбрать по умолчанию?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для некритичного устойчивого fingerprint обычно выбирайте `,(0,c.jsx)(t.code,{children:`hashString128`}),`. Если важна компактность и URL-safe формат — `,(0,c.jsx)(t.code,{children:`hashString128Base64Url`}),`. `,(0,c.jsx)(t.code,{children:`hashString`}),` оставляйте для сценариев, где 32-bit коллизии безопасно обрабатываются.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-base64url-результат-короче-hex`,children:`Почему Base64Url-результат короче hex?`}),`
+`,(0,c.jsx)(t.p,{children:`Hex кодирует 4 bits одним символом, а Base64 — 6 bits. Поэтому те же 16 байтов помещаются в 22 Base64Url-символа вместо 32 hex-символов.`}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-восстановить-исходную-строку-из-hash`,children:`Можно ли восстановить исходную строку из hash?`}),`
+`,(0,c.jsx)(t.p,{children:`Прямой операции восстановления нет. Но короткие и предсказуемые значения можно подобрать перебором, поэтому hash не является безопасным сокрытием данных.`}),`
+`,(0,c.jsxs)(t.h3,{id:`гарантирует-ли-hashstring128-что-коллизий-не-будет`,children:[`Гарантирует ли `,(0,c.jsx)(t.code,{children:`hashString128`}),`, что коллизий не будет?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Более длинный результат уменьшает практический риск для non-adversarial сценариев, но математическая и security-гарантия отсутствует.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-café-иногда-даёт-другой-hash`,children:[`Почему `,(0,c.jsx)(t.code,{children:`Café`}),` иногда даёт другой hash?`]}),`
+`,(0,c.jsx)(t.p,{children:`В Unicode визуально одинаковый текст может состоять из разных code points/code units. Модуль не выполняет normalization. Если домен требует равенства, приведите обе строки к одной форме, например NFC, до хеширования.`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-использовать-stringtoelementid-для-react-labelinput`,children:[`Можно ли использовать `,(0,c.jsx)(t.code,{children:`stringToElementId`}),` для React label/input?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Можно при стабильном внешнем key, но для локальной связи внутри SSR React-компонента предпочтительнее `,(0,c.jsx)(t.code,{children:`useId`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`уникален-ли-stringtoelementid-во-всём-документе`,children:[`Уникален ли `,(0,c.jsx)(t.code,{children:`stringToElementId`}),` во всём документе?`]}),`
+`,(0,c.jsx)(t.p,{children:`Только если вызывающий код обеспечивает уникальные input/prefix и принимает риск hash-коллизии. Функция не проверяет уже существующие DOM IDs.`}),`
+`,(0,c.jsx)(t.h3,{id:`почему-id-иногда-содержит-два-дефиса-подряд`,children:`Почему ID иногда содержит два дефиса подряд?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Один дефис добавляется после prefix, а Base64Url hash сам может начинаться с `,(0,c.jsx)(t.code,{children:`-`}),`. Это нормальный результат.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-вызвать-uuidv4-на-сервере`,children:[`Можно ли вызвать `,(0,c.jsx)(t.code,{children:`uuidv4`}),` на сервере?`]}),`
+`,(0,c.jsx)(t.p,{children:`Только если server runtime предоставляет совместимый global Web Crypto contract. Для переносимой server-логики используйте принятый в серверном проекте crypto API и проверьте, что формат/политика совпадают.`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-использовать-uuid-как-react-key`,children:[`Можно ли использовать UUID как React `,(0,c.jsx)(t.code,{children:`key`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Да, если UUID один раз сохранён в самой entity. Нельзя генерировать новый `,(0,c.jsx)(t.code,{children:`uuidv4()`}),` прямо внутри `,(0,c.jsx)(t.code,{children:`.map()`}),` на каждом render: ключи будут постоянно меняться, и React станет пересоздавать элементы.`]}),`
+`,(0,c.jsx)(t.h3,{id:`нужно-ли-проверять-uuid-на-конфликт-в-базе`,children:`Нужно ли проверять UUID на конфликт в базе?`}),`
+`,(0,c.jsx)(t.p,{children:`Да. Очень малая вероятность не заменяет unique constraint у authoritative storage.`}),`
+`,(0,c.jsx)(t.h3,{id:`стабильны-ли-exact-hash-между-версиями-пакета`,children:`Стабильны ли exact hash между версиями пакета?`}),`
+`,(0,c.jsx)(t.p,{children:`В рамках текущей реализации — да. Если вы сохраняете результат надолго или используете его как внешний протокол, версионируйте формат и зафиксируйте test vectors. Это позволит безопасно обнаружить или мигрировать будущую смену алгоритма.`})]})}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};