@ryuzaki13/react-foundation-ui 1.8.11 → 1.8.12

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

@@ -0,0 +1,1146 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-FSp_AjJa.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B5YBxaaS.js";function o(e){let t={a:`a`,blockquote:`blockquote`,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/Utils`}),`
+`,(0,c.jsxs)(t.h1,{id:`общие-утилиты-ryuzaki13react-foundation-libutils`,children:[`Общие утилиты `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/utils`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`utils`}),` объединяет небольшие технические функции, которые нужны в разных частях React- и TypeScript-приложения:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`сборка строки `,(0,c.jsx)(t.code,{children:`className`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`глубокое копирование данных без функций;`}),`
+`,(0,c.jsx)(t.li,{children:`стабильная JSON-сериализация;`}),`
+`,(0,c.jsx)(t.li,{children:`UTF-8-кодирование текста в Base64;`}),`
+`,(0,c.jsx)(t.li,{children:`обработка клавиатурной активации и расчёт следующего элемента навигации;`}),`
+`,(0,c.jsx)(t.li,{children:`ленивое подключение React-компонентов;`}),`
+`,(0,c.jsx)(t.li,{children:`подсчёт React children;`}),`
+`,(0,c.jsx)(t.li,{children:`копирование древовидной структуры;`}),`
+`,(0,c.jsxs)(t.li,{children:[`единая точка вывода ошибок в `,(0,c.jsx)(t.code,{children:`console.error`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Документ рассчитан на разработчика без доступа к исходному коду пакета и с минимальным знанием JavaScript, TypeScript и React. Поэтому ниже объясняются назначение каждого аргумента, точный результат, побочные эффекты, различия похожих функций и ограничения.`}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`utils`}),` — это опубликованный entrypoint, а не приглашение складывать сюда любую бизнес-логику. В модуле нет HTTP-запросов, UI-компонентов, доменных правил, нормализации пользовательского ввода и криптографии.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`содержание`,children:`Содержание`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,children:`Назначение и границы`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%81%D1%80%D0%B5%D0%B4%D0%B0-%D0%B2%D1%8B%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D1%8F`,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-%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D1%8E`,children:`Как выбрать функцию`})}),`
+`,(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.jsxs)(t.a,{href:`#cn-%D0%B8-deprecated-classnames`,children:[(0,c.jsx)(t.code,{children:`cn`}),` и deprecated `,(0,c.jsx)(t.code,{children:`classNames`})]})}),`
+`,(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-%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D1%8E-%D0%BA%D0%BB%D0%BE%D0%BD%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F`,children:`Как выбрать функцию клонирования`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#deepcopywithoutfunctions`,children:(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#deepclonewithoutfunctions`,children:(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#clone-%D0%BD%D0%B5-%D1%8F%D0%B2%D0%BB%D1%8F%D0%B5%D1%82%D1%81%D1%8F-normalize`,children:`Clone не является normalize`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#stablestringify`,children:(0,c.jsx)(t.code,{children:`stableStringify`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#tobase64-%D0%B8-encodebase64`,children:[(0,c.jsx)(t.code,{children:`toBase64`}),` и `,(0,c.jsx)(t.code,{children:`encodeBase64`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D0%BB%D0%B0%D0%B2%D0%B8%D0%B0%D1%82%D1%83%D1%80%D0%BD%D0%B0%D1%8F-%D0%B0%D0%BA%D1%82%D0%B8%D0%B2%D0%B0%D1%86%D0%B8%D1%8F`,children:`Клавиатурная активация`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#roving-focus`,children:`Roving focus`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%B0%D0%B2%D0%B8%D0%B3%D0%B0%D1%86%D0%B8%D1%8F-%D0%BF%D0%BE-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BD%D1%8B%D0%BC-%D0%BE%D0%BF%D1%86%D0%B8%D1%8F%D0%BC`,children:`Навигация по доступным опциям`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#createlazycomponent`,children:(0,c.jsx)(t.code,{children:`createLazyComponent`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#childrencount`,children:(0,c.jsx)(t.code,{children:`childrenCount`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#deepcopynodes-%D0%B8-deepcopytree`,children:[(0,c.jsx)(t.code,{children:`deepCopyNodes`}),` и `,(0,c.jsx)(t.code,{children:`deepCopyTree`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#logerror`,children:(0,c.jsx)(t.code,{children:`logError`})})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#ssr-browser-%D0%B8-react-%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B`,children:`SSR, browser и React-границы`})}),`
+`,(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:`#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-consumer-%D0%BA%D0%BE%D0%B4%D0%B0`,children:`Тестирование consumer-кода`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%BE%D0%BB%D0%BD%D1%8B%D0%B9-api-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA`,children:`Полный API-справочник`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%82%D0%B8%D0%BF%D0%B8%D1%87%D0%BD%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%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.jsx)(t.h3,{id:`что-делает-модуль`,children:`Что делает модуль`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`utils`}),` предоставляет общие технические операции, не зависящие от бизнес-сущности приложения:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`входные данные или UI-событие
+              │
+              ▼
+      маленькая utility-функция
+              │
+              ▼
+строка / копия / индекс / React lazy component
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Большинство функций являются синхронными: они сразу возвращают результат. Исключение по жизненному циклу — `,(0,c.jsx)(t.code,{children:`createLazyComponent`}),`: функция синхронно создаёт React lazy component, но его модуль загружается асинхронно только при первом рендере.`]}),`
+`,(0,c.jsx)(t.h3,{id:`чего-модуль-не-делает`,children:`Чего модуль не делает`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`не отправляет HTTP- или OData-запросы;`}),`
+`,(0,c.jsx)(t.li,{children:`не создаёт готовые визуальные компоненты;`}),`
+`,(0,c.jsx)(t.li,{children:`не хранит React state и не создаёт store;`}),`
+`,(0,c.jsx)(t.li,{children:`не валидирует backend payload;`}),`
+`,(0,c.jsx)(t.li,{children:`не нормализует пользовательский draft;`}),`
+`,(0,c.jsx)(t.li,{children:`не шифрует данные и не создаёт криптографические подписи;`}),`
+`,(0,c.jsx)(t.li,{children:`не декодирует Base64 обратно в строку;`}),`
+`,(0,c.jsx)(t.li,{children:`не управляет DOM-фокусом самостоятельно;`}),`
+`,(0,c.jsx)(t.li,{children:`не заменяет Error Boundary, logger transport или error-reporting service;`}),`
+`,(0,c.jsx)(t.li,{children:`не гарантирует копирование любого встроенного browser/JavaScript-объекта.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`соседние-владельцы`,children:`Соседние владельцы`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Задача`}),(0,c.jsx)(t.th,{children:`Предпочтительный модуль`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Массивы, группировка, дедупликация и reorder`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/array`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Runtime-проверки `,(0,c.jsx)(t.code,{children:`unknown`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/validators`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Hash, UUID и стабильный DOM id`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/crypto`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Base64/Binary в `,(0,c.jsx)(t.code,{children:`Blob`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/binary`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Clipboard`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/copy`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`DOM, portal, focus и browser download`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/dom`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Debounce, throttle и React hooks`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/hooks`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Форматирование дат, чисел, строк и value state`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/formatters`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Сериализуемый error report и его доставка`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/error-report`}),` и API-пакет`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`UI primitives`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-ui/<module>`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Бизнес-преобразование сущности`}),(0,c.jsx)(t.td,{children:`entity/feature/widget host-приложения`})]})]})]}),`
+`,(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:[`Entrypoint `,(0,c.jsx)(t.code,{children:`/utils`}),` также экспортирует React-функции `,(0,c.jsx)(t.code,{children:`childrenCount`}),` и `,(0,c.jsx)(t.code,{children:`createLazyComponent`}),`. Поэтому host-приложение должно разрешить совместимую peer dependency React:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-bash`,children:`npm install react
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Текущий контракт пакета рассчитан на React `,(0,c.jsx)(t.code,{children:`>=19.2.0 <20.0.0`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Импортируйте API только из опубликованного subpath:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { cn, deepCopyWithoutFunctions, handleKeyboardActivation, stableStringify, toBase64 } from "@ryuzaki13/react-foundation-lib/utils";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Публичные типы импортируйте через `,(0,c.jsx)(t.code,{children:`import type`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import type {
+	KeyboardActivationKey,
+	PureClassName,
+	RovingFocusTargetOptions,
+	ToggleClassName
+} from "@ryuzaki13/react-foundation-lib/utils";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Неверные варианты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Корневой entrypoint пакета не опубликован.
+import { cn } from "@ryuzaki13/react-foundation-lib";
+
+// Внутренний файл не является публичным контрактом.
+import { cn } from "@ryuzaki13/react-foundation-lib/dist/utils/cn";
+
+// Исходный путь пакета также нельзя использовать из consumer-приложения.
+import { cn } from "@ryuzaki13/react-foundation-lib/src/utils/cn";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пакет распространяется как ESM. Используйте `,(0,c.jsx)(t.code,{children:`import`}),`, а не CommonJS `,(0,c.jsx)(t.code,{children:`require`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`почему-некоторые-типы-опций-нельзя-импортировать`,children:`Почему некоторые типы опций нельзя импортировать`}),`
+`,(0,c.jsxs)(t.p,{children:[`Типы параметров `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),`, `,(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`}),`, `,(0,c.jsx)(t.code,{children:`handleKeyboardActivation`}),`, `,(0,c.jsx)(t.code,{children:`findNextEnabledIndex`}),` и `,(0,c.jsx)(t.code,{children:`createLazyComponent`}),` участвуют в публичных сигнатурах, но не экспортируются как отдельные имена. Обычно это не мешает: TypeScript проверит переданный объект прямо в месте вызова.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`deepCopyWithoutFunctions(source, {
+	arrayFunctionStrategy: "undefined"
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не импортируйте внутренние типы глубоким путём. Если тип нужен для собственной обёртки, получите его из публичной функции:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type DeepCopyOptions = NonNullable<Parameters<typeof deepCopyWithoutFunctions>[1]>;
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`среда-выполнения`,children:`Среда выполнения`}),`
+`,(0,c.jsx)(t.p,{children:`У разных функций разные runtime-требования:`}),`
+`,(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,{style:{textAlign:`center`},children:`React`}),(0,c.jsx)(t.th,{style:{textAlign:`center`},children:`Browser API`}),(0,c.jsx)(t.th,{style:{textAlign:`center`},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:`cn`}),`, clone-функции, `,(0,c.jsx)(t.code,{children:`stableStringify`}),`, keyboard/select navigation, tree copy`]}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`logError`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`да, если доступен console`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`childrenCount`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`да`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createLazyComponent`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`да`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`создаётся да; рендер по правилам React`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toBase64`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsxs)(t.td,{style:{textAlign:`center`},children:[(0,c.jsx)(t.code,{children:`btoa`}),`, `,(0,c.jsx)(t.code,{children:`TextEncoder`})]}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`только при наличии API`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`encodeBase64`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`нет`}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:(0,c.jsx)(t.code,{children:`btoa`})}),(0,c.jsx)(t.td,{style:{textAlign:`center`},children:`только при наличии API`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`В современных браузерах нужные Base64 API обычно доступны. В Node.js их наличие зависит от версии и окружения. Модуль намеренно не подменяет их через `,(0,c.jsx)(t.code,{children:`Buffer`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`минимальные-понятия`,children:`Минимальные понятия`}),`
+`,(0,c.jsx)(t.h3,{id:`примитивы-и-ссылочные-значения`,children:`Примитивы и ссылочные значения`}),`
+`,(0,c.jsxs)(t.p,{children:[`Строки, числа, `,(0,c.jsx)(t.code,{children:`boolean`}),`, `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`undefined`}),` — примитивные значения. Объекты, массивы, `,(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`}),`, `,(0,c.jsx)(t.code,{children:`Date`}),` и функции — ссылочные значения.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = { name: "Анна" };
+const same = source;
+
+console.log(same === source); // true: обе переменные указывают на один объект.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Копия должна иметь другое внешнее значение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const copy = deepCopyWithoutFunctions(source);
+
+console.log(copy === source); // false.
+console.log(copy.name); // "Анна".
+`})}),`
+`,(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 source = { profile: { city: "Казань" } };
+const shallow = { ...source };
+
+console.log(shallow !== source); // true.
+console.log(shallow.profile === source.profile); // true: вложенный объект общий.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Глубокая копия рекурсивно копирует поддерживаемые вложенные значения:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const deep = deepCopyWithoutFunctions(source);
+
+console.log(deep.profile === source.profile); // false.
+`})}),`
+`,(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:`source.profile.city = "Пермь";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функции клонирования и tree copy не изменяют входное значение. Они создают новый результат. Но копирование дерева клонирует только узлы и массивы дочерних узлов, а не каждое произвольное вложенное поле.`}),`
+`,(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 value = {
+	id: "A",
+	onClick: () => console.log("click")
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Clone-функции этого модуля специально не переносят функции в результат. Это полезно для data-only конфигураций и snapshots, но не подходит для клонирования объектов, где callback является обязательной частью поведения.`}),`
+`,(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 sparse = ["A", , "C"];
+
+console.log(sparse.length); // 3.
+console.log(1 in sparse); // false: индекс 1 отсутствует.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это не то же самое, что явное значение `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const indexed = ["A", undefined, "C"];
+
+console.log(1 in indexed); // true.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Разница важна для `,(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`json-и-base64`,children:[(0,c.jsx)(t.code,{children:`JSON`}),` и Base64`]}),`
+`,(0,c.jsxs)(t.p,{children:[`JSON — текстовый формат данных. `,(0,c.jsx)(t.code,{children:`stableStringify`}),` создаёт JSON-строку с отсортированными ключами объектов.`]}),`
+`,(0,c.jsx)(t.p,{children:`Base64 — способ представить байты печатными символами. Это кодирование, а не шифрование: любой получатель может декодировать исходный текст.`}),`
+`,(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:`API`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Собрать `,(0,c.jsx)(t.code,{children:`className`}),` из строк и boolean-флагов`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`cn`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Поддержать старый код с прежним именем`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`classNames`}),`, но новый код — `,(0,c.jsx)(t.code,{children:`cn`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Клонировать строгую data-only конфигурацию`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Клонировать также `,(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`}),`, `,(0,c.jsx)(t.code,{children:`RegExp`}),`, cycles и descriptors`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Получить одинаковый JSON для объектов с разным порядком ключей`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stableStringify`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Кодировать Unicode-текст в стандартный Base64`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toBase64`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Распознать `,(0,c.jsx)(t.code,{children:`Enter`}),` или пробел`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isKeyboardActivationKey`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Активировать кастомный control с клавиатуры`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`handleKeyboardActivation`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Рассчитать новый индекс для `,(0,c.jsx)(t.code,{children:`Tabs`}),`/`,(0,c.jsx)(t.code,{children:`RadioGroup`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Найти первую, последнюю или следующую enabled-опцию`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`findFirstEnabledIndex`}),`, `,(0,c.jsx)(t.code,{children:`findLastEnabledIndex`}),`, `,(0,c.jsx)(t.code,{children:`findNextEnabledIndex`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Лениво загрузить именованный React-компонент`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createLazyComponent`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Посчитать React children, раскрывая fragments`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`childrenCount`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Скопировать узлы дерева с полем `,(0,c.jsx)(t.code,{children:`children`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyNodes`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Скопировать дерево с произвольным названием поля детей`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyTree`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Направить ошибку в `,(0,c.jsx)(t.code,{children:`globalThis.console.error`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`logError`})})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`быстрый-старт`,children:`Быстрый старт`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { cn, deepCopyWithoutFunctions, findNextEnabledIndex, stableStringify, toBase64 } from "@ryuzaki13/react-foundation-lib/utils";
+
+const className = cn("button", {
+	"button--active": true,
+	"button--disabled": false
+});
+// "button button--active"
+
+const draft = {
+	title: "Новая группа ",
+	enabled: false,
+	items: [{ id: "A" }],
+	onSave: () => undefined
+};
+
+const copy = deepCopyWithoutFunctions(draft);
+// title сохраняет завершающий пробел, enabled остаётся false,
+// items глубоко скопирован, onSave отсутствует.
+
+const cachePart = stableStringify({ page: 1, filter: { status: "OPEN" } });
+// '{"filter":{"status":"OPEN"},"page":1}'
+
+const encoded = toBase64("Привет");
+// Стандартная Base64-строка для UTF-8-байтов текста.
+
+const options = [{ disabled: false }, { disabled: true }, { disabled: false }];
+const nextIndex = findNextEnabledIndex(options, 0, 1, (option) => option.disabled);
+// 2: индекс 1 пропущен, потому что опция disabled.
+`})}),`
+`,(0,c.jsxs)(t.h2,{id:`cn-и-deprecated-classnames`,children:[(0,c.jsx)(t.code,{children:`cn`}),` и deprecated `,(0,c.jsx)(t.code,{children:`classNames`})]}),`
+`,(0,c.jsx)(t.h3,{id:`назначение`,children:`Назначение`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`cn`}),` собирает одну строку CSS-классов из:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`строк;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`false`}),`, `,(0,c.jsx)(t.code,{children:`undefined`}),`, `,(0,c.jsx)(t.code,{children:`null`}),`, пустой строки и `,(0,c.jsx)(t.code,{children:`true`}),`, которые игнорируются;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`объекта вида `,(0,c.jsx)(t.code,{children:`{ "имя-класса": условие }`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { cn } from "@ryuzaki13/react-foundation-lib/utils";
+
+const result = cn("button", isPrimary && "button--primary", {
+	"button--loading": isLoading,
+	"button--disabled": disabled
+});
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`isPrimary === true`}),`, `,(0,c.jsx)(t.code,{children:`isLoading === false`}),`, `,(0,c.jsx)(t.code,{children:`disabled === true`}),`, результат:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`button button--primary button--disabled
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type PureClassName = string | boolean | undefined | null;
+type ToggleClassName = Record<string, boolean | undefined>;
+
+function cn(...args: Array<PureClassName | ToggleClassName>): string;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`...args`}),` означает любое количество аргументов.`]}),`
+`,(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:`cn()`}),` возвращает пустую строку `,(0,c.jsx)(t.code,{children:`""`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Строки добавляются в порядке аргументов.`}),`
+`,(0,c.jsx)(t.li,{children:`Ключи объекта с truthy-значением добавляются в порядке обхода объекта.`}),`
+`,(0,c.jsx)(t.li,{children:`Строки не обрезаются и не разбиваются на отдельные слова.`}),`
+`,(0,c.jsx)(t.li,{children:`Повторяющиеся классы не удаляются.`}),`
+`,(0,c.jsx)(t.li,{children:`Числа не входят в публичный тип и в runtime игнорируются.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Массивы игнорируются: `,(0,c.jsx)(t.code,{children:`cn`}),` не является рекурсивным `,(0,c.jsx)(t.code,{children:`classnames`}),`-парсером.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`cn("a b", "b", { c: true }); // "a b b c".
+cn(["a", "b"] as never, "c"); // "c": массив проигнорирован.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте обычные object literals. Реализация обходит enumerable-ключи через `,(0,c.jsx)(t.code,{children:`for...in`}),`, поэтому объект с вручную настроенным prototype может добавить унаследованный enumerable-ключ.`]}),`
+`,(0,c.jsx)(t.h3,{id:`classnames`,children:(0,c.jsx)(t.code,{children:`classNames`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`classNames`}),` — deprecated-алиас той же функции `,(0,c.jsx)(t.code,{children:`cn`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { classNames } from "@ryuzaki13/react-foundation-lib/utils";
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Новый код должен использовать `,(0,c.jsx)(t.code,{children:`cn`}),`. Алиас существует только для уже написанного consumer-кода и не предоставляет другого поведения.`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-функцию-клонирования`,children:`Как выбрать функцию клонирования`}),`
+`,(0,c.jsx)(t.p,{children:`В модуле есть две похожие функции. Они не взаимозаменяемы во всех сценариях.`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Свойство`}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`})}),(0,c.jsx)(t.th,{children:(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`})})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Основное назначение`}),(0,c.jsx)(t.td,{children:`Строгая data-only конфигурация`}),(0,c.jsx)(t.td,{children:`Более широкий JavaScript object graph`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Примитивы, массивы, plain object`}),(0,c.jsx)(t.td,{children:`да`}),(0,c.jsx)(t.td,{children:`да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Date`})}),(0,c.jsx)(t.td,{children:`да`}),(0,c.jsx)(t.td,{children:`да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`RegExp`}),`, `,(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`})]}),(0,c.jsxs)(t.td,{children:[`нет, выбрасывает `,(0,c.jsx)(t.code,{children:`TypeError`})]}),(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.td,{children:`да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Функции в object`}),(0,c.jsx)(t.td,{children:`поле удаляется`}),(0,c.jsx)(t.td,{children:`data-свойство удаляется`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Функции в array по умолчанию`}),(0,c.jsxs)(t.td,{children:[`элемент удаляется, массив сжимается (`,(0,c.jsx)(t.code,{children:`"omit"`}),`)`]}),(0,c.jsxs)(t.td,{children:[`индекс остаётся со значением `,(0,c.jsx)(t.code,{children:`undefined`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Разреженные позиции массива`}),(0,c.jsxs)(t.td,{children:[`превращаются в явный `,(0,c.jsx)(t.code,{children:`undefined`})]}),(0,c.jsx)(t.td,{children:`сохраняются как пропущенные позиции`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Symbol и non-enumerable properties`}),(0,c.jsx)(t.td,{children:`не копируются`}),(0,c.jsx)(t.td,{children:`копируются`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Getter/setter`}),(0,c.jsx)(t.td,{children:`getter может быть вызван; значение копируется`}),(0,c.jsx)(t.td,{children:`accessor полностью пропускается и не вызывается`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Property descriptors`}),(0,c.jsx)(t.td,{children:`не сохраняются`}),(0,c.jsx)(t.td,{children:`сохраняются для data-свойств`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Prototype`}),(0,c.jsx)(t.td,{children:`результат — обычный объект`}),(0,c.jsx)(t.td,{children:`обычный объект или исходный prototype по опции`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Неподдержанный специальный built-in`}),(0,c.jsxs)(t.td,{children:[`явный `,(0,c.jsx)(t.code,{children:`TypeError`})]}),(0,c.jsx)(t.td,{children:`поведение не гарантировано`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Практическое правило:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`сохраняемая конфигурация, DTO-like draft, Zustand snapshot
+                         │
+                         ▼
+           deepCopyWithoutFunctions
+
+Map / Set / RegExp / descriptors / общий object graph
+                         │
+                         ▼
+          deepCloneWithoutFunctions
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если значения должны пережить JSON/localStorage/backend boundary, строгая функция обычно безопаснее: неподдерживаемый объект обнаружится сразу, а не превратится в объект с неожиданным поведением.`}),`
+`,(0,c.jsx)(t.h2,{id:`deepcopywithoutfunctions`,children:(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`})}),`
+`,(0,c.jsx)(t.h3,{id:`назначение-1`,children:`Назначение`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),` создаёт независимую копию строгой data-only структуры и удаляет функции. Поддерживаются:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`, `,(0,c.jsx)(t.code,{children:`undefined`}),`, строки, числа, `,(0,c.jsx)(t.code,{children:`boolean`}),`, `,(0,c.jsx)(t.code,{children:`bigint`}),`, `,(0,c.jsx)(t.code,{children:`symbol`}),` как корневые/вложенные примитивы;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Date`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`массивы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`plain objects с prototype `,(0,c.jsx)(t.code,{children:`Object.prototype`}),` или `,(0,c.jsx)(t.code,{children:`null`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`циклические ссылки и повторное использование одного массива/plain object.`}),`
+`]}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[`Поддержка `,(0,c.jsx)(t.code,{children:`bigint`}),` и `,(0,c.jsx)(t.code,{children:`symbol`}),` клонированием не означает, что их затем сможет сериализовать JSON. `,(0,c.jsx)(t.code,{children:`stableStringify`}),` подчиняется ограничениям `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`базовый-пример`,children:`Базовый пример`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { deepCopyWithoutFunctions } from "@ryuzaki13/react-foundation-lib/utils";
+
+const source = {
+	id: "REPORT-1",
+	title: " Мой отчёт ",
+	enabled: false,
+	filters: [{ field: "STATUS", values: [] }],
+	createdAt: new Date("2026-01-02T00:00:00.000Z"),
+	onOpen: () => undefined
+};
+
+const copy = deepCopyWithoutFunctions(source);
+
+console.log(copy !== source); // true.
+console.log(copy.filters !== source.filters); // true.
+console.log(copy.filters[0] !== source.filters[0]); // true.
+console.log(copy.createdAt !== source.createdAt); // true.
+console.log("onOpen" in copy); // false.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Строка `,(0,c.jsx)(t.code,{children:`" Мой отчёт "`}),`, явный `,(0,c.jsx)(t.code,{children:`false`}),` и пустой массив сохраняются буквально.`]}),`
+`,(0,c.jsx)(t.h3,{id:`функции-внутри-массива`,children:`Функции внутри массива`}),`
+`,(0,c.jsxs)(t.p,{children:[`По умолчанию применяется стратегия `,(0,c.jsx)(t.code,{children:`"omit"`}),`: функция удаляется, а следующие элементы сдвигаются влево.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = deepCopyWithoutFunctions(["A", () => "skip", "C"]);
+
+console.log(result); // ["A", "C"].
+console.log(result.length); // 2.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Стратегия `,(0,c.jsx)(t.code,{children:`"undefined"`}),` сохраняет длину и индексы:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = deepCopyWithoutFunctions(["A", () => "skip", "C"], {
+	arrayFunctionStrategy: "undefined"
+});
+
+console.log(result); // ["A", undefined, "C"].
+console.log(result.length); // 3.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Выбирайте `,(0,c.jsx)(t.code,{children:`"undefined"`}),`, если индекс имеет самостоятельное значение. Учитывайте, что JSON затем превратит `,(0,c.jsx)(t.code,{children:`undefined`}),` в массиве в `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`plain-object`,children:`Plain object`}),`
+`,(0,c.jsxs)(t.p,{children:[`Plain object — обычный объект `,(0,c.jsx)(t.code,{children:`{}`}),` или объект без prototype:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ordinary = { id: "A" };
+const withoutPrototype = Object.create(null) as Record<string, unknown>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция копирует только собственные enumerable string-свойства, возвращая обычный объект `,(0,c.jsx)(t.code,{children:`{}`}),`. Symbol-ключи, non-enumerable свойства и исходный prototype не сохраняются.`]}),`
+`,(0,c.jsx)(t.p,{children:`Getter может быть вызван, потому что значение читается как обычное свойство:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = {
+	get total() {
+		return 10;
+	}
+};
+
+const copy = deepCopyWithoutFunctions(source);
+console.log(copy.total); // 10, теперь это обычное поле результата.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте getter с побочными эффектами в data-only конфигурациях.`}),`
+`,(0,c.jsx)(t.h3,{id:`cycles-и-повторные-ссылки`,children:`Cycles и повторные ссылки`}),`
+`,(0,c.jsx)(t.p,{children:`Для массивов и plain objects используется таблица уже скопированных ссылок. Поэтому цикл не вызывает бесконечную рекурсию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source: { id: string; self?: unknown } = { id: "A" };
+source.self = source;
+
+const copy = deepCopyWithoutFunctions(source);
+
+console.log(copy.self === copy); // true.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если один вложенный plain object встречается в двух местах, в результате оба поля будут ссылаться на одну и ту же его копию.`}),`
+`,(0,c.jsx)(t.h3,{id:`неподдерживаемые-объекты`,children:`Неподдерживаемые объекты`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция выбрасывает `,(0,c.jsx)(t.code,{children:`TypeError`}),` для объектов, которые не являются `,(0,c.jsx)(t.code,{children:`Date`}),`, массивом или plain object:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`deepCopyWithoutFunctions(new Map());
+// TypeError: Unsupported object for config clone: [object Map]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`К неподдерживаемым значениям относятся, например:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`}),`, `,(0,c.jsx)(t.code,{children:`RegExp`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`экземпляры пользовательских классов;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`URL`}),`, `,(0,c.jsx)(t.code,{children:`Error`}),`, `,(0,c.jsx)(t.code,{children:`Promise`}),`, `,(0,c.jsx)(t.code,{children:`WeakMap`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`ArrayBuffer`}),` и typed arrays;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`browser `,(0,c.jsx)(t.code,{children:`Blob`}),`, `,(0,c.jsx)(t.code,{children:`File`}),` и DOM nodes.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не подавляйте такую ошибку без анализа. Она обычно сообщает, что в сериализуемую конфигурацию попал объект неправильного слоя.`}),`
+`,(0,c.jsx)(t.h3,{id:`корневая-функция`,children:`Корневая функция`}),`
+`,(0,c.jsxs)(t.p,{children:[`Если само входное значение является функцией, runtime-результат — `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = deepCopyWithoutFunctions(() => "value");
+console.log(result); // undefined.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обычно корневая функция означает ошибочный вызов. Не полагайтесь на generic return type как на runtime-проверку.`}),`
+`,(0,c.jsx)(t.h2,{id:`deepclonewithoutfunctions`,children:(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`})}),`
+`,(0,c.jsx)(t.h3,{id:`назначение-2`,children:`Назначение`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`}),` работает с более широким object graph. Помимо обычных объектов и массивов функция отдельно поддерживает:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Date`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`RegExp`}),`, включая `,(0,c.jsx)(t.code,{children:`lastIndex`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Map`}),`, включая клонирование ключей и значений;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Set`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`циклические ссылки;`}),`
+`,(0,c.jsx)(t.li,{children:`symbol и non-enumerable data-свойства;`}),`
+`,(0,c.jsx)(t.li,{children:`property descriptors;`}),`
+`,(0,c.jsx)(t.li,{children:`опциональное сохранение prototype.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`базовый-пример-1`,children:`Базовый пример`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { deepCloneWithoutFunctions } from "@ryuzaki13/react-foundation-lib/utils";
+
+const source: Record<string, unknown> = {
+	pattern: /order/gi,
+	lookup: new Map([["A", { title: "Первая" }]]),
+	selected: new Set(["A", "B"]),
+	onReset: () => undefined
+};
+source.self = source;
+
+const clone = deepCloneWithoutFunctions(source);
+
+console.log(clone !== source); // true.
+console.log(clone.self === clone); // true.
+console.log(clone.lookup !== source.lookup); // true.
+console.log("onReset" in clone); // false.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`массивы-значение-по-умолчанию`,children:`Массивы: значение по умолчанию`}),`
+`,(0,c.jsxs)(t.p,{children:[`В отличие от `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),`, здесь default-стратегия сохраняет индекс и записывает `,(0,c.jsx)(t.code,{children:`undefined`}),` вместо функции:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = deepCloneWithoutFunctions(["A", () => "skip", "C"]);
+
+console.log(result); // ["A", undefined, "C"].
+console.log(result.length); // 3.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Чтобы удалить функции и сжать массив, передайте `,(0,c.jsx)(t.code,{children:`"omit"`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = deepCloneWithoutFunctions(["A", () => "skip", "C"], {
+	arrayFunctionStrategy: "omit"
+});
+
+console.log(result); // ["A", "C"].
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Default-режим сохраняет настоящие «дыры» разреженного массива:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = ["A", , "C"];
+const clone = deepCloneWithoutFunctions(source);
+
+console.log(clone.length); // 3.
+console.log(1 in clone); // false.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В режиме `,(0,c.jsx)(t.code,{children:`"omit"`}),` все существующие нефункциональные элементы уплотняются, поэтому исходные индексы больше не сохраняются.`]}),`
+`,(0,c.jsx)(t.h3,{id:`map`,children:(0,c.jsx)(t.code,{children:`Map`})}),`
+`,(0,c.jsx)(t.p,{children:`Клонируются и ключи, и значения:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const key = { id: "A" };
+const source = new Map([[key, { title: "Запись" }]]);
+const clone = deepCloneWithoutFunctions(source);
+
+console.log(clone.has(key)); // false: исходный object key был скопирован.
+console.log([...clone.keys()][0] === key); // false.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если ключ или значение пары является функцией, вся пара пропускается.`}),`
+`,(0,c.jsx)(t.h3,{id:`set`,children:(0,c.jsx)(t.code,{children:`Set`})}),`
+`,(0,c.jsx)(t.p,{children:`Каждый элемент клонируется. Элементы-функции пропускаются:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const clone = deepCloneWithoutFunctions(new Set([1, () => 2, 3]));
+
+console.log([...clone]); // [1, 3].
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`descriptors-symbols-и-accessors`,children:`Descriptors, symbols и accessors`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для обычного объекта обходятся все собственные ключи через `,(0,c.jsx)(t.code,{children:`Reflect.ownKeys`}),`, включая symbols и non-enumerable properties. Для data-свойства сохраняются флаги `,(0,c.jsx)(t.code,{children:`enumerable`}),`, `,(0,c.jsx)(t.code,{children:`writable`}),` и `,(0,c.jsx)(t.code,{children:`configurable`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Getter/setter-свойства полностью пропускаются: getter не вызывается, но accessor также не переносится в clone.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`let calls = 0;
+const source = {
+	get computed() {
+		calls += 1;
+		return 10;
+	}
+};
+
+const clone = deepCloneWithoutFunctions(source);
+
+console.log(calls); // 0.
+console.log("computed" in clone); // false.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`preserveprototype`,children:(0,c.jsx)(t.code,{children:`preservePrototype`})}),`
+`,(0,c.jsx)(t.p,{children:`По умолчанию generic object превращается в plain object:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`class Model {
+	value = 1;
+}
+
+const source = new Model();
+const plain = deepCloneWithoutFunctions(source);
+
+console.log(plain instanceof Model); // false.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Опция `,(0,c.jsx)(t.code,{children:`preservePrototype: true`}),` создаёт результат с тем же prototype:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const clone = deepCloneWithoutFunctions(source, {
+	preservePrototype: true
+});
+
+console.log(clone instanceof Model); // true.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это не вызывает constructor и не восстанавливает private fields или внутренние слоты платформенных объектов. `,(0,c.jsx)(t.code,{children:`instanceof === true`}),` не доказывает, что экземпляр полностью работоспособен.`]}),`
+`,(0,c.jsx)(t.h3,{id:`граница-поддерживаемых-built-ins`,children:`Граница поддерживаемых built-ins`}),`
+`,(0,c.jsxs)(t.p,{children:[`Специальная корректная логика есть только для `,(0,c.jsx)(t.code,{children:`Date`}),`, `,(0,c.jsx)(t.code,{children:`RegExp`}),`, `,(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`}),`, массивов и generic objects. Для `,(0,c.jsx)(t.code,{children:`URL`}),`, `,(0,c.jsx)(t.code,{children:`Error`}),`, `,(0,c.jsx)(t.code,{children:`Promise`}),`, `,(0,c.jsx)(t.code,{children:`WeakMap`}),`, `,(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`, typed arrays, `,(0,c.jsx)(t.code,{children:`Blob`}),`, `,(0,c.jsx)(t.code,{children:`File`}),` и DOM nodes поведение не является поддерживаемым контрактом. Они могут превратиться в внешне похожий, но неработоспособный объект без внутренних slots.`]}),`
+`,(0,c.jsx)(t.p,{children:`Для таких типов используйте специализированный способ копирования или явно преобразуйте значение в data-only representation.`}),`
+`,(0,c.jsxs)(t.h3,{id:`ограничение-повторных-date-и-regexp`,children:[`Ограничение повторных `,(0,c.jsx)(t.code,{children:`Date`}),` и `,(0,c.jsx)(t.code,{children:`RegExp`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Сами containers участвуют в восстановлении повторных ссылок и cycles. `,(0,c.jsx)(t.code,{children:`Date`}),` и `,(0,c.jsx)(t.code,{children:`RegExp`}),` копируются как отдельные значения до регистрации в таблице ссылок. Если один и тот же экземпляр `,(0,c.jsx)(t.code,{children:`Date`}),`/`,(0,c.jsx)(t.code,{children:`RegExp`}),` находится в нескольких полях, каждое поле может получить отдельную эквивалентную копию.`]}),`
+`,(0,c.jsx)(t.h2,{id:`clone-не-является-normalize`,children:`Clone не является normalize`}),`
+`,(0,c.jsx)(t.p,{children:`Обе функции клонирования создают независимую структуру и удаляют функции. Они не должны использоваться как скрытая нормализация пользовательского draft.`}),`
+`,(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:`""`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`явный `,(0,c.jsx)(t.code,{children:`false`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`пустые массивы и объекты;`}),`
+`,(0,c.jsx)(t.li,{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:`const draft = {
+	title: "Новая группа ",
+	visible: false,
+	tags: ["A", "A", ""],
+	columns: []
+};
+
+const copy = deepCopyWithoutFunctions(draft);
+
+console.log(copy);
+// {
+//   title: "Новая группа ",
+//   visible: false,
+//   tags: ["A", "A", ""],
+//   columns: []
+// }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если приложению нужна canonical save-форма, выполняйте отдельный явно названный `,(0,c.jsx)(t.code,{children:`normalize...`}),` на границе сохранения или восстановления:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`пользовательский ввод
+        │
+        ▼
+literal draft ── clone ──► literal draft copy
+        │
+        │ только команда save
+        ▼
+normalizeForSave(draft) ──► canonical snapshot
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не записывайте нормализованный snapshot обратно в редактируемый draft без отдельного пользовательского действия.`}),`
+`,(0,c.jsx)(t.h2,{id:`stablestringify`,children:(0,c.jsx)(t.code,{children:`stableStringify`})}),`
+`,(0,c.jsx)(t.h3,{id:`назначение-3`,children:`Назначение`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`stableStringify`}),` вызывает JSON-сериализацию, но перед этим сортирует string-ключи каждого объекта по алфавиту. Поэтому одинаковые JSON-compatible структуры дают одинаковую строку независимо от порядка добавления полей.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { stableStringify } from "@ryuzaki13/react-foundation-lib/utils";
+
+const first = { b: 2, a: { d: 4, c: 3 } };
+const second = { a: { c: 3, d: 4 }, b: 2 };
+
+console.log(stableStringify(first));
+// '{"a":{"c":3,"d":4},"b":2}'
+
+console.log(stableStringify(first) === stableStringify(second));
+// true.
+`})}),`
+`,(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:`Вложенные объекты обрабатываются рекурсивно.`}),`
+`,(0,c.jsx)(t.li,{children:`Порядок элементов массивов сохраняется.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`Date`}),` сериализуется стандартным JSON-механизмом в ISO-строку.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stableStringify({ list: [{ z: 1, a: 2 }], order: ["B", "A"] });
+// '{"list":[{"a":2,"z":1}],"order":["B","A"]}'
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`когда-использовать`,children:`Когда использовать`}),`
+`,(0,c.jsx)(t.p,{children:`Подходящие сценарии:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`стабильная часть cache/query key, если структура полностью JSON-compatible;`}),`
+`,(0,c.jsx)(t.li,{children:`сравнение двух небольших data-only snapshots;`}),`
+`,(0,c.jsx)(t.li,{children:`обнаружение изменения serializable form state;`}),`
+`,(0,c.jsx)(t.li,{children:`стабильный ключ memoization на доверенных данных.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для TanStack Query сначала предпочитайте структурный query key-массив. `,(0,c.jsx)(t.code,{children:`stableStringify`}),` нужен только там, где consumer действительно требует строку.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ограничения-стандартного-json`,children:`Ограничения стандартного JSON`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция наследует семантику `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),`:`]}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Значение`}),(0,c.jsx)(t.th,{children:`Результат`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`undefined`}),`, function, symbol в object`]}),(0,c.jsx)(t.td,{children:`свойство пропускается`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`undefined`}),`, function, symbol в array`]}),(0,c.jsxs)(t.td,{children:[`элемент становится `,(0,c.jsx)(t.code,{children:`null`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`NaN`}),`, `,(0,c.jsx)(t.code,{children:`Infinity`}),`, `,(0,c.jsx)(t.code,{children:`-Infinity`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Date`})}),(0,c.jsx)(t.td,{children:`ISO-строка`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`Map`}),`, `,(0,c.jsx)(t.code,{children:`Set`}),` без enumerable string fields`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`{}`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`bigint`})}),(0,c.jsxs)(t.td,{children:[`выбрасывается `,(0,c.jsx)(t.code,{children:`TypeError`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`circular reference`}),(0,c.jsxs)(t.td,{children:[`выбрасывается `,(0,c.jsx)(t.code,{children:`TypeError`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`object с `,(0,c.jsx)(t.code,{children:`toJSON`})]}),(0,c.jsxs)(t.td,{children:[`вызывается `,(0,c.jsx)(t.code,{children:`toJSON`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`getter enumerable-свойства`}),(0,c.jsx)(t.td,{children:`getter может быть вызван`})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`Из-за этих правил разные JavaScript-значения иногда дают одинаковую строку:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`stableStringify({ value: undefined }); // "{}".
+stableStringify({}); // "{}".
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте строку как доказательство полной идентичности произвольных объектов.`}),`
+`,(0,c.jsxs)(t.h3,{id:`корневое-undefined`,children:[`Корневое `,(0,c.jsx)(t.code,{children:`undefined`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Публичная TypeScript-сигнатура указывает `,(0,c.jsx)(t.code,{children:`string`}),`, но стандартный `,(0,c.jsx)(t.code,{children:`JSON.stringify`}),` возвращает runtime `,(0,c.jsx)(t.code,{children:`undefined`}),` для корневых `,(0,c.jsx)(t.code,{children:`undefined`}),`, function и symbol.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = stableStringify(undefined);
+console.log(result); // undefined во время выполнения.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте JSON-compatible top-level value: объект, массив, строку, число, `,(0,c.jsx)(t.code,{children:`boolean`}),` или `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`не-security-canonicalization`,children:`Не security canonicalization`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`stableStringify`}),` не является криптографической canonical JSON-реализацией. Не используйте его напрямую для цифровых подписей, security tokens, authorization или сериализации недоверенного объекта с getters/`,(0,c.jsx)(t.code,{children:`toJSON`}),`.`]}),`
+`,(0,c.jsxs)(t.h2,{id:`tobase64-и-encodebase64`,children:[(0,c.jsx)(t.code,{children:`toBase64`}),` и `,(0,c.jsx)(t.code,{children:`encodeBase64`})]}),`
+`,(0,c.jsx)(t.h3,{id:`назначение-4`,children:`Назначение`}),`
+`,(0,c.jsx)(t.p,{children:`Обе функции кодируют JavaScript-строку в UTF-8-байты, а затем в стандартный Base64:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { toBase64 } from "@ryuzaki13/react-foundation-lib/utils";
+
+const value = toBase64("Привет");
+console.log(value); // 0J/RgNC40LLQtdGC
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`В отличие от прямого `,(0,c.jsx)(t.code,{children:`btoa("Привет")`}),`, Unicode-текст не теряется.`]}),`
+`,(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:`API`}),(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:`toBase64`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`TextEncoder`}),`, затем `,(0,c.jsx)(t.code,{children:`btoa`})]}),(0,c.jsx)(t.td,{children:`Предпочитать для нового browser-кода`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`encodeBase64`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`encodeURIComponent`}),`, percent bytes, затем `,(0,c.jsx)(t.code,{children:`btoa`})]}),(0,c.jsx)(t.td,{children:`Использовать для существующего совместимого кода`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для одиночного некорректного UTF-16 surrogate поведение различается: `,(0,c.jsx)(t.code,{children:`TextEncoder`}),` заменяет его replacement character, а `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),` может выбросить `,(0,c.jsx)(t.code,{children:`URIError`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`декодирование`,children:`Декодирование`}),`
+`,(0,c.jsx)(t.p,{children:`Модуль не экспортирует decoder. В браузере UTF-8 Base64 можно декодировать так:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function decodeBase64(value: string): string {
+	const binary = atob(value);
+	const bytes = Uint8Array.from(binary, (character) => character.charCodeAt(0));
+
+	return new TextDecoder().decode(bytes);
+}
+
+const original = decodeBase64(toBase64("Привет"));
+console.log(original); // "Привет".
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`важные-ограничения`,children:`Важные ограничения`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Результат — обычный Base64 с символами `,(0,c.jsx)(t.code,{children:`+`}),`, `,(0,c.jsx)(t.code,{children:`/`}),` и padding `,(0,c.jsx)(t.code,{children:`=`}),`; это не Base64URL.`]}),`
+`,(0,c.jsx)(t.li,{children:`Base64 не шифрует и не скрывает содержимое.`}),`
+`,(0,c.jsx)(t.li,{children:`Размер строки обычно увеличивается примерно на треть относительно количества байтов.`}),`
+`,(0,c.jsxs)(t.li,{children:[`API предназначен для текста, а не для произвольного `,(0,c.jsx)(t.code,{children:`Blob`}),`/`,(0,c.jsx)(t.code,{children:`ArrayBuffer`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`toBase64("")`}),` и `,(0,c.jsx)(t.code,{children:`encodeBase64("")`}),` возвращают пустую строку.`]}),`
+`,(0,c.jsx)(t.li,{children:`Для работы нужны соответствующие global browser APIs.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужно преобразовать Base64/binary payload в `,(0,c.jsx)(t.code,{children:`Blob`}),`, используйте `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/binary`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`клавиатурная-активация`,children:`Клавиатурная активация`}),`
+`,(0,c.jsx)(t.h3,{id:`keyboardactivationkeys`,children:(0,c.jsx)(t.code,{children:`keyboardActivationKeys`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Readonly tuple содержит точные значения `,(0,c.jsx)(t.code,{children:`KeyboardEvent.key`}),`, которые активируют элемент с поведением кнопки:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { keyboardActivationKeys } from "@ryuzaki13/react-foundation-lib/utils";
+
+console.log(keyboardActivationKeys); // ["Enter", " "].
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Пробел представлен строкой из одного символа `,(0,c.jsx)(t.code,{children:`" "`}),`, а не словами `,(0,c.jsx)(t.code,{children:`"Space"`}),` или `,(0,c.jsx)(t.code,{children:`"Spacebar"`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Тип:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type KeyboardActivationKey = "Enter" | " ";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`iskeyboardactivationkey`,children:(0,c.jsx)(t.code,{children:`isKeyboardActivationKey`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция возвращает type guard:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function onKey(key: string) {
+	if (isKeyboardActivationKey(key)) {
+		// Здесь TypeScript знает: key — "Enter" | " ".
+	}
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Точные результаты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`isKeyboardActivationKey("Enter"); // true.
+isKeyboardActivationKey(" "); // true.
+isKeyboardActivationKey("Spacebar"); // false.
+isKeyboardActivationKey("Escape"); // false.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`handlekeyboardactivation`,children:(0,c.jsx)(t.code,{children:`handleKeyboardActivation`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция объединяет проверку клавиши, `,(0,c.jsx)(t.code,{children:`preventDefault()`}),` и вызов действия:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { handleKeyboardActivation } from "@ryuzaki13/react-foundation-lib/utils";
+
+type CustomButtonProps = {
+	disabled?: boolean;
+	onActivate: () => void;
+};
+
+export function CustomButton({ disabled = false, onActivate }: CustomButtonProps) {
+	return (
+		<div
+			aria-disabled={disabled || undefined}
+			onClick={disabled ? undefined : onActivate}
+			onKeyDown={(event) => {
+				handleKeyboardActivation(event, onActivate, { disabled });
+			}}
+			role="button"
+			tabIndex={disabled ? -1 : 0}>
+			Открыть
+		</div>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Алгоритм:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Если `,(0,c.jsx)(t.code,{children:`disabled === true`}),`, возвращает `,(0,c.jsx)(t.code,{children:`false`}),` и ничего не делает.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если клавиша не `,(0,c.jsx)(t.code,{children:`Enter`}),` и не пробел, возвращает `,(0,c.jsx)(t.code,{children:`false`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Вызывает `,(0,c.jsx)(t.code,{children:`event.preventDefault()`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Синхронно вызывает `,(0,c.jsx)(t.code,{children:`action()`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Возвращает `,(0,c.jsx)(t.code,{children:`true`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Исключение из `,(0,c.jsx)(t.code,{children:`action`}),` не перехватывается.`]}),`
+`,(0,c.jsxs)(t.blockquote,{children:[`
+`,(0,c.jsxs)(t.p,{children:[`Для обычного `,(0,c.jsx)(t.code,{children:`<button>`}),` используйте нативное поведение браузера и `,(0,c.jsx)(t.code,{children:`onClick`}),`. Helper предназначен для обоснованных кастомных controls. Добавление собственного Enter/Space handler к `,(0,c.jsx)(t.code,{children:`<button>`}),` может привести к двойной активации.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper не добавляет `,(0,c.jsx)(t.code,{children:`role`}),`, `,(0,c.jsx)(t.code,{children:`tabIndex`}),`, ARIA-состояния и обработчик click автоматически. Доступность всего компонента остаётся ответственностью host.`]}),`
+`,(0,c.jsx)(t.h2,{id:`roving-focus`,children:`Roving focus`}),`
+`,(0,c.jsx)(t.h3,{id:`что-это-такое`,children:`Что это такое`}),`
+`,(0,c.jsxs)(t.p,{children:[`Roving focus — паттерн для составного control (`,(0,c.jsx)(t.code,{children:`Tabs`}),`, `,(0,c.jsx)(t.code,{children:`RadioGroup`}),`, toolbar): только один элемент имеет `,(0,c.jsx)(t.code,{children:`tabIndex={0}`}),`, остальные `,(0,c.jsx)(t.code,{children:`tabIndex={-1}`}),`. Arrow/Home/End меняют активный индекс, после чего host переводит DOM-фокус.`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`}),` только вычисляет индекс. Функция не хранит state и не вызывает `,(0,c.jsx)(t.code,{children:`.focus()`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`сигнатура-1`,children:`Сигнатура`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`interface RovingFocusTargetOptions {
+	currentIndex: number;
+	itemCount: number;
+	key: string;
+	orientation: "horizontal" | "vertical";
+	wrap?: boolean;
+}
+
+function getRovingFocusTargetIndex(options: RovingFocusTargetOptions): number | null;
+`})}),`
+`,(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:`Orientation`}),(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:`horizontal`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ArrowLeft`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ArrowRight`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Home`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`End`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`vertical`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ArrowUp`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ArrowDown`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Home`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`End`})})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Home`}),` и `,(0,c.jsx)(t.code,{children:`End`}),` работают в обеих ориентациях.`]}),`
+`,(0,c.jsx)(t.h3,{id:`пример-расчёта`,children:`Пример расчёта`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const target = getRovingFocusTargetIndex({
+	currentIndex: 1,
+	itemCount: 4,
+	key: "ArrowRight",
+	orientation: "horizontal"
+});
+
+console.log(target); // 2.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`wrap`}),` по умолчанию равен `,(0,c.jsx)(t.code,{children:`true`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getRovingFocusTargetIndex({
+	currentIndex: 3,
+	itemCount: 4,
+	key: "ArrowRight",
+	orientation: "horizontal"
+});
+// 0: переход с конца в начало.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`При `,(0,c.jsx)(t.code,{children:`wrap: false`}),` на границе возвращается текущая крайняя позиция:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`getRovingFocusTargetIndex({
+	currentIndex: 3,
+	itemCount: 4,
+	key: "ArrowRight",
+	orientation: "horizontal",
+	wrap: false
+});
+// 3.
+`})}),`
+`,(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:`itemCount <= 0`}),` возвращает `,(0,c.jsx)(t.code,{children:`null`}),`.`]}),`
+`,(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:`currentIndex`}),` меньше `,(0,c.jsx)(t.code,{children:`0`}),` при положительном `,(0,c.jsx)(t.code,{children:`itemCount`}),` прижимается к `,(0,c.jsx)(t.code,{children:`0`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`currentIndex`}),` больше последнего индекса прижимается к последнему индексу.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Передавайте целые конечные `,(0,c.jsx)(t.code,{children:`currentIndex`}),` и `,(0,c.jsx)(t.code,{children:`itemCount`}),`; функция не является validator для `,(0,c.jsx)(t.code,{children:`NaN`}),` и дробей.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`react-применение`,children:`React-применение`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const targetIndex = getRovingFocusTargetIndex({
+	currentIndex: activeIndex,
+	itemCount: tabs.length,
+	key: event.key,
+	orientation: "horizontal"
+});
+
+if (targetIndex !== null) {
+	event.preventDefault();
+	setActiveIndex(targetIndex);
+	tabRefs.current[targetIndex]?.focus();
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если в группе есть disabled-элементы, одного `,(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`}),` недостаточно: используйте select-navigation helpers или дополнительный поиск enabled-индекса.`]}),`
+`,(0,c.jsx)(t.h2,{id:`навигация-по-доступным-опциям`,children:`Навигация по доступным опциям`}),`
+`,(0,c.jsx)(t.p,{children:`Эти функции работают с обычным readonly-массивом и callback, который отвечает на вопрос «эта опция disabled?».`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Option = {
+	id: string;
+	label: string;
+	disabled?: boolean;
+};
+
+const options: Option[] = [
+	{ id: "A", label: "Первая" },
+	{ id: "B", label: "Вторая", disabled: true },
+	{ id: "C", label: "Третья" }
+];
+
+const getDisabled = (option: Option) => option.disabled === true;
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`findfirstenabledindex`,children:(0,c.jsx)(t.code,{children:`findFirstEnabledIndex`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает индекс первой enabled-опции или `,(0,c.jsx)(t.code,{children:`-1`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`findFirstEnabledIndex(options, getDisabled); // 0.
+findFirstEnabledIndex([], getDisabled); // -1.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если callback не передан, все элементы считаются enabled.`}),`
+`,(0,c.jsx)(t.h3,{id:`findlastenabledindex`,children:(0,c.jsx)(t.code,{children:`findLastEnabledIndex`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Возвращает индекс последней enabled-опции или `,(0,c.jsx)(t.code,{children:`-1`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`findLastEnabledIndex(options, getDisabled); // 2.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для пустого списка или списка, где все элементы disabled, возвращается `,(0,c.jsx)(t.code,{children:`-1`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`findnextenabledindex`,children:(0,c.jsx)(t.code,{children:`findNextEnabledIndex`})}),`
+`,(0,c.jsx)(t.p,{children:`Ищет enabled-опцию после текущей позиции:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`findNextEnabledIndex(options, 0, 1, getDisabled);
+// 2: движение вперёд, disabled индекс 1 пропущен.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Аргументы:`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{style:{textAlign:`right`},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,{style:{textAlign:`right`},children:`1`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`options`})}),(0,c.jsx)(t.td,{children:`readonly-массив опций`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`currentIndex`})}),(0,c.jsxs)(t.td,{children:[`текущий индекс; для отсутствующей позиции обычно `,(0,c.jsx)(t.code,{children:`-1`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`3`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`step`})}),(0,c.jsxs)(t.td,{children:[`только `,(0,c.jsx)(t.code,{children:`1`}),` вперёд или `,(0,c.jsx)(t.code,{children:`-1`}),` назад`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`4`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getOptionDisabled`})}),(0,c.jsx)(t.td,{children:`callback; truthy означает disabled`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`5`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`optionsConfig`})}),(0,c.jsxs)(t.td,{children:[`объект `,(0,c.jsx)(t.code,{children:`{ wrap?: boolean }`}),`; default `,(0,c.jsx)(t.code,{children:`wrap`}),` — `,(0,c.jsx)(t.code,{children:`false`})]})]})]})]}),`
+`,(0,c.jsx)(t.p,{children:`С циклическим переходом:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`findNextEnabledIndex(options, 2, 1, getDisabled, { wrap: true });
+// 0: после конца поиск продолжается с начала.
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если следующей опции нет и `,(0,c.jsx)(t.code,{children:`wrap === false`}),`, возвращается текущий валидный индекс. Если текущий индекс не входит в массив, возвращается `,(0,c.jsx)(t.code,{children:`-1`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`findNextEnabledIndex(options, 2, 1, getDisabled); // 2.
+findNextEnabledIndex(options, -1, -1, getDisabled); // -1.
+`})}),`
+`,(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:`currentIndex`}),` в диапазоне `,(0,c.jsx)(t.code,{children:`-1..options.length - 1`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Callback должен уметь работать с каждым элементом списка и не должен менять массив.`}),`
+`,(0,c.jsx)(t.li,{children:`Если текущая опция сама disabled и другого кандидата нет, fallback всё равно может вернуть текущий индекс.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Функции не пропускают `,(0,c.jsx)(t.code,{children:`hidden`}),`, `,(0,c.jsx)(t.code,{children:`aria-disabled`}),` или другие признаки автоматически — это решает callback.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`wrap`}),` у `,(0,c.jsx)(t.code,{children:`findNextEnabledIndex`}),` по умолчанию `,(0,c.jsx)(t.code,{children:`false`}),`, а у `,(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`}),` — `,(0,c.jsx)(t.code,{children:`true`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`createlazycomponent`,children:(0,c.jsx)(t.code,{children:`createLazyComponent`})}),`
+`,(0,c.jsx)(t.h3,{id:`назначение-5`,children:`Назначение`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createLazyComponent`}),` создаёт `,(0,c.jsx)(t.code,{children:`React.lazy`}),` component для именованного export и кеширует созданную lazy-обёртку.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { Suspense } from "react";
+import { createLazyComponent } from "@ryuzaki13/react-foundation-lib/utils";
+
+type ProfileCardProps = {
+	userId: string;
+};
+
+const LazyProfileCard = createLazyComponent<ProfileCardProps>(() => import("./ProfileCard"), "ProfileCard", "profile-card");
+
+export function ProfilePage() {
+	return (
+		<Suspense fallback={<p>Загрузка профиля…</p>}>
+			<LazyProfileCard userId="U-1" />
+		</Suspense>
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Ожидаемый модуль:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`export function ProfileCard({ userId }: ProfileCardProps) {
+	return <article>Пользователь {userId}</article>;
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`когда-начинается-загрузка`,children:`Когда начинается загрузка`}),`
+`,(0,c.jsxs)(t.p,{children:[`Вызов `,(0,c.jsx)(t.code,{children:`createLazyComponent(...)`}),` не вызывает dynamic import. Importer запускается при первом React-рендере lazy component.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`создание LazyProfileCard
+          │
+          │ importer ещё не вызван
+          ▼
+первый render <LazyProfileCard />
+          │
+          ▼
+    import("./ProfileCard")
+          │
+          ├─ pending ──► ближайший Suspense fallback
+          │
+          ├─ fulfilled ─► component render
+          │
+          └─ rejected ──► ближайший Error Boundary
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Оборачивайте использование в `,(0,c.jsx)(t.code,{children:`<Suspense>`}),`. Для ошибок сети, отсутствующего chunk или неверного export предусмотрите Error Boundary на подходящем уровне приложения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`поиск-export`,children:`Поиск export`}),`
+`,(0,c.jsxs)(t.p,{children:[`Параметр `,(0,c.jsx)(t.code,{children:`componentName`}),` — имя свойства module object. Алгоритм:`]}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Если `,(0,c.jsx)(t.code,{children:`module[componentName]`}),` существует, выбирается оно.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Иначе выбирается `,(0,c.jsx)(t.code,{children:`module.default`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Если default нет, выбирается первое значение `,(0,c.jsx)(t.code,{children:`Object.values(module)`}),`.`]}),`
+`,(0,c.jsx)(t.li,{children:`Если модуль отсутствует или выбранное значение не является функцией, lazy render завершается ошибкой.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это fallback-поведение означает, что опечатка в `,(0,c.jsx)(t.code,{children:`componentName`}),` не всегда обнаружится: функция может молча выбрать default или первый export. Передавайте точное имя и покрывайте lazy boundary тестом.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`React-компонент должен быть function/class component. Export, созданный как объект `,(0,c.jsx)(t.code,{children:`memo(...)`}),` или `,(0,c.jsx)(t.code,{children:`forwardRef(...)`}),`, может не пройти runtime-проверку `,(0,c.jsx)(t.code,{children:`typeof component === "function"`}),` и не является гарантированно поддержанным значением этого helper.`]}),`
+`,(0,c.jsx)(t.h3,{id:`кеш-по-importer`,children:`Кеш по importer`}),`
+`,(0,c.jsxs)(t.p,{children:[`Без `,(0,c.jsx)(t.code,{children:`cacheKey`}),` результат кешируется по идентичности функции-importer и `,(0,c.jsx)(t.code,{children:`componentName`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const importProfile = () => import("./ProfileCard");
+
+const first = createLazyComponent(importProfile, "ProfileCard");
+const second = createLazyComponent(importProfile, "ProfileCard");
+
+console.log(first === second); // true.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Две синтаксически одинаковые, но отдельно созданные arrow-функции имеют разные ссылки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = createLazyComponent(() => import("./ProfileCard"), "ProfileCard");
+const second = createLazyComponent(() => import("./ProfileCard"), "ProfileCard");
+
+console.log(first === second); // false.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Обычно объявляйте lazy component на уровне модуля, а не внутри React render.`}),`
+`,(0,c.jsxs)(t.h3,{id:`глобальный-строковый-cachekey`,children:[`Глобальный строковый `,(0,c.jsx)(t.code,{children:`cacheKey`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Третий аргумент создаёт ключ `,(0,c.jsx)(t.code,{children:"${cacheKey}:${componentName}"}),`. Он позволяет разным importer-функциям получить одну lazy-обёртку:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`createLazyComponent(firstImporter, "ProfileCard", "profile");
+createLazyComponent(secondImporter, "ProfileCard", "profile");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Второй вызов вернёт ранее созданный результат и фактически будет использовать importer первого вызова. Поэтому `,(0,c.jsx)(t.code,{children:`cacheKey`}),` должен быть глобально уникальным и стабильным. Коллизия может загрузить не тот модуль или создать несоответствие TypeScript props и runtime-компонента.`]}),`
+`,(0,c.jsx)(t.p,{children:`Публичного API для очистки module-level cache нет.`}),`
+`,(0,c.jsx)(t.h3,{id:`ошибки`,children:`Ошибки`}),`
+`,(0,c.jsx)(t.p,{children:`Возможные сообщения helper:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-text`,children:`Component not found or invalid in module: ProfileCard
+Could not lazy-load component "ProfileCard"
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Ошибка возникает во время lazy render, а не обязательно в момент вызова `,(0,c.jsx)(t.code,{children:`createLazyComponent`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`childrencount`,children:(0,c.jsx)(t.code,{children:`childrenCount`})}),`
+`,(0,c.jsx)(t.h3,{id:`назначение-6`,children:`Назначение`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`childrenCount`}),` считает React children как плоский список и рекурсивно раскрывает только React fragments.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`import { Fragment } from "react";
+import { childrenCount } from "@ryuzaki13/react-foundation-lib/utils";
+
+const count = childrenCount(
+	<>
+		<span>Первый</span>
+		<Fragment>
+			<span>Второй</span>
+			<span>Третий</span>
+		</Fragment>
+		{null}
+	</>
+);
+
+console.log(count); // 3.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`что-именно-считается`,children:`Что именно считается`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`Массивы children обрабатываются стандартным `,(0,c.jsx)(t.code,{children:`React.Children.toArray`}),`.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`, `,(0,c.jsx)(t.code,{children:`undefined`}),` и boolean placeholders не добавляют видимого child в полученный массив.`]}),`
+`,(0,c.jsx)(t.li,{children:`Fragment не считается отдельным child: функция рекурсивно считает его содержимое.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Обычный React element считается как `,(0,c.jsx)(t.code,{children:`1`}),` независимо от количества его внутренних descendants.`]}),`
+`,(0,c.jsx)(t.li,{children:`Строковый/числовой React child считается как один элемент.`}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`childrenCount(
+	<section>
+		<span>A</span>
+		<span>B</span>
+	</section>
+);
+// 1: section — один переданный child; его DOM-потомки не раскрываются.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция не рендерит дерево, не обращается к DOM и может использоваться при SSR.`}),`
+`,(0,c.jsxs)(t.h2,{id:`deepcopynodes-и-deepcopytree`,children:[(0,c.jsx)(t.code,{children:`deepCopyNodes`}),` и `,(0,c.jsx)(t.code,{children:`deepCopyTree`})]}),`
+`,(0,c.jsx)(t.p,{children:`Эти функции копируют структуру дерева: создают новые objects-узлы и новые arrays дочерних узлов. Другие произвольные вложенные поля копируются поверхностно.`}),`
+`,(0,c.jsx)(t.h3,{id:`deepcopynodes`,children:(0,c.jsx)(t.code,{children:`deepCopyNodes`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте для дерева с фиксированным полем `,(0,c.jsx)(t.code,{children:`children`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const metadata = { color: "blue" };
+const source = [
+	{
+		id: "root",
+		metadata,
+		children: [{ id: "child", metadata }]
+	}
+];
+
+const copy = deepCopyNodes(source);
+
+console.log(copy !== source); // true.
+console.log(copy[0] !== source[0]); // true.
+console.log(copy[0].children !== source[0].children); // true.
+console.log(copy[0].metadata === source[0].metadata); // true: поле shallow.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`deepcopytree`,children:(0,c.jsx)(t.code,{children:`deepCopyTree`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте, если поле дочерних узлов называется иначе:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type MenuNode = {
+	id: string;
+	items?: MenuNode[];
+};
+
+const source: MenuNode[] = [{ id: "root", items: [{ id: "child" }] }];
+
+const copy = deepCopyTree(source, "items");
+
+console.log(copy[0].items !== source[0].items); // true.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если значение выбранного поля не является массивом, оно не обходится рекурсивно и остаётся частью поверхностной копии.`}),`
+`,(0,c.jsx)(t.h3,{id:`ограничения-tree-copy`,children:`Ограничения tree copy`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`Входной массив не изменяется.`}),`
+`,(0,c.jsx)(t.li,{children:`Все посещённые nodes и child arrays получают новые ссылки.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Остальные nested objects, functions, `,(0,c.jsx)(t.code,{children:`Date`}),`, `,(0,c.jsx)(t.code,{children:`Map`}),` и т. п. сохраняют исходные ссылки.`]}),`
+`,(0,c.jsx)(t.li,{children:`Циклическое дерево не поддерживается и приведёт к бесконечной рекурсии/ошибке стека.`}),`
+`,(0,c.jsx)(t.li,{children:`Если один и тот же node встречается в двух ветвях, он будет скопирован дважды; identity sharing не сохраняется.`}),`
+`,(0,c.jsxs)(t.li,{children:[`Функции не проверяют уникальность `,(0,c.jsx)(t.code,{children:`id`}),`, корректность parent-child связей или максимальную глубину.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для полного data-only clone всей конфигурации используйте `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),`. Для построения таблицы-дерева из `,(0,c.jsx)(t.code,{children:`id`}),`/`,(0,c.jsx)(t.code,{children:`parentId`}),` используйте `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/tree-table`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`logerror`,children:(0,c.jsx)(t.code,{children:`logError`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`logError`}),` передаёт все аргументы в `,(0,c.jsx)(t.code,{children:`globalThis.console.error`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { logError } from "@ryuzaki13/react-foundation-lib/utils";
+
+try {
+	await saveReport();
+} catch (error) {
+	logError("Не удалось сохранить отчёт", error);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function logError(...args: unknown[]): void;
+`})}),`
+`,(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.jsxs)(t.li,{children:[`не преобразует `,(0,c.jsx)(t.code,{children:`unknown`}),` в безопасный report;`]}),`
+`,(0,c.jsx)(t.li,{children:`не отправляет ошибку на сервер;`}),`
+`,(0,c.jsx)(t.li,{children:`не подавляет исключения;`}),`
+`,(0,c.jsx)(t.li,{children:`не выполняет retry.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не логируйте access tokens, passwords, cookies, полные персональные payloads и другие секреты. Для централизованного сбора и sanitization используйте `,(0,c.jsx)(t.code,{children:`error-report`}),` и его transport.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ssr-browser-и-react-границы`,children:`SSR, browser и React-границы`}),`
+`,(0,c.jsx)(t.h3,{id:`безопасно-на-сервере`,children:`Безопасно на сервере`}),`
+`,(0,c.jsxs)(t.p,{children:[`Следующие функции не читают `,(0,c.jsx)(t.code,{children:`window`}),` или DOM:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cn`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`обе clone-функции;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`stableStringify`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`keyboard и select navigation;`}),`
+`,(0,c.jsx)(t.li,{children:`tree copy;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`childrenCount`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`создание lazy component;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`logError`}),`, если runtime предоставляет console.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`требуют-globals`,children:`Требуют globals`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`toBase64`}),` требует `,(0,c.jsx)(t.code,{children:`TextEncoder`}),` и `,(0,c.jsx)(t.code,{children:`btoa`}),`, `,(0,c.jsx)(t.code,{children:`encodeBase64`}),` — `,(0,c.jsx)(t.code,{children:`btoa`}),`. Не вызывайте их без проверки в старом/нестандартном server runtime.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const canEncode = typeof TextEncoder !== "undefined" && typeof btoa === "function";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`reactlazy-и-ssr`,children:`React.lazy и SSR`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`createLazyComponent`}),` не обращается к DOM, однако дальнейшее поведение зависит от React renderer/framework. Suspense и загрузку chunk на сервере настраивает host framework. Не предполагавайте, что обычный browser dynamic import автоматически настроит streaming SSR или preload.`]}),`
+`,(0,c.jsx)(t.h2,{id:`производительность`,children:`Производительность`}),`
+`,(0,c.jsx)(t.h3,{id:`clone-функции`,children:`Clone-функции`}),`
+`,(0,c.jsxs)(t.p,{children:[`Обе функции обходят весь поддерживаемый graph, то есть время и дополнительная память примерно линейны относительно количества посещённых элементов и свойств: `,(0,c.jsx)(t.code,{children:`O(n)`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Не клонируйте большой state на каждом React render. Клонирование обычно выполняют:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`при создании initial draft;`}),`
+`,(0,c.jsx)(t.li,{children:`при обработке явного изменения;`}),`
+`,(0,c.jsx)(t.li,{children:`при формировании save snapshot;`}),`
+`,(0,c.jsx)(t.li,{children:`на границе восстановления конфигурации.`}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`stablestringify-1`,children:(0,c.jsx)(t.code,{children:`stableStringify`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Объекты дополнительно сортируют ключи. Для объекта с `,(0,c.jsx)(t.code,{children:`k`}),` ключами сортировка стоит примерно `,(0,c.jsx)(t.code,{children:`O(k log k)`}),`. Не сериализуйте большой payload на каждом render без memoization.`]}),`
+`,(0,c.jsx)(t.h3,{id:`navigation-и-tree-helpers`,children:`Navigation и tree helpers`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`First/last/next navigation в худшем случае просматривает `,(0,c.jsx)(t.code,{children:`O(n)`}),` опций.`]}),`
+`,(0,c.jsx)(t.li,{children:`Tree copy посещает каждый node один раз, но глубокое дерево может исчерпать call stack.`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`childrenCount`}),` посещает переданные React children и fragments.`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`cn`}),` линейно проходит аргументы и ключи conditional objects.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`lazy-cache`,children:`Lazy cache`}),`
+`,(0,c.jsxs)(t.p,{children:[`Кеш `,(0,c.jsx)(t.code,{children:`createLazyComponent`}),` живёт на уровне загруженного модуля библиотеки. Строковые `,(0,c.jsx)(t.code,{children:`cacheKey`}),` удерживаются до выгрузки module runtime; не создавайте бесконечное количество динамических ключей из user input.`]}),`
+`,(0,c.jsx)(t.h2,{id:`тестирование-consumer-кода`,children:`Тестирование consumer-кода`}),`
+`,(0,c.jsx)(t.h3,{id:`cn`,children:(0,c.jsx)(t.code,{children:`cn`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { expect, it } from "vitest";
+import { cn } from "@ryuzaki13/react-foundation-lib/utils";
+
+it("добавляет active-класс", () => {
+	expect(cn("button", { active: true, disabled: false })).toBe("button active");
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`literal-draft-и-clone`,children:`Literal draft и clone`}),`
+`,(0,c.jsx)(t.p,{children:`Проверяйте отдельно неизменность пользовательского draft и форму save snapshot:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`it("сохраняет literal draft при клонировании", () => {
+	const draft = {
+		title: "Новая группа ",
+		visible: false,
+		tags: ["A", "A", ""]
+	};
+
+	const copy = deepCopyWithoutFunctions(draft);
+
+	expect(copy).toEqual(draft);
+	expect(copy).not.toBe(draft);
+	expect(copy.tags).not.toBe(draft.tags);
+});
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для cycles проверяйте связь с clone, а не только deep equality:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(copy.self).toBe(copy);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`keyboard`,children:`Keyboard`}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверяйте три результата: return value, `,(0,c.jsx)(t.code,{children:`preventDefault`}),` и действие.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const preventDefault = vi.fn();
+const action = vi.fn();
+
+expect(handleKeyboardActivation({ key: "Enter", preventDefault }, action)).toBe(true);
+expect(preventDefault).toHaveBeenCalledOnce();
+expect(action).toHaveBeenCalledOnce();
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Отдельно проверьте `,(0,c.jsx)(t.code,{children:`disabled`}),` и необрабатываемую клавишу.`]}),`
+`,(0,c.jsx)(t.h3,{id:`lazy-component`,children:`Lazy component`}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте DOM-окружение теста, `,(0,c.jsx)(t.code,{children:`<Suspense>`}),` и дождитесь разрешения Promise. Проверяйте:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`видимость fallback во время ожидания, если это важно для UX;`}),`
+`,(0,c.jsx)(t.li,{children:`успешный named export;`}),`
+`,(0,c.jsx)(t.li,{children:`ошибку загрузки через Error Boundary;`}),`
+`,(0,c.jsx)(t.li,{children:`props загруженного компонента;`}),`
+`,(0,c.jsx)(t.li,{children:`отсутствие повторной загрузки при повторном render.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не делайте тест зависимым от кеша, оставленного другим тестом: используйте уникальные importer-функции и уникальные `,(0,c.jsx)(t.code,{children:`cacheKey`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`base64`,children:`Base64`}),`
+`,(0,c.jsx)(t.p,{children:`Сравнивайте результат после UTF-8 decode, особенно для кириллицы и emoji:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`expect(decodeBase64(toBase64("Привет 👋"))).toBe("Привет 👋");
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`полный-api-справочник`,children:`Полный API-справочник`}),`
+`,(0,c.jsx)(t.h3,{id:`runtime-exports`,children:`Runtime exports`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Export`}),(0,c.jsx)(t.th,{children:`Параметры`}),(0,c.jsx)(t.th,{children:`Результат`}),(0,c.jsx)(t.th,{children:`Side effect / особенность`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`cn`})}),(0,c.jsx)(t.td,{children:`строки, boolean/nullish и conditional objects`}),(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:`classNames`})}),(0,c.jsxs)(t.td,{children:[`как у `,(0,c.jsx)(t.code,{children:`cn`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string`})}),(0,c.jsxs)(t.td,{children:[`deprecated-алиас `,(0,c.jsx)(t.code,{children:`cn`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`})}),(0,c.jsxs)(t.td,{children:[`значение, `,(0,c.jsx)(t.code,{children:`{ arrayFunctionStrategy? }`})]}),(0,c.jsx)(t.td,{children:`строгая глубокая копия`}),(0,c.jsxs)(t.td,{children:[`unsupported object бросает `,(0,c.jsx)(t.code,{children:`TypeError`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`})}),(0,c.jsxs)(t.td,{children:[`значение, `,(0,c.jsx)(t.code,{children:`{ arrayFunctionStrategy?, preservePrototype? }`})]}),(0,c.jsx)(t.td,{children:`расширенная глубокая копия`}),(0,c.jsx)(t.td,{children:`неподдержанные built-ins не гарантируются`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`stableStringify`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`unknown`})}),(0,c.jsx)(t.td,{children:`JSON string`}),(0,c.jsxs)(t.td,{children:[`может вызвать `,(0,c.jsx)(t.code,{children:`toJSON`}),`/getter или бросить JSON-ошибку`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`toBase64`})}),(0,c.jsx)(t.td,{children:`строка`}),(0,c.jsx)(t.td,{children:`Base64 string`}),(0,c.jsxs)(t.td,{children:[`использует `,(0,c.jsx)(t.code,{children:`TextEncoder`}),` и `,(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:`encodeBase64`})}),(0,c.jsx)(t.td,{children:`строка`}),(0,c.jsx)(t.td,{children:`Base64 string`}),(0,c.jsxs)(t.td,{children:[`использует `,(0,c.jsx)(t.code,{children:`encodeURIComponent`}),` и `,(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:`keyboardActivationKeys`})}),(0,c.jsx)(t.td,{children:`—`}),(0,c.jsxs)(t.td,{children:[`readonly `,(0,c.jsx)(t.code,{children:`["Enter", " "]`})]}),(0,c.jsx)(t.td,{children:`module constant`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`isKeyboardActivationKey`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`key: string`})}),(0,c.jsx)(t.td,{children:`type-guard 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:`handleKeyboardActivation`})}),(0,c.jsxs)(t.td,{children:[`event-like, action, `,(0,c.jsx)(t.code,{children:`{ disabled? }`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsxs)(t.td,{children:[`вызывает `,(0,c.jsx)(t.code,{children:`preventDefault`}),` и action при обработке`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`RovingFocusTargetOptions`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number | null`})}),(0,c.jsx)(t.td,{children:`только вычисляет индекс`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findFirstEnabledIndex`})}),(0,c.jsx)(t.td,{children:`options, optional disabled callback`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`number`}),`, `,(0,c.jsx)(t.code,{children:`-1`}),` если нет`]}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findLastEnabledIndex`})}),(0,c.jsx)(t.td,{children:`options, optional disabled callback`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`number`}),`, `,(0,c.jsx)(t.code,{children:`-1`}),` если нет`]}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findNextEnabledIndex`})}),(0,c.jsxs)(t.td,{children:[`options, current index, `,(0,c.jsx)(t.code,{children:`1 | -1`}),`, callback, `,(0,c.jsx)(t.code,{children:`{ wrap? }`})]}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`number`}),`, иногда `,(0,c.jsx)(t.code,{children:`-1`})]}),(0,c.jsx)(t.td,{children:`нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`createLazyComponent`})}),(0,c.jsx)(t.td,{children:`importer, component name, optional cache key`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`LazyExoticComponent`})}),(0,c.jsx)(t.td,{children:`кеш; import при первом render`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`childrenCount`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReactNode`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`number`})}),(0,c.jsx)(t.td,{children:`fragments раскрываются`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyNodes`})}),(0,c.jsxs)(t.td,{children:[`дерево с `,(0,c.jsx)(t.code,{children:`children`})]}),(0,c.jsx)(t.td,{children:`новое дерево`}),(0,c.jsx)(t.td,{children:`произвольные nested fields shallow`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyTree`})}),(0,c.jsx)(t.td,{children:`дерево, optional children field`}),(0,c.jsx)(t.td,{children:`новое дерево`}),(0,c.jsx)(t.td,{children:`произвольные nested fields shallow`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`logError`})}),(0,c.jsxs)(t.td,{children:[`любое количество `,(0,c.jsx)(t.code,{children:`unknown`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`void`})}),(0,c.jsxs)(t.td,{children:[`вызывает `,(0,c.jsx)(t.code,{children:`globalThis.console.error`})]})]})]})]}),`
+`,(0,c.jsx)(t.h3,{id:`публичные-типы`,children:`Публичные типы`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Тип`}),(0,c.jsx)(t.th,{children:`Значение`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ToggleClassName`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`Record<string, boolean | undefined>`}),` для conditional classes`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`PureClassName`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`string | boolean | undefined | null`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`KeyboardActivationKey`})}),(0,c.jsxs)(t.td,{children:[`union `,(0,c.jsx)(t.code,{children:`"Enter" | " "`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`RovingFocusTargetOptions`})}),(0,c.jsx)(t.td,{children:`current index, count, key, orientation и optional wrap`})]})]})]}),`
+`,(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:`API`}),(0,c.jsx)(t.th,{children:`Опция`}),(0,c.jsx)(t.th,{children:`Default`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayFunctionStrategy`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"omit"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayFunctionStrategy`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"undefined"`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCloneWithoutFunctions`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`preservePrototype`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`handleKeyboardActivation`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`disabled`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`wrap`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`true`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`findNextEnabledIndex`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`wrap`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`false`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`deepCopyTree`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`childrenField`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"children"`})})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`типичные-ошибки`,children:`Типичные ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`импорт-из-корня-пакета`,children:`Импорт из корня пакета`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неверно.
+import { cn } from "@ryuzaki13/react-foundation-lib";
+
+// Верно.
+import { cn } from "@ryuzaki13/react-foundation-lib/utils";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-одинакового-default-clone-массива`,children:`Ожидание одинакового default clone массива`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`deepCopyWithoutFunctions([1, () => 2, 3]);
+// [1, 3]
+
+deepCloneWithoutFunctions([1, () => 2, 3]);
+// [1, undefined, 3]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Всегда выбирайте функцию по контракту данных, а не по похожему названию.`}),`
+`,(0,c.jsx)(t.h3,{id:`использование-clone-как-normalize`,children:`Использование clone как normalize`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const copy = deepCopyWithoutFunctions(draft);
+
+// Ошибочное ожидание: clone не делает trim, dedupe и defaults.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Нормализация должна быть отдельной операцией на явно названной boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`передача-класса-в-строгий-config-clone`,children:`Передача класса в строгий config clone`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`deepCopyWithoutFunctions(new URL("https://example.com"));
+// TypeError.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сначала преобразуйте значение в поддерживаемую data-only форму.`}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-глубокого-clone-от-tree-helpers`,children:`Ожидание глубокого clone от tree helpers`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const copy = deepCopyNodes(source);
+copy[0].metadata.value = 2;
+// Если metadata — произвольный object, исходный metadata тоже изменится.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Tree helpers копируют структуру узлов, а не всё содержимое каждого поля.`}),`
+`,(0,c.jsx)(t.h3,{id:`использование-base64-как-защиты`,children:`Использование Base64 как защиты`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const visibleToAnyone = toBase64(accessToken);
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Base64 легко декодируется. Не храните секрет только потому, что строка стала нечитаемой визуально.`}),`
+`,(0,c.jsxs)(t.h3,{id:`cn-с-массивом`,children:[(0,c.jsx)(t.code,{children:`cn`}),` с массивом`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`cn(["button", "active"] as never); // Пустая строка.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Передавайте строки отдельными аргументами или conditional object.`}),`
+`,(0,c.jsxs)(t.h3,{id:`кастомная-keyboard-активация-на-button`,children:[`Кастомная keyboard-активация на `,(0,c.jsx)(t.code,{children:`<button>`})]}),`
+`,(0,c.jsx)(t.p,{children:`Нативная кнопка уже умеет Enter/Space. Дополнительный handler может вызвать действие дважды.`}),`
+`,(0,c.jsx)(t.h3,{id:`lazy-component-внутри-render`,children:`Lazy component внутри render`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`function Page() {
+	const LazyCard = createLazyComponent(() => import("./Card"), "Card");
+	return <LazyCard />;
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Importer-функция создаётся заново при каждом render, поэтому WeakMap cache не помогает. Объявляйте `,(0,c.jsx)(t.code,{children:`LazyCard`}),` на уровне модуля.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`коллизия-cachekey`,children:[`Коллизия `,(0,c.jsx)(t.code,{children:`cacheKey`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Один `,(0,c.jsx)(t.code,{children:`cacheKey + componentName`}),` для разных модулей возвращает первый закешированный компонент. Включайте в ключ стабильное имя модуля/сценария.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`stablestringify-для-map-cycles-или-bigint`,children:[(0,c.jsx)(t.code,{children:`stableStringify`}),` для `,(0,c.jsx)(t.code,{children:`Map`}),`, cycles или `,(0,c.jsx)(t.code,{children:`bigint`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`Map`}),` обычно превращается в `,(0,c.jsx)(t.code,{children:`{}`}),`, cycle и `,(0,c.jsx)(t.code,{children:`bigint`}),` выбрасывают ошибку. Сначала создайте явное JSON-compatible representation.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`путаница-null-и--1`,children:[`Путаница `,(0,c.jsx)(t.code,{children:`null`}),` и `,(0,c.jsx)(t.code,{children:`-1`})]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`}),` возвращает `,(0,c.jsx)(t.code,{children:`null`}),`, если клавиша не относится к navigation или элементов нет.`]}),`
+`,(0,c.jsxs)(t.li,{children:[`Select-navigation helpers возвращают `,(0,c.jsx)(t.code,{children:`-1`}),`, если подходящего индекса нет.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Проверяйте именно тот sentinel, который заявлен функцией.`}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-импортировать-только-cn-не-устанавливая-react`,children:[`Можно ли импортировать только `,(0,c.jsx)(t.code,{children:`cn`}),`, не устанавливая React?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Entrypoint `,(0,c.jsx)(t.code,{children:`/utils`}),` публично реэкспортирует также React-зависимые modules. Для надёжного ESM resolution host должен предоставить совместимый React peer, даже если конкретный bundler затем tree-shake неиспользуемый код.`]}),`
+`,(0,c.jsx)(t.h3,{id:`какая-clone-функция-подходит-для-zustand-draftconfig`,children:`Какая clone-функция подходит для Zustand draft/config?`}),`
+`,(0,c.jsxs)(t.p,{children:[`Обычно `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),`: она принимает только предсказуемую data-only структуру и явно ошибается на специальных объектах. Она клонирует буквально и не нормализует draft.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-не-structuredclone`,children:[`Почему не `,(0,c.jsx)(t.code,{children:`structuredClone`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Эти функции имеют отдельный контракт удаления функций и контролируемое поведение массивов. `,(0,c.jsx)(t.code,{children:`deepCopyWithoutFunctions`}),` дополнительно запрещает неподходящие для config объекты. `,(0,c.jsx)(t.code,{children:`structuredClone`}),` решает другую общую задачу и имеет другой набор поддерживаемых/ошибочных значений.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-клонировать-dom-node-file-или-blob`,children:[`Можно ли клонировать DOM node, `,(0,c.jsx)(t.code,{children:`File`}),` или `,(0,c.jsx)(t.code,{children:`Blob`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет, это не поддерживаемый контракт clone-функций модуля. Используйте API соответствующего типа или храните в конфигурации только serializable metadata/reference.`}),`
+`,(0,c.jsx)(t.h3,{id:`удаляет-ли-clone-дубликаты-и-пробелы`,children:`Удаляет ли clone дубликаты и пробелы?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Clone сохраняет literal data. Для canonical save snapshot нужна отдельная normalize-функция на границе сохранения.`}),`
+`,(0,c.jsxs)(t.h3,{id:`можно-ли-сравнить-любые-два-объекта-через-stablestringify`,children:[`Можно ли сравнить любые два объекта через `,(0,c.jsx)(t.code,{children:`stableStringify`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет. Подходят небольшие JSON-compatible data structures без cycles, functions, symbols, `,(0,c.jsx)(t.code,{children:`bigint`}),`, getters с эффектами и специальных collections. JSON-семантика может скрыть различия.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`stablestringify-создаёт-hash`,children:[(0,c.jsx)(t.code,{children:`stableStringify`}),` создаёт hash?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Нет, результат содержит весь JSON-текст. Для hash/id используйте публичный модуль `,(0,c.jsx)(t.code,{children:`crypto`}),`, учитывая назначение конкретной hash-функции.`]}),`
+`,(0,c.jsx)(t.h3,{id:`как-сделать-base64url`,children:`Как сделать Base64URL?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`toBase64`}),` и `,(0,c.jsx)(t.code,{children:`encodeBase64`}),` возвращают стандартный Base64. Если protocol требует Base64URL, следуйте его точным правилам замены `,(0,c.jsx)(t.code,{children:`+`}),`/`,(0,c.jsx)(t.code,{children:`/`}),`, удаления/сохранения padding и декодирования. Не называйте ad hoc-преобразование криптографической защитой.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-handlekeyboardactivation-не-вызывает-click`,children:[`Почему `,(0,c.jsx)(t.code,{children:`handleKeyboardActivation`}),` не вызывает click?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Helper принимает явный `,(0,c.jsx)(t.code,{children:`action`}),`, чтобы не зависеть от DOM. Host сам решает, какое действие соответствует активации и какие `,(0,c.jsx)(t.code,{children:`role`}),`, ARIA и focus rules нужны control.`]}),`
+`,(0,c.jsx)(t.h3,{id:`чем-roving-focus-отличается-от-select-navigation`,children:`Чем roving focus отличается от select navigation?`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`getRovingFocusTargetIndex`}),` знает orientation, Arrow/Home/End и границы, но не знает disabled items. Select-navigation helpers знают disabled items и направление `,(0,c.jsx)(t.code,{children:`1/-1`}),`, но не интерпретируют `,(0,c.jsx)(t.code,{children:`KeyboardEvent.key`}),` и не перемещают DOM-фокус.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-передавать-cachekey-в-createlazycomponent`,children:[`Нужно ли передавать `,(0,c.jsx)(t.code,{children:`cacheKey`}),` в `,(0,c.jsx)(t.code,{children:`createLazyComponent`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Стабильной importer-функции и component name достаточно. Строковый ключ нужен только когда разные importer references намеренно должны делить один lazy component; его уникальность становится ответственностью host.`}),`
+`,(0,c.jsxs)(t.h3,{id:`childrencount-считает-dom-элементы-после-рендера`,children:[(0,c.jsx)(t.code,{children:`childrenCount`}),` считает DOM-элементы после рендера?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Функция считает переданную React-структуру до DOM и раскрывает fragments. Один обычный component/element считается одним child, даже если позже отрендерит много DOM nodes.`})]})}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};