@ryuzaki13/react-foundation-ui 1.8.5 → 1.8.7

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

@@ -0,0 +1,1093 @@
+import{n as e}from"./rolldown-runtime-DkW27tQK.js";import{n as t}from"./iframe-CViB2sFm.js";import{i as n,r}from"./react-Bl2r1tuC.js";import{l as i,m as a}from"./blocks-B8F5vBhs.js";function o(e){let t={a:`a`,code:`code`,h1:`h1`,h2:`h2`,h3:`h3`,h4:`h4`,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/Array`}),`
+`,(0,c.jsxs)(t.h1,{id:`работа-с-массивами-через-ryuzaki13react-foundation-libarray`,children:[`Работа с массивами через `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/array`})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Модуль `,(0,c.jsx)(t.code,{children:`array`}),` содержит небольшие типизированные функции для типовых операций с массивами:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`группировки элементов;`}),`
+`,(0,c.jsx)(t.li,{children:`построения словаря по полю объекта;`}),`
+`,(0,c.jsx)(t.li,{children:`удаления дубликатов;`}),`
+`,(0,c.jsx)(t.li,{children:`восстановления порядка элементов по списку идентификаторов;`}),`
+`,(0,c.jsx)(t.li,{children:`сравнения массивов;`}),`
+`,(0,c.jsx)(t.li,{children:`перемещения элементов;`}),`
+`,(0,c.jsx)(t.li,{children:`нормализации строковых идентификаторов и объектов.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Функции не зависят от React, браузерного DOM, TanStack или других внешних runtime-библиотек. Их можно использовать в обычном TypeScript/JavaScript-коде, React-компонентах, store, mapper, validator и на границах сохранения или восстановления конфигурации.`}),`
+`,(0,c.jsx)(t.p,{children:`README рассчитан на разработчика, который использует опубликованный пакет и не читает его исходный код. Здесь отдельно объясняются базовые понятия JavaScript/TypeScript, точное поведение каждой функции, ограничения и типовые ошибки.`}),`
+`,(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:`#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82`,children:`Установка и импорт`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BC%D0%B8%D0%BD%D0%B8%D0%BC%D0%B0%D0%BB%D1%8C%D0%BD%D1%8B%D0%B5-%D0%BF%D0%BE%D0%BD%D1%8F%D1%82%D0%B8%D1%8F-javascript-%D0%B8-typescript`,children:`Минимальные понятия JavaScript и TypeScript`})}),`
+`,(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.jsx)(t.a,{href:`#%D0%BE%D0%B1%D1%89%D0%B8%D0%B5-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0-%D0%BC%D0%BE%D0%B4%D1%83%D0%BB%D1%8F`,children:`Общие правила модуля`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D0%B8%D1%80%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B8-%D0%BF%D0%BE%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%BB%D0%BE%D0%B2%D0%B0%D1%80%D1%8F`,children:`Группировка и построение словаря`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D1%83%D0%B1%D0%BB%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D0%B2`,children:`Удаление дубликатов`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsxs)(t.a,{href:`#%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-%D0%B8%D0%B4%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%82%D0%BE%D1%80%D0%B0%D0%BC%D0%B8-%D0%B8-map`,children:[`Работа с идентификаторами и `,(0,c.jsx)(t.code,{children:`Map`})]})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D1%81%D1%80%D0%B0%D0%B2%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BC%D0%B0%D1%81%D1%81%D0%B8%D0%B2%D0%BE%D0%B2`,children:`Сравнение массивов`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D0%B5%D1%80%D0%B5%D0%BC%D0%B5%D1%89%D0%B5%D0%BD%D0%B8%D0%B5-%D1%8D%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82%D0%BE%D0%B2`,children:`Перемещение элементов`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BD%D0%BE%D1%80%D0%BC%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-%D1%81%D1%82%D1%80%D0%BE%D0%BA-%D0%B8-%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82%D0%BE%D0%B2`,children:`Нормализация строк и объектов`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D1%8B%D0%B5-%D1%80%D0%B5%D1%86%D0%B5%D0%BF%D1%82%D1%8B`,children:`Готовые рецепты`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BF%D1%80%D0%BE%D0%B8%D0%B7%D0%B2%D0%BE%D0%B4%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D1%8C`,children:`Производительность`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BE%D0%B3%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%B5%D0%BD%D0%B8%D1%8F-%D0%B8-%D1%87%D0%B0%D1%81%D1%82%D1%8B%D0%B5-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8`,children:`Ограничения и частые ошибки`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%BA%D1%80%D0%B0%D1%82%D0%BA%D0%B8%D0%B9-%D1%81%D0%BF%D1%80%D0%B0%D0%B2%D0%BE%D1%87%D0%BD%D0%B8%D0%BA-api`,children:`Краткий справочник API`})}),`
+`,(0,c.jsx)(t.li,{children:(0,c.jsx)(t.a,{href:`#%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D1%8B-%D0%B8-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D1%8B`,children:`Вопросы и ответы`})}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`установка-и-импорт`,children:`Установка и импорт`}),`
+`,(0,c.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:`/array`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import { arrayGroupBy, arrayToMap, arrayUniqueBy, moveArrayItem } from "@ryuzaki13/react-foundation-lib/array";
+
+import type { ReorderAction } from "@ryuzaki13/react-foundation-lib/array";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Корневой импорт пакета не поддерживается:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно: у пакета нет корневого export.
+import { arrayGroupBy } from "@ryuzaki13/react-foundation-lib";
+
+// Правильно.
+import { arrayGroupBy } from "@ryuzaki13/react-foundation-lib/array";
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Модуль поставляется как ESM. Для его функций не нужно устанавливать дополнительные peer-зависимости.`}),`
+`,(0,c.jsx)(t.h2,{id:`минимальные-понятия-javascript-и-typescript`,children:`Минимальные понятия JavaScript и TypeScript`}),`
+`,(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 letters = ["A", "B", "C"];
+`})}),`
+`,(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,{style:{textAlign:`right`},children:`Индекс`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"A"`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`0`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"B"`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`1`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"C"`})}),(0,c.jsx)(t.td,{style:{textAlign:`right`},children:`2`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Поэтому перемещение элемента с индекса `,(0,c.jsx)(t.code,{children:`0`}),` на индекс `,(0,c.jsx)(t.code,{children:`2`}),` означает перемещение `,(0,c.jsx)(t.code,{children:`"A"`}),` в конец.`]}),`
+`,(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 user = {
+	id: "U-1",
+	name: "Анна",
+	department: "Продажи"
+};
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Вызов `,(0,c.jsx)(t.code,{children:`arrayGroupBy(users, "department")`}),` означает: взять у каждого пользователя свойство `,(0,c.jsx)(t.code,{children:`department`}),` и использовать его значение как ключ группы.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`TypeScript-конструкция `,(0,c.jsx)(t.code,{children:`keyof T`}),` запрещает случайно передать имя свойства, которого нет в элементах массива:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type User = {
+	id: string;
+	name: string;
+};
+
+const users: User[] = [];
+
+arrayToMap(users, "id"); // Корректно.
+arrayToMap(users, "department"); // Ошибка TypeScript: такого свойства нет в User.
+`})}),`
+`,(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 first = { id: "A" };
+const second = first;
+
+console.log(first === second); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Два отдельно созданных объекта с одинаковыми полями имеют разные ссылки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const first = { id: "A" };
+const second = { id: "A" };
+
+console.log(first === second); // false
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Это важно для `,(0,c.jsx)(t.code,{children:`arrayDeduplicate`}),` и `,(0,c.jsx)(t.code,{children:`arraysEqual`}),`: они не выполняют глубокое сравнение содержимого объектов.`]}),`
+`,(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 = ["A", "B"];
+source.push("C"); // source изменён.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Неизменяемое преобразование создаёт новый массив и оставляет исходный без изменений:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = ["A", "B"];
+const result = [...source, "C"];
+
+console.log(source); // ["A", "B"]
+console.log(result); // ["A", "B", "C"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Почти все функции этого модуля работают неизменяемо. Исключение — `,(0,c.jsx)(t.code,{children:`addUnique`}),`, которая специально изменяет переданные `,(0,c.jsx)(t.code,{children:`target`}),` и `,(0,c.jsx)(t.code,{children:`seen`}),`.`]}),`
+`,(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 profile = { city: "Казань" };
+const source = [{ id: "A", profile }];
+const copy = [...source];
+
+console.log(copy !== source); // true: массив новый.
+console.log(copy[0] === source[0]); // true: элемент тот же.
+console.log(copy[0].profile === profile); // true: вложенный объект тот же.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функции модуля не выполняют глубокое клонирование.`}),`
+`,(0,c.jsxs)(t.h3,{id:`что-означают-t-readonly-t-record-map-и-set`,children:[`Что означают `,(0,c.jsx)(t.code,{children:`T`}),`, `,(0,c.jsx)(t.code,{children:`readonly T[]`}),`, `,(0,c.jsx)(t.code,{children:`Record`}),`, `,(0,c.jsx)(t.code,{children:`Map`}),` и `,(0,c.jsx)(t.code,{children:`Set`})]}),`
+`,(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:`T`})}),(0,c.jsx)(t.td,{children:`Обобщённый тип элемента. TypeScript подставит фактический тип из переданного массива.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`readonly T[]`})}),(0,c.jsx)(t.td,{children:`Функция обещает не изменять входной массив. Обычный изменяемый массив тоже можно передать.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`T[]`})}),(0,c.jsxs)(t.td,{children:[`Массив элементов типа `,(0,c.jsx)(t.code,{children:`T`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Record<string,T>`})}),(0,c.jsxs)(t.td,{children:[`Обычный JavaScript-объект, в котором строковый ключ ведёт к значению типа `,(0,c.jsx)(t.code,{children:`T`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Map<K,V>`})}),(0,c.jsxs)(t.td,{children:[`Коллекция пар «ключ → значение» с методами `,(0,c.jsx)(t.code,{children:`get`}),`, `,(0,c.jsx)(t.code,{children:`set`}),`, `,(0,c.jsx)(t.code,{children:`has`}),`. Ключ может иметь любой тип.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Set<T>`})}),(0,c.jsxs)(t.td,{children:[`Коллекция уникальных значений. Метод `,(0,c.jsx)(t.code,{children:`has`}),` проверяет, встречалось ли значение, а `,(0,c.jsx)(t.code,{children:`add`}),` добавляет его в набор.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`undefined`})}),(0,c.jsx)(t.td,{children:`Значение отсутствует. Некоторые normalizer-функции возвращают его вместо пустого результата.`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`readonly`}),` в типе параметра не замораживает массив во время выполнения. Это ограничение TypeScript внутри функции, а не вызов `,(0,c.jsx)(t.code,{children:`Object.freeze`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`как-выбрать-функцию`,children:`Как выбрать функцию`}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Задача`}),(0,c.jsx)(t.th,{children:`Функция`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Собрать элементы в объект с массивами групп`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayGroupBy`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Получить группы как массив `,(0,c.jsx)(t.code,{children:`{ key, items }`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayGroupByToArray`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Быстро находить объект по его `,(0,c.jsx)(t.code,{children:`id`}),` или другому полю`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayToMap`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Оставить первый объект для каждого уникального значения поля`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayUniqueBy`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Удалить повторяющиеся примитивы или повторные ссылки`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayDeduplicate`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Оставить только разрешённые ID и убрать их повторы`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Дописать в конец отсутствующие ID`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`appendMissingIds`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsxs)(t.td,{children:[`Получить значения `,(0,c.jsx)(t.code,{children:`Map`}),` в заданном порядке ключей`]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`pickExistingMapValues`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Проверить одинаковую длину, порядок и строгую идентичность элементов`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arraysEqual`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Переместить элемент с одного числового индекса на другой`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`moveArrayItem`}),` или `,(0,c.jsx)(t.code,{children:`moveItem`})]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Переместить элемент в начало, конец, на одну позицию вверх или вниз`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`moveArrayItemByIndex`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Обрезать пробелы у строк, удалить пустые строки и дубли`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeStringArray`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Нормализовать строковое ключевое поле списка объектов`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeObjects`})})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Постепенно собрать уникальные строковые ID в уже существующий массив`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`addUnique`})})]})]})]}),`
+`,(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-ts`,children:`type User = {
+	id: string;
+	name: string;
+	department: string;
+};
+
+const users: User[] = [
+	{ id: "U-1", name: "Анна", department: "Продажи" },
+	{ id: "U-2", name: "Иван", department: "ИТ" },
+	{ id: "U-3", name: "Ольга", department: "Продажи" }
+];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сгруппировать пользователей по подразделению:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const usersByDepartment = arrayGroupBy(users, "department");
+
+console.log(usersByDepartment["Продажи"]);
+// [
+//   { id: "U-1", name: "Анна", department: "Продажи" },
+//   { id: "U-3", name: "Ольга", department: "Продажи" }
+// ]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Построить словарь для быстрого поиска по ID:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const usersById = arrayToMap(users, "id");
+
+console.log(usersById["U-2"]);
+// { id: "U-2", name: "Иван", department: "ИТ" }
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Переместить первого пользователя в конец без изменения `,(0,c.jsx)(t.code,{children:`users`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const reorderedUsers = moveArrayItem(users, 0, 2);
+
+console.log(reorderedUsers.map((user) => user.id)); // ["U-2", "U-3", "U-1"]
+console.log(users.map((user) => user.id)); // ["U-1", "U-2", "U-3"]
+`})}),`
+`,(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:`addUnique`}),`, не изменяют переданный массив. Функции, которые возвращают массив, создают новый внешний массив.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = ["A", "B", "C"];
+const result = moveArrayItem(source, 0, 2);
+
+console.log(result === source); // false
+console.log(source); // ["A", "B", "C"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Даже если перемещение невозможно или не требуется, функции перемещения возвращают копию:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = ["A", "B"];
+const result = moveArrayItem(source, 0, 0);
+
+console.log(result); // ["A", "B"]
+console.log(result === source); // false
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`элементы-обычно-не-клонируются`,children:`Элементы обычно не клонируются`}),`
+`,(0,c.jsxs)(t.p,{children:[`Новые массивы содержат прежние значения и ссылки. Исключение — `,(0,c.jsx)(t.code,{children:`normalizeObjects`}),` в режиме по умолчанию: она поверхностно копирует каждый сохранённый объект.`]}),`
+`,(0,c.jsx)(t.p,{children:`Если изменить вложенный объект через результат, изменение будет видно через исходный объект:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = [{ id: "A", settings: { visible: true } }];
+const result = arrayUniqueBy(source, "id");
+
+result[0].settings.visible = false;
+
+console.log(source[0].settings.visible); // 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:`const rows = [
+	{ id: "A", value: 1 },
+	{ id: "A", value: 2 }
+];
+
+console.log(arrayToMap(rows, "id")["A"].value); // 1
+console.log(arrayUniqueBy(rows, "id")); // Только первый объект.
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`регистр-обычно-учитывается`,children:`Регистр обычно учитывается`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`"A"`}),` и `,(0,c.jsx)(t.code,{children:`"a"`}),` считаются разными значениями. Модуль не переводит текст в нижний или верхний регистр.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ошибки-не-логируются-и-не-скрываются`,children:`Ошибки не логируются и не скрываются`}),`
+`,(0,c.jsxs)(t.p,{children:[`Функции ожидают значения, соответствующие TypeScript-сигнатурам. Например, вместо массива нельзя передавать `,(0,c.jsx)(t.code,{children:`null`}),`. TypeScript должен обнаружить такую ошибку до запуска программы.`]}),`
+`,(0,c.jsx)(t.p,{children:`Исключение — функции перемещения: для целых индексов вне границ массива они безопасно возвращают копию без перестановки.`}),`
+`,(0,c.jsx)(t.h2,{id:`группировка-и-построение-словаря`,children:`Группировка и построение словаря`}),`
+`,(0,c.jsx)(t.h3,{id:`arraygroupby`,children:(0,c.jsx)(t.code,{children:`arrayGroupBy`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function arrayGroupBy<T>(array: readonly T[], key: keyof T): Record<string, T[]>;
+`})}),`
+`,(0,c.jsx)(t.p,{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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`array`})}),(0,c.jsx)(t.td,{children:`Исходный массив объектов.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`key`})}),(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-ts`,children:`const tasks = [
+	{ id: 1, status: "new" },
+	{ id: 2, status: "done" },
+	{ id: 3, status: "new" }
+];
+
+const tasksByStatus = arrayGroupBy(tasks, "status");
+
+console.log(tasksByStatus);
+// {
+//   new: [
+//     { id: 1, status: "new" },
+//     { id: 3, status: "new" }
+//   ],
+//   done: [
+//     { id: 2, status: "done" }
+//   ]
+// }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Точное поведение:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`значение `,(0,c.jsx)(t.code,{children:`item[key]`}),` преобразуется через `,(0,c.jsx)(t.code,{children:`String`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`элементы внутри каждой группы остаются в исходном порядке;`}),`
+`,(0,c.jsx)(t.li,{children:`одинаковые строковые ключи попадают в одну группу;`}),`
+`,(0,c.jsxs)(t.li,{children:[`пустой входной массив возвращает `,(0,c.jsx)(t.code,{children:`{}`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`внешний объект и массивы групп новые;`}),`
+`,(0,c.jsx)(t.li,{children:`сами элементы не копируются.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Преобразование через `,(0,c.jsx)(t.code,{children:`String`}),` означает, что разные исходные типы могут стать одним ключом:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = [
+	{ value: "строка", group: 1 },
+	{ value: "число", group: "1" }
+];
+
+const grouped = arrayGroupBy(rows, "group");
+
+console.log(grouped["1"].length); // 2
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Не используйте для группировки сложный объект:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = [
+	{ id: 1, group: { code: "A" } },
+	{ id: 2, group: { code: "B" } }
+];
+
+// Оба объекта обычно превратятся в строку "[object Object]".
+const grouped = arrayGroupBy(rows, "group");
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Выбирайте строковое, числовое или boolean-поле с однозначным строковым представлением.`}),`
+`,(0,c.jsx)(t.h3,{id:`arraygroupbytoarray`,children:(0,c.jsx)(t.code,{children:`arrayGroupByToArray`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function arrayGroupByToArray<T>(
+	array: readonly T[],
+	key: keyof T
+): Array<{
+	key: string;
+	items: T[];
+}>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция выполняет ту же группировку, что `,(0,c.jsx)(t.code,{children:`arrayGroupBy`}),`, но возвращает массив групп. Такой результат удобен для `,(0,c.jsx)(t.code,{children:`.map()`}),` в UI.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const tasks = [
+	{ id: 1, status: "new" },
+	{ id: 2, status: "done" },
+	{ id: 3, status: "new" }
+];
+
+const groups = arrayGroupByToArray(tasks, "status");
+
+console.log(groups);
+// [
+//   {
+//     key: "new",
+//     items: [
+//       { id: 1, status: "new" },
+//       { id: 3, status: "new" }
+//     ]
+//   },
+//   {
+//     key: "done",
+//     items: [
+//       { id: 2, status: "done" }
+//     ]
+//   }
+// ]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример React-рендера:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const groups = arrayGroupByToArray(tasks, "status");
+
+return groups.map((group) => (
+	<section key={group.key}>
+		<h2>{group.key}</h2>
+		<ul>
+			{group.items.map((task) => (
+				<li key={task.id}>{task.id}</li>
+			))}
+		</ul>
+	</section>
+));
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Важно: порядок элементов внутри каждой группы сохраняется. Порядок самих групп следует правилам перечисления свойств обычного JavaScript-объекта. Строковые ключи вроде `,(0,c.jsx)(t.code,{children:`"new"`}),` и `,(0,c.jsx)(t.code,{children:`"done"`}),` обычно сохраняют порядок первого появления, но ключи, похожие на неотрицательные целые числа, перечисляются по возрастанию:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = [{ group: "10" }, { group: "2" }, { group: "A" }];
+
+console.log(arrayGroupByToArray(rows, "group").map((group) => group.key));
+// ["2", "10", "A"], а не ["10", "2", "A"].
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если порядок групп является бизнес-правилом, сортируйте готовый массив явно или используйте собственную группировку через `,(0,c.jsx)(t.code,{children:`Map`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`arraytomap`,children:(0,c.jsx)(t.code,{children:`arrayToMap`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function arrayToMap<T>(array: readonly T[], key: keyof T): Record<string, T>;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Несмотря на имя, функция возвращает не экземпляр JavaScript `,(0,c.jsx)(t.code,{children:`Map`}),`, а обычный объект-словарь.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const products = [
+	{ id: "P-1", name: "Стол" },
+	{ id: "P-2", name: "Стул" }
+];
+
+const productsById = arrayToMap(products, "id");
+
+console.log(productsById["P-2"]);
+// { id: "P-2", name: "Стул" }
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Повторный ключ не перезаписывает первое значение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = [
+	{ id: "A", version: 1 },
+	{ id: "A", version: 2 }
+];
+
+console.log(arrayToMap(rows, "id")["A"].version); // 1
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Точное поведение:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`ключ преобразуется через `,(0,c.jsx)(t.code,{children:`String`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`сохраняется первый элемент с каждым строковым ключом;`}),`
+`,(0,c.jsxs)(t.li,{children:[`пустой массив возвращает `,(0,c.jsx)(t.code,{children:`{}`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`результат новый, элементы не копируются;`}),`
+`,(0,c.jsxs)(t.li,{children:[`поиск выполняется через квадратные скобки: `,(0,c.jsx)(t.code,{children:`result[id]`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`отсутствующий ключ во время выполнения даёт `,(0,c.jsx)(t.code,{children:`undefined`}),`, хотя тип результата записан как `,(0,c.jsx)(t.code,{children:`Record<string, T>`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Безопасно проверяйте наличие значения:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const product = productsById[selectedId];
+
+if (product) {
+	console.log(product.name);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для произвольных внешних ключей предпочитайте настоящий `,(0,c.jsx)(t.code,{children:`Map`}),`, потому что `,(0,c.jsx)(t.code,{children:`arrayToMap`}),`, `,(0,c.jsx)(t.code,{children:`arrayGroupBy`}),` и `,(0,c.jsx)(t.code,{children:`arrayGroupByToArray`}),` строят обычный объект. Значения вроде `,(0,c.jsx)(t.code,{children:`"__proto__"`}),`, `,(0,c.jsx)(t.code,{children:`"constructor"`}),` и `,(0,c.jsx)(t.code,{children:`"toString"`}),` пересекаются со специальными свойствами прототипа объекта и могут привести к неправильному результату или runtime-ошибке.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Хороший вход: заранее проверенные технические ID.
+const productsById = arrayToMap(products, "id");
+
+// Для произвольного пользовательского ключа безопаснее Map.
+const productsByExternalKey = new Map(products.map((product) => [product.externalKey, product]));
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`удаление-дубликатов`,children:`Удаление дубликатов`}),`
+`,(0,c.jsx)(t.h3,{id:`arrayuniqueby`,children:(0,c.jsx)(t.code,{children:`arrayUniqueBy`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function arrayUniqueBy<T>(array: readonly T[], key: keyof T): T[];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция оставляет первый объект для каждого уникального строкового представления выбранного свойства.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const rows = [
+	{ id: "A", value: 1 },
+	{ id: "B", value: 2 },
+	{ id: "A", value: 3 }
+];
+
+const uniqueRows = arrayUniqueBy(rows, "id");
+
+console.log(uniqueRows);
+// [
+//   { id: "A", value: 1 },
+//   { id: "B", value: 2 }
+// ]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Точное поведение:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`порядок первых вхождений сохраняется;`}),`
+`,(0,c.jsx)(t.li,{children:`исходный массив не изменяется;`}),`
+`,(0,c.jsx)(t.li,{children:`элементы не копируются;`}),`
+`,(0,c.jsx)(t.li,{children:`пустой массив возвращает новый пустой массив;`}),`
+`,(0,c.jsxs)(t.li,{children:[`ключ сравнивается после `,(0,c.jsx)(t.code,{children:`String(item[key])`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`"A"`}),` и `,(0,c.jsx)(t.code,{children:`"a"`}),` считаются разными;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`число `,(0,c.jsx)(t.code,{children:`1`}),` и строка `,(0,c.jsx)(t.code,{children:`"1"`}),` считаются одним ключом;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),` превращается в `,(0,c.jsx)(t.code,{children:`"null"`}),`, а `,(0,c.jsx)(t.code,{children:`undefined`}),` — в `,(0,c.jsx)(t.code,{children:`"undefined"`}),`.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция подходит для объектов, когда уникальность определяется конкретным полем. Для массива примитивов используйте `,(0,c.jsx)(t.code,{children:`arrayDeduplicate`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`arraydeduplicate`,children:(0,c.jsx)(t.code,{children:`arrayDeduplicate`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function arrayDeduplicate<T>(array: readonly T[]): T[];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция удаляет повторяющиеся значения и сохраняет первое вхождение.`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ids = ["A", "B", "A", "C", "B"];
+
+console.log(arrayDeduplicate(ids));
+// ["A", "B", "C"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для примитивов сравниваются сами значения:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(arrayDeduplicate([1, 2, 1, 3])); // [1, 2, 3]
+console.log(arrayDeduplicate([true, false, true])); // [true, false]
+console.log(arrayDeduplicate([Number.NaN, Number.NaN])); // [NaN]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для объектов сравниваются ссылки, а не поля:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const shared = { id: "A" };
+
+console.log(arrayDeduplicate([shared, shared]).length); // 1
+console.log(arrayDeduplicate([{ id: "A" }, { id: "A" }]).length); // 2
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужно удалить дубликаты объектов по `,(0,c.jsx)(t.code,{children:`id`}),`, используйте:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`arrayUniqueBy(objects, "id");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`arrayDeduplicate`}),` использует правила равенства `,(0,c.jsx)(t.code,{children:`Set`}),`:`]}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`одинаковые примитивы считаются дублями;`}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`NaN`}),` считается равным `,(0,c.jsx)(t.code,{children:`NaN`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`0`}),` и `,(0,c.jsx)(t.code,{children:`-0`}),` считаются одним значением;`]}),`
+`,(0,c.jsx)(t.li,{children:`объекты считаются одинаковыми только при совпадении ссылки.`}),`
+`]}),`
+`,(0,c.jsxs)(t.h2,{id:`работа-с-идентификаторами-и-map`,children:[`Работа с идентификаторами и `,(0,c.jsx)(t.code,{children:`Map`})]}),`
+`,(0,c.jsx)(t.h3,{id:`filteranddeduplicateids`,children:(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function filterAndDeduplicateIds<TId extends string>(ids: readonly string[] | undefined, allowedIds: readonly TId[]): TId[];
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция очищает список идентификаторов по разрешённому набору:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`сохраняет только ID, которые есть в `,(0,c.jsx)(t.code,{children:`allowedIds`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`удаляет пустую строку `,(0,c.jsx)(t.code,{children:`""`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`удаляет повторы;`}),`
+`,(0,c.jsxs)(t.li,{children:[`сохраняет порядок первого появления в `,(0,c.jsx)(t.code,{children:`ids`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const savedOrder = ["D", "B", "UNKNOWN", "B", ""];
+const allowedIds = ["A", "B", "C", "D"] as const;
+
+const validOrder = filterAndDeduplicateIds(savedOrder, allowedIds);
+
+console.log(validOrder); // ["D", "B"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`ids`}),` равен `,(0,c.jsx)(t.code,{children:`undefined`}),`, функция возвращает пустой массив:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(filterAndDeduplicateIds(undefined, ["A", "B"]));
+// []
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция не вызывает `,(0,c.jsx)(t.code,{children:`trim`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(filterAndDeduplicateIds([" A "], ["A"]));
+// []
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если вход может содержать пробелы, сначала вызовите `,(0,c.jsx)(t.code,{children:`normalizeStringArray`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const normalizedIds = normalizeStringArray([" A ", "B "]);
+const validIds = filterAndDeduplicateIds(normalizedIds, ["A", "B"]);
+
+console.log(validIds); // ["A", "B"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Сравнение чувствительно к регистру. `,(0,c.jsx)(t.code,{children:`"a"`}),` не совпадает с `,(0,c.jsx)(t.code,{children:`"A"`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Generic `,(0,c.jsx)(t.code,{children:`TId`}),` сохраняет точный union разрешённых значений:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const allowedIds = ["name", "email", "phone"] as const;
+const result = filterAndDeduplicateIds(["email", "unknown"], allowedIds);
+
+// Тип result:
+// Array<"name" | "email" | "phone">
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`appendmissingids`,children:(0,c.jsx)(t.code,{children:`appendMissingIds`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function appendMissingIds<TId extends string>(baseIds: readonly TId[], idsToAppend: readonly TId[]): TId[];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция создаёт копию `,(0,c.jsx)(t.code,{children:`baseIds`}),`, затем добавляет в конец непустые ID из `,(0,c.jsx)(t.code,{children:`idsToAppend`}),`, которых ещё нет в результате.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = appendMissingIds(["D", "B"], ["A", "B", "C", "D"]);
+
+console.log(result); // ["D", "B", "A", "C"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Порядок:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`существующий порядок `,(0,c.jsx)(t.code,{children:`baseIds`}),` сохраняется;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`новые ID добавляются в порядке `,(0,c.jsx)(t.code,{children:`idsToAppend`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`ID, уже встреченный в `,(0,c.jsx)(t.code,{children:`baseIds`}),` или ранее добавленный из `,(0,c.jsx)(t.code,{children:`idsToAppend`}),`, повторно не добавляется.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Важно: функция не очищает сам `,(0,c.jsx)(t.code,{children:`baseIds`}),`. Уже существующие там пустые строки и дубли сохраняются:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = appendMissingIds(["A", "A", ""], ["A", "B", ""]);
+
+console.log(result); // ["A", "A", "", "B"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужно очистить базовый список, сначала используйте `,(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const allowedIds = ["A", "B", "C"] as const;
+const cleanBase = filterAndDeduplicateIds(savedIds, allowedIds);
+const completeOrder = appendMissingIds(cleanBase, allowedIds);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`pickexistingmapvalues`,children:(0,c.jsx)(t.code,{children:`pickExistingMapValues`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function pickExistingMapValues<TKey, TValue>(keys: readonly TKey[], valuesByKey: ReadonlyMap<TKey, TValue>): TValue[];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция последовательно проходит по `,(0,c.jsx)(t.code,{children:`keys`}),`, берёт значения из `,(0,c.jsx)(t.code,{children:`Map`}),` и возвращает их в порядке ключей. Отсутствующие ключи пропускаются.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const usersById = new Map([
+	["A", { id: "A", name: "Анна" }],
+	["B", { id: "B", name: "Иван" }],
+	["C", { id: "C", name: "Ольга" }]
+]);
+
+const users = pickExistingMapValues(["C", "UNKNOWN", "A"], usersById);
+
+console.log(users.map((user) => user.id)); // ["C", "A"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Точное поведение:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`valuesByKey`}),` не изменяется;`]}),`
+`,(0,c.jsx)(t.li,{children:`результат — новый массив;`}),`
+`,(0,c.jsxs)(t.li,{children:[`порядок задаёт именно `,(0,c.jsx)(t.code,{children:`keys`}),`, а не порядок вставки в `,(0,c.jsx)(t.code,{children:`Map`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`повторный ключ даёт повторное значение;`}),`
+`,(0,c.jsx)(t.li,{children:`отсутствующий ключ пропускается;`}),`
+`,(0,c.jsxs)(t.li,{children:[`значение `,(0,c.jsx)(t.code,{children:`undefined`}),` пропускается, даже если такой ключ существует в `,(0,c.jsx)(t.code,{children:`Map`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`null`}),`, `,(0,c.jsx)(t.code,{children:`false`}),`, `,(0,c.jsx)(t.code,{children:`0`}),` и пустая строка являются допустимыми значениями и не пропускаются.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const values = new Map<string, number | undefined>([
+	["A", 0],
+	["B", undefined],
+	["C", 3]
+]);
+
+console.log(pickExistingMapValues(["A", "B", "A", "C"], values));
+// [0, 0, 3]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для объектных ключей `,(0,c.jsx)(t.code,{children:`Map`}),` сравнивает ссылки:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const key = { id: "A" };
+const values = new Map([[key, "значение"]]);
+
+console.log(pickExistingMapValues([key], values)); // ["значение"]
+console.log(pickExistingMapValues([{ id: "A" }], values)); // []
+`})}),`
+`,(0,c.jsx)(t.h2,{id:`сравнение-массивов`,children:`Сравнение массивов`}),`
+`,(0,c.jsx)(t.h3,{id:`arraysequal`,children:(0,c.jsx)(t.code,{children:`arraysEqual`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function arraysEqual<T>(left: readonly T[], right: readonly T[]): boolean;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Функция возвращает `,(0,c.jsx)(t.code,{children:`true`}),`, только если:`]}),`
+`,(0,c.jsxs)(t.ol,{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:`!==`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(arraysEqual(["A", "B"], ["A", "B"])); // true
+console.log(arraysEqual(["A", "B"], ["B", "A"])); // false
+console.log(arraysEqual(["A"], ["A", "B"])); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Объекты сравниваются по ссылке:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const shared = { id: "A" };
+
+console.log(arraysEqual([shared], [shared])); // true
+console.log(arraysEqual([{ id: "A" }], [{ id: "A" }])); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция не подходит для глубокого сравнения объектов:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const left = [{ id: "A", settings: { visible: true } }];
+const right = [{ id: "A", settings: { visible: true } }];
+
+console.log(arraysEqual(left, right)); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Дополнительные особенности строгого сравнения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`0`}),` и `,(0,c.jsx)(t.code,{children:`-0`}),` считаются равными;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`NaN`}),` не считается равным `,(0,c.jsx)(t.code,{children:`NaN`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`пустая позиция разреженного массива и явный `,(0,c.jsx)(t.code,{children:`undefined`}),` на той же позиции будут прочитаны как `,(0,c.jsx)(t.code,{children:`undefined`}),` и могут считаться равными.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(arraysEqual([Number.NaN], [Number.NaN])); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Типовые применения:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`сравнение массивов строковых ID;`}),`
+`,(0,c.jsx)(t.li,{children:`проверка, изменился ли порядок колонок;`}),`
+`,(0,c.jsx)(t.li,{children:`сравнение списков примитивных значений;`}),`
+`,(0,c.jsx)(t.li,{children:`сравнение массивов стабильных ссылок из одного cache snapshot.`}),`
+`]}),`
+`,(0,c.jsx)(t.h2,{id:`перемещение-элементов`,children:`Перемещение элементов`}),`
+`,(0,c.jsx)(t.h3,{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.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`moveItem`})}),(0,c.jsxs)(t.td,{children:[`Числовыми индексами `,(0,c.jsx)(t.code,{children:`from`}),` и `,(0,c.jsx)(t.code,{children:`to`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`moveArrayItem`})}),(0,c.jsxs)(t.td,{children:[`Числовыми индексами `,(0,c.jsx)(t.code,{children:`fromIndex`}),` и `,(0,c.jsx)(t.code,{children:`toIndex`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`moveArrayItemByIndex`})}),(0,c.jsxs)(t.td,{children:[`Исходным `,(0,c.jsx)(t.code,{children:`index`}),` и действием `,(0,c.jsx)(t.code,{children:`start/end/up/down`}),`.`]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Для обычного массива без элементов `,(0,c.jsx)(t.code,{children:`undefined`}),`:`]}),`
+`,(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:`0`}),` или не меньше длины считается некорректным;`]}),`
+`,(0,c.jsx)(t.li,{children:`одинаковые исходный и целевой индексы дают копию без перестановки.`}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Передавайте только конечные целые индексы: `,(0,c.jsx)(t.code,{children:`0`}),`, `,(0,c.jsx)(t.code,{children:`1`}),`, `,(0,c.jsx)(t.code,{children:`2`}),` и так далее. Дробные значения, `,(0,c.jsx)(t.code,{children:`NaN`}),` и `,(0,c.jsx)(t.code,{children:`Infinity`}),` не являются частью поддерживаемого контракта.`]}),`
+`,(0,c.jsx)(t.h3,{id:`moveitem`,children:(0,c.jsx)(t.code,{children:`moveItem`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function moveItem<T>(items: readonly T[], from: number, to: number): T[];
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = ["A", "B", "C", "D"];
+
+console.log(moveItem(source, 0, 2));
+// ["B", "C", "A", "D"]
+
+console.log(moveItem(source, 3, 1));
+// ["A", "D", "B", "C"]
+
+console.log(source);
+// ["A", "B", "C", "D"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Некорректный индекс не вызывает исключение:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = ["A", "B", "C"];
+const result = moveItem(source, -1, 2);
+
+console.log(result); // ["A", "B", "C"]
+console.log(result === source); // false
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`movearrayitem`,children:(0,c.jsx)(t.code,{children:`moveArrayItem`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function moveArrayItem<T>(items: readonly T[], fromIndex: number, toIndex: number): T[];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для массивов с определёнными элементами поведение совпадает с `,(0,c.jsx)(t.code,{children:`moveItem`}),`. Имя `,(0,c.jsx)(t.code,{children:`moveArrayItem`}),` явно сообщает, что функция перемещает элемент массива.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const columns = ["name", "email", "phone"];
+const nextColumns = moveArrayItem(columns, 2, 0);
+
+console.log(nextColumns);
+// ["phone", "name", "email"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример с React state:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const [columnIds, setColumnIds] = useState(["name", "email", "phone"]);
+
+function moveColumn(fromIndex: number, toIndex: number) {
+	setColumnIds((currentIds) => moveArrayItem(currentIds, fromIndex, toIndex));
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`reorderaction`,children:(0,c.jsx)(t.code,{children:`ReorderAction`})}),`
+`,(0,c.jsx)(t.p,{children:`Тип:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type ReorderAction = "start" | "end" | "up" | "down";
+`})}),`
+`,(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:`"start"`})}),(0,c.jsxs)(t.td,{children:[`Переместить элемент на индекс `,(0,c.jsx)(t.code,{children:`0`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"end"`})}),(0,c.jsx)(t.td,{children:`Переместить элемент на последний индекс.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"up"`})}),(0,c.jsx)(t.td,{children:`Переместить элемент на одну позицию ближе к началу массива.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"down"`})}),(0,c.jsx)(t.td,{children:`Переместить элемент на одну позицию ближе к концу массива.`})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[`Это техническое действие, а не направление на экране. Для вертикального списка `,(0,c.jsx)(t.code,{children:`"up"`}),` обычно означает визуально вверх, но для горизонтального списка интерпретация интерфейса остаётся ответственностью приложения.`]}),`
+`,(0,c.jsx)(t.h3,{id:`movearrayitembyindex`,children:(0,c.jsx)(t.code,{children:`moveArrayItemByIndex`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function moveArrayItemByIndex<T>(items: readonly T[], index: number, action: ReorderAction): T[];
+`})}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const items = ["A", "B", "C", "D"];
+
+console.log(moveArrayItemByIndex(items, 2, "start"));
+// ["C", "A", "B", "D"]
+
+console.log(moveArrayItemByIndex(items, 1, "end"));
+// ["A", "C", "D", "B"]
+
+console.log(moveArrayItemByIndex(items, 2, "up"));
+// ["A", "C", "B", "D"]
+
+console.log(moveArrayItemByIndex(items, 1, "down"));
+// ["A", "C", "B", "D"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Действие на границе возвращает копию без перестановки:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const items = ["A", "B", "C"];
+
+console.log(moveArrayItemByIndex(items, 0, "up"));
+// ["A", "B", "C"]
+
+console.log(moveArrayItemByIndex(items, 2, "down"));
+// ["A", "B", "C"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пример обработчика кнопок:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function reorderColumn(columnIds: readonly string[], activeIndex: number, action: ReorderAction) {
+	return moveArrayItemByIndex(columnIds, activeIndex, action);
+}
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`ограничение-для-undefined`,children:[`Ограничение для `,(0,c.jsx)(t.code,{children:`undefined`})]}),`
+`,(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 unsupported = ["A", undefined, "C"];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Внутренняя проверка извлечённого элемента использует `,(0,c.jsx)(t.code,{children:`item === undefined`}),`. Из-за этого `,(0,c.jsx)(t.code,{children:`undefined`}),` нельзя отличить от отсутствующего элемента, а результат разных функций в таком сценарии не является надёжным контрактом. Сначала отфильтруйте или замените такие значения.`]}),`
+`,(0,c.jsx)(t.h2,{id:`нормализация-строк-и-объектов`,children:`Нормализация строк и объектов`}),`
+`,(0,c.jsx)(t.p,{children:`Нормализация — преобразование разных вариантов одного логического значения в единый канонический вид.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Например, строки `,(0,c.jsx)(t.code,{children:`" A "`}),`, `,(0,c.jsx)(t.code,{children:`"A"`}),` и повторная `,(0,c.jsx)(t.code,{children:`"A"`}),` после обрезки пробелов представляют один ID `,(0,c.jsx)(t.code,{children:`"A"`}),`.`]}),`
+`,(0,c.jsx)(t.p,{children:`Нормализаторы изменяют представление данных. Поэтому вызывайте их на явно выбранной границе:`}),`
+`,(0,c.jsxs)(t.ul,{children:[`
+`,(0,c.jsx)(t.li,{children:`при восстановлении сохранённой конфигурации;`}),`
+`,(0,c.jsx)(t.li,{children:`перед созданием save snapshot;`}),`
+`,(0,c.jsx)(t.li,{children:`при принятии внешнего payload;`}),`
+`,(0,c.jsx)(t.li,{children:`перед сравнением или построением identity, если это предусмотрено контрактом.`}),`
+`]}),`
+`,(0,c.jsx)(t.p,{children:`Не записывайте нормализованный результат обратно в пользовательский draft во время обычного ввода, если интерфейс должен сохранять введённое значение буквально.`}),`
+`,(0,c.jsx)(t.h3,{id:`normalizestringarray`,children:(0,c.jsx)(t.code,{children:`normalizeStringArray`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function normalizeStringArray(items: readonly string[] | undefined): string[] | undefined;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`применяет `,(0,c.jsx)(t.code,{children:`trim()`}),` к каждой строке;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`удаляет пустые строки после `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`удаляет повторы после `,(0,c.jsx)(t.code,{children:`trim()`}),`;`]}),`
+`,(0,c.jsx)(t.li,{children:`сохраняет первое вхождение и его порядок;`}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если полезных значений не осталось.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = normalizeStringArray([" A ", "", "A", "B ", "   "]);
+
+console.log(result); // ["A", "B"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Пустые варианты:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(normalizeStringArray(undefined)); // undefined
+console.log(normalizeStringArray([])); // undefined
+console.log(normalizeStringArray([" ", "\\t"])); // undefined
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Регистр не меняется:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(normalizeStringArray(["A", "a", " A "]));
+// ["A", "a"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Внутренние пробелы не схлопываются:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(normalizeStringArray(["  Новая   группа  "]));
+// ["Новая   группа"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если вызывающему коду всегда нужен массив:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const ids = normalizeStringArray(rawIds) ?? [];
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужно сохранить различие между «значение отсутствует» и «передан пустой массив», не заменяйте `,(0,c.jsx)(t.code,{children:`undefined`}),` автоматически — выберите поведение на своей boundary.`]}),`
+`,(0,c.jsx)(t.h3,{id:`normalizeobjects`,children:(0,c.jsx)(t.code,{children:`normalizeObjects`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function normalizeObjects<T, K extends keyof T, O = T>(
+	items: readonly T[] | undefined,
+	key: K,
+	copyist?: ((item: T, normalizedKey: T[K]) => O) | false
+): O[] | undefined;
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Фактическая сигнатура третьего параметра допускает либо callback, либо отдельное значение `,(0,c.jsx)(t.code,{children:`false`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`copyist?: ((item: T, key: T[K]) => O) | false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Функция предназначена для объектов со строковым ключевым полем:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type Item = {
+	id: string;
+	label: string;
+};
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Она:`}),`
+`,(0,c.jsxs)(t.ol,{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:`trim()`}),`;`]}),`
+`,(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.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, если результат пуст.`]}),`
+`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Числовое, boolean, объектное, `,(0,c.jsx)(t.code,{children:`null`}),` или `,(0,c.jsx)(t.code,{children:`undefined`}),` значение выбранного поля считается невалидным и удаляется. Несмотря на общий TypeScript generic, на практике `,(0,c.jsx)(t.code,{children:`key`}),` должен указывать на строковое поле.`]}),`
+`,(0,c.jsx)(t.h4,{id:`режим-по-умолчанию-поверхностная-копия`,children:`Режим по умолчанию: поверхностная копия`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = [
+	{ id: " A ", label: "Первый" },
+	{ id: "", label: "Пустой" },
+	{ id: "A", label: "Дубликат" },
+	{ id: "B", label: "Второй" }
+];
+
+const result = normalizeObjects(source, "id");
+
+console.log(result);
+// [
+//   { id: " A ", label: "Первый" },
+//   { id: "B", label: "Второй" }
+// ]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Обратите внимание: нормализованный ключ используется для проверки пустоты и дубликатов, но в стандартной поверхностной копии исходное поле не перезаписывается. Поэтому первый объект сохранил `,(0,c.jsx)(t.code,{children:`id: " A "`}),`.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(result?.[0] !== source[0]); // true
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Вложенные объекты остаются общими:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const settings = { visible: true };
+const source = [{ id: "A", settings }];
+const result = normalizeObjects(source, "id");
+
+console.log(result?.[0].settings === settings); // true
+`})}),`
+`,(0,c.jsx)(t.h4,{id:`callback-построение-канонического-результата`,children:`Callback: построение канонического результата`}),`
+`,(0,c.jsx)(t.p,{children:`Callback получает исходный объект и нормализованный ключ. Используйте его, если нужно записать нормализованное значение в результат или изменить форму объекта:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = [
+	{ id: " A ", value: 1 },
+	{ id: "A", value: 2 },
+	{ id: " B ", value: 3 }
+];
+
+const result = normalizeObjects(source, "id", (item, normalizedId) => ({
+	id: normalizedId,
+	label: String(item.value)
+}));
+
+console.log(result);
+// [
+//   { id: "A", label: "1" },
+//   { id: "B", label: "3" }
+// ]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`TypeScript выводит тип возвращаемых объектов из callback:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Тип result:
+// Array<{ id: string; label: string }> | undefined
+`})}),`
+`,(0,c.jsxs)(t.h4,{id:`copyist--false-сохранить-исходные-ссылки`,children:[(0,c.jsx)(t.code,{children:`copyist = false`}),`: сохранить исходные ссылки`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если третьим аргументом передать `,(0,c.jsx)(t.code,{children:`false`}),`, функция не копирует сохранённые объекты:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = [{ id: "A", value: 1 }];
+const result = normalizeObjects(source, "id", false);
+
+console.log(result?.[0] === source[0]); // true
+console.log(result === source); // false: внешний массив всё равно новый.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Используйте этот режим только когда общие ссылки являются ожидаемым поведением.`}),`
+`,(0,c.jsx)(t.h4,{id:`пустой-результат`,children:`Пустой результат`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`console.log(normalizeObjects(undefined, "id")); // undefined
+console.log(normalizeObjects([], "id")); // undefined
+console.log(normalizeObjects([{ id: " " }], "id")); // undefined
+`})}),`
+`,(0,c.jsxs)(t.h4,{id:`частые-ошибки-с-normalizeobjects`,children:[`Частые ошибки с `,(0,c.jsx)(t.code,{children:`normalizeObjects`})]}),`
+`,(0,c.jsx)(t.p,{children:`Неверно ожидать, что стандартный режим перезапишет ключ:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = normalizeObjects([{ id: " A " }], "id");
+
+console.log(result?.[0].id); // " A ", а не "A".
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Для канонического ключа нужен callback:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = normalizeObjects([{ id: " A " }], "id", (item, normalizedId) => ({
+	...item,
+	id: normalizedId
+}));
+
+console.log(result?.[0].id); // "A"
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Неверно выбирать числовое поле:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const source = [{ id: 1, label: "Первый" }];
+const result = normalizeObjects(source, "id");
+
+console.log(result); // undefined
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если уникальность должна определяться числом без строковой нормализации, используйте другую функцию или явный mapper, соответствующий вашему контракту.`}),`
+`,(0,c.jsx)(t.h3,{id:`addunique`,children:(0,c.jsx)(t.code,{children:`addUnique`})}),`
+`,(0,c.jsx)(t.p,{children:`Сигнатура:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`function addUnique(target: string[], seen: Set<string>, fieldId: string | undefined): void;
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Это единственная намеренно мутирующая функция модуля. Она:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[`применяет `,(0,c.jsx)(t.code,{children:`trim()`}),` к `,(0,c.jsx)(t.code,{children:`fieldId`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`ничего не делает для `,(0,c.jsx)(t.code,{children:`undefined`}),` или пустой строки;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`проверяет нормализованный ID в `,(0,c.jsx)(t.code,{children:`seen`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`добавляет новый ID одновременно в `,(0,c.jsx)(t.code,{children:`seen`}),` и в конец `,(0,c.jsx)(t.code,{children:`target`}),`;`]}),`
+`,(0,c.jsxs)(t.li,{children:[`возвращает `,(0,c.jsx)(t.code,{children:`void`}),`.`]}),`
+`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const target: string[] = [];
+const seen = new Set<string>();
+
+addUnique(target, seen, " A ");
+addUnique(target, seen, "A");
+addUnique(target, seen, " ");
+addUnique(target, seen, "B");
+
+console.log(target); // ["A", "B"]
+console.log([...seen]); // ["A", "B"]
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`seen`}),` является источником истины для проверки дублей. Передавайте один и тот же `,(0,c.jsx)(t.code,{children:`Set`}),` на протяжении всей операции:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const target: string[] = [];
+const seen = new Set<string>();
+
+for (const field of fields) {
+	addUnique(target, seen, field.id);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Если `,(0,c.jsx)(t.code,{children:`target`}),` уже заполнен, сначала синхронизируйте `,(0,c.jsx)(t.code,{children:`seen`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const target = normalizeStringArray(existingIds) ?? [];
+const seen = new Set(target);
+
+for (const id of additionalIds) {
+	addUnique(target, seen, id);
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не создавайте новый `,(0,c.jsx)(t.code,{children:`Set`}),` при каждом вызове:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно: каждый вызов забывает ранее добавленные значения.
+addUnique(target, new Set(), "A");
+addUnique(target, new Set(), "A");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Для нормализации уже готового массива проще использовать `,(0,c.jsx)(t.code,{children:`normalizeStringArray`}),`.`]}),`
+`,(0,c.jsx)(t.h2,{id:`готовые-рецепты`,children:`Готовые рецепты`}),`
+`,(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:`в сохранённой конфигурации есть порядок ID;`}),`
+`,(0,c.jsx)(t.li,{children:`часть ID устарела;`}),`
+`,(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:`type Column = {
+	id: string;
+	label: string;
+};
+
+const columns: Column[] = [
+	{ id: "name", label: "Имя" },
+	{ id: "email", label: "E-mail" },
+	{ id: "phone", label: "Телефон" }
+];
+
+const savedOrder = [" phone ", "removed", "name", "name"];
+
+const availableIds = columns.map((column) => column.id);
+
+const normalizedSavedOrder = normalizeStringArray(savedOrder);
+
+const validSavedOrder = filterAndDeduplicateIds(normalizedSavedOrder, availableIds);
+
+const completeOrder = appendMissingIds(validSavedOrder, availableIds);
+
+const columnsById = new Map(columns.map((column) => [column.id, column]));
+
+const orderedColumns = pickExistingMapValues(completeOrder, columnsById);
+
+console.log(completeOrder);
+// ["phone", "name", "email"]
+
+console.log(orderedColumns.map((column) => column.label));
+// ["Телефон", "Имя", "E-mail"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Каждый шаг имеет отдельную ответственность:`}),`
+`,(0,c.jsxs)(t.ol,{children:[`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`normalizeStringArray`}),` обрезает пробелы и удаляет пустые значения;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`}),` удаляет неизвестные ID;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`appendMissingIds`}),` добавляет новые ID;`]}),`
+`,(0,c.jsxs)(t.li,{children:[(0,c.jsx)(t.code,{children:`pickExistingMapValues`}),` восстанавливает объекты в нужном порядке.`]}),`
+`]}),`
+`,(0,c.jsx)(t.h3,{id:`сгруппировать-данные-для-ui`,children:`Сгруппировать данные для UI`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const groups = arrayGroupByToArray(employees, "department");
+
+const viewModel = groups.map((group) => ({
+	department: group.key,
+	count: group.items.length,
+	employees: group.items
+}));
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если нужен обязательный порядок подразделений:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const departmentOrder = ["Руководство", "Продажи", "ИТ"];
+
+const orderByDepartment = new Map(departmentOrder.map((name, index) => [name, index]));
+
+const groups = arrayGroupByToArray(employees, "department").sort((left, right) => {
+	return (orderByDepartment.get(left.key) ?? Number.MAX_SAFE_INTEGER) - (orderByDepartment.get(right.key) ?? Number.MAX_SAFE_INTEGER);
+});
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`построить-словарь-и-сохранить-первое-значение`,children:`Построить словарь и сохранить первое значение`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const metadataByFieldId = arrayToMap(metadataColumns, "fieldId");
+
+const selectedMetadata = metadataByFieldId[selectedFieldId];
+
+if (!selectedMetadata) {
+	throw new Error(\`Не найдена metadata для поля \${selectedFieldId}\`);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`удалить-дубли-объектов-по-id`,children:`Удалить дубли объектов по ID`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const uniqueUsers = arrayUniqueBy(users, "id");
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не заменяйте это на `,(0,c.jsx)(t.code,{children:`arrayDeduplicate(users)`}),`, если одинаковые пользователи представлены разными объектами.`]}),`
+`,(0,c.jsx)(t.h3,{id:`переместить-элемент-по-команде-интерфейса`,children:`Переместить элемент по команде интерфейса`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type MoveCommand = {
+	activeIndex: number;
+	action: ReorderAction;
+};
+
+function applyMove(currentIds: readonly string[], command: MoveCommand) {
+	return moveArrayItemByIndex(currentIds, command.activeIndex, command.action);
+}
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`подготовить-канонический-save-snapshot`,children:`Подготовить канонический save snapshot`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`type DraftItem = {
+	id: string;
+	label: string;
+};
+
+function createSaveSnapshot(draftItems: readonly DraftItem[]) {
+	return (
+		normalizeObjects(draftItems, "id", (item, normalizedId) => ({
+			...item,
+			id: normalizedId,
+			label: item.label.trim()
+		})) ?? []
+	);
+}
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Такой normalizer следует вызывать на границе сохранения. Обычный setter draft должен хранить пользовательский ввод буквально, если контракт приложения не говорит обратного.`}),`
+`,(0,c.jsx)(t.h2,{id:`производительность`,children:`Производительность`}),`
+`,(0,c.jsxs)(t.p,{children:[`Обозначение `,(0,c.jsx)(t.code,{children:`n`}),` — количество элементов входного массива.`]}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`Функция`}),(0,c.jsx)(t.th,{children:`Типичная сложность по времени`}),(0,c.jsx)(t.th,{children:`Дополнительная память`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayGroupBy`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsx)(t.td,{children:`Объект групп и новые массивы групп.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayGroupByToArray`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsx)(t.td,{children:`Объект групп, массив групп и массивы элементов.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayToMap`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsx)(t.td,{children:`Объект-словарь.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayUniqueBy`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsxs)(t.td,{children:[`Новый массив и `,(0,c.jsx)(t.code,{children:`Set`}),` строковых ключей.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayDeduplicate`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsxs)(t.td,{children:[`Новый массив и `,(0,c.jsx)(t.code,{children:`Set`}),` значений.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n + m)`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`Map`}),` разрешённых ID, `,(0,c.jsx)(t.code,{children:`Set`}),` и результат.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`appendMissingIds`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n + m)`})}),(0,c.jsxs)(t.td,{children:[`Копия массива и `,(0,c.jsx)(t.code,{children:`Set`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`pickExistingMapValues`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`O(n)`}),` в среднем`]}),(0,c.jsx)(t.td,{children:`Новый массив.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arraysEqual`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`O(n)`}),` в худшем случае`]}),(0,c.jsx)(t.td,{children:`Постоянная память; может завершиться на первом различии.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:`Функции перемещения`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsx)(t.td,{children:`Копия массива.`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeStringArray`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsxs)(t.td,{children:[`Новый массив и `,(0,c.jsx)(t.code,{children:`Set`}),`.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`normalizeObjects`})}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`O(n)`})}),(0,c.jsxs)(t.td,{children:[`Новый массив, `,(0,c.jsx)(t.code,{children:`Set`}),`, обычно поверхностные копии объектов.`]})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`addUnique`})}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`O(1)`}),` в среднем за вызов`]}),(0,c.jsxs)(t.td,{children:[`Новое значение в переданных `,(0,c.jsx)(t.code,{children:`Set`}),` и массиве.`]})]})]})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`m`}),` — количество элементов второго массива (`,(0,c.jsx)(t.code,{children:`allowedIds`}),` или `,(0,c.jsx)(t.code,{children:`idsToAppend`}),`).`]}),`
+`,(0,c.jsx)(t.p,{children:`Для обычных UI-списков стоимость функций обычно несущественна. Для очень больших массивов не вызывайте одно и то же преобразование многократно внутри цикла или каждого render без необходимости.`}),`
+`,(0,c.jsx)(t.p,{children:`В React вычисление можно мемоизировать, если входные ссылки стабильны и преобразование действительно заметно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`const usersById = useMemo(() => arrayToMap(users, "id"), [users]);
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Не добавляйте `,(0,c.jsx)(t.code,{children:`useMemo`}),` автоматически для маленьких массивов: сама мемоизация тоже усложняет код и имеет стоимость.`]}),`
+`,(0,c.jsx)(t.h2,{id:`ограничения-и-частые-ошибки`,children:`Ограничения и частые ошибки`}),`
+`,(0,c.jsx)(t.h3,{id:`неправильный-entrypoint`,children:`Неправильный entrypoint`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`// Неправильно.
+import { arraysEqual } from "@ryuzaki13/react-foundation-lib";
+
+// Правильно.
+import { arraysEqual } from "@ryuzaki13/react-foundation-lib/array";
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-глубокого-клонирования`,children:`Ожидание глубокого клонирования`}),`
+`,(0,c.jsx)(t.p,{children:`Функции работают с внешним массивом и ссылками. Они не создают независимую копию всего дерева данных.`}),`
+`,(0,c.jsxs)(t.p,{children:[`Для сериализуемой конфигурации, которой действительно нужна глубокая копия, используйте профильную clone-утилиту из `,(0,c.jsx)(t.code,{children:`@ryuzaki13/react-foundation-lib/utils`}),` в соответствии с её контрактом.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-глубокого-сравнения`,children:`Ожидание глубокого сравнения`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`arraysEqual([{ id: "A" }], [{ id: "A" }]); // false
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Сначала сформируйте сравниваемую identity:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`arraysEqual(
+	left.map((item) => item.id),
+	right.map((item) => item.id)
+);
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`потеря-различия-между-undefined-и-`,children:[`Потеря различия между `,(0,c.jsx)(t.code,{children:`undefined`}),` и `,(0,c.jsx)(t.code,{children:`[]`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeStringArray`}),` и `,(0,c.jsx)(t.code,{children:`normalizeObjects`}),` могут вернуть `,(0,c.jsx)(t.code,{children:`undefined`}),`. Это часть их контракта.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const normalized = normalizeStringArray(raw);
+
+if (normalized === undefined) {
+	// Полезных значений нет.
+}
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Используйте `,(0,c.jsx)(t.code,{children:`?? []`}),` только если ваш вызывающий контракт действительно требует массив.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`ожидание-автоматического-trim`,children:[`Ожидание автоматического `,(0,c.jsx)(t.code,{children:`trim`})]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`}),`, `,(0,c.jsx)(t.code,{children:`appendMissingIds`}),`, `,(0,c.jsx)(t.code,{children:`arrayUniqueBy`}),`, `,(0,c.jsx)(t.code,{children:`arrayGroupBy`}),` и `,(0,c.jsx)(t.code,{children:`arrayToMap`}),` не обрезают строки.`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`arrayUniqueBy([{ id: "A" }, { id: " A " }], "id"); // Останутся два объекта.
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Если пробелы нужно игнорировать, нормализуйте значение на явно выбранной boundary.`}),`
+`,(0,c.jsx)(t.h3,{id:`использование-произвольного-значения-как-ключа-обычного-объекта`,children:`Использование произвольного значения как ключа обычного объекта`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`arrayGroupBy`}),`, `,(0,c.jsx)(t.code,{children:`arrayGroupByToArray`}),` и `,(0,c.jsx)(t.code,{children:`arrayToMap`}),` используют `,(0,c.jsx)(t.code,{children:`Record`}),`, а не `,(0,c.jsx)(t.code,{children:`Map`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Не передавайте в них непроверенные ключи, которые могут быть равны `,(0,c.jsx)(t.code,{children:`"__proto__"`}),`, `,(0,c.jsx)(t.code,{children:`"constructor"`}),` или `,(0,c.jsx)(t.code,{children:`"toString"`}),`. Для произвольных внешних значений используйте `,(0,c.jsx)(t.code,{children:`Map`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`ожидание-порядка-групп-для-числовых-строк`,children:`Ожидание порядка групп для числовых строк`}),`
+`,(0,c.jsxs)(t.p,{children:[`Группа `,(0,c.jsx)(t.code,{children:`"2"`}),` может оказаться раньше группы `,(0,c.jsx)(t.code,{children:`"10"`}),` независимо от первого появления. Если порядок важен, сортируйте результат `,(0,c.jsx)(t.code,{children:`arrayGroupByToArray`}),` явно.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`передача-undefined-как-перемещаемого-элемента`,children:[`Передача `,(0,c.jsx)(t.code,{children:`undefined`}),` как перемещаемого элемента`]}),`
+`,(0,c.jsx)(t.p,{children:`Функции перемещения предназначены для плотных массивов определённых значений. Предварительно очистите массив:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const definedItems = items.filter((item): item is Item => item !== undefined);
+`})}),`
+`,(0,c.jsxs)(t.h3,{id:`использование-addunique-как-pure-function`,children:[`Использование `,(0,c.jsx)(t.code,{children:`addUnique`}),` как pure function`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`addUnique`}),` меняет аргументы и возвращает `,(0,c.jsx)(t.code,{children:`void`}),`:`]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const result = addUnique(target, seen, id);
+
+console.log(result); // undefined
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[`Проверяйте изменившийся `,(0,c.jsx)(t.code,{children:`target`}),`, а не return value.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`несинхронизированные-target-и-seen`,children:[`Несинхронизированные `,(0,c.jsx)(t.code,{children:`target`}),` и `,(0,c.jsx)(t.code,{children:`seen`})]}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const target = ["A"];
+const seen = new Set<string>();
+
+addUnique(target, seen, "A");
+
+console.log(target); // ["A", "A"]
+`})}),`
+`,(0,c.jsx)(t.p,{children:`Правильно:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`const target = ["A"];
+const seen = new Set(target);
+`})}),`
+`,(0,c.jsx)(t.h3,{id:`нормализация-draft-во-время-ввода`,children:`Нормализация draft во время ввода`}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`normalizeStringArray`}),` и `,(0,c.jsx)(t.code,{children:`normalizeObjects`}),` меняют пользовательское представление: обрезают ключи, удаляют пустые значения и дубли. Не применяйте их внутри обычного store setter, если draft должен сохранять ввод буквально.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Например, строка `,(0,c.jsx)(t.code,{children:`"Новая группа "`}),` должна оставаться с завершающим пробелом до явно определённой границы сохранения или восстановления.`]}),`
+`,(0,c.jsx)(t.h2,{id:`краткий-справочник-api`,children:`Краткий справочник API`}),`
+`,(0,c.jsx)(t.p,{children:`Все значения импортируются из:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-ts`,children:`import {
+	addUnique,
+	appendMissingIds,
+	arrayDeduplicate,
+	arrayGroupBy,
+	arrayGroupByToArray,
+	arrayToMap,
+	arrayUniqueBy,
+	arraysEqual,
+	filterAndDeduplicateIds,
+	moveArrayItem,
+	moveArrayItemByIndex,
+	moveItem,
+	normalizeObjects,
+	normalizeStringArray,
+	pickExistingMapValues,
+	type ReorderAction
+} from "@ryuzaki13/react-foundation-lib/array";
+`})}),`
+`,(0,c.jsxs)(t.table,{children:[(0,c.jsx)(t.thead,{children:(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.th,{children:`API`}),(0,c.jsx)(t.th,{children:`Вход`}),(0,c.jsx)(t.th,{children:`Результат`}),(0,c.jsx)(t.th,{children:`Изменяет аргументы`})]})}),(0,c.jsxs)(t.tbody,{children:[(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayGroupBy`})}),(0,c.jsx)(t.td,{children:`Массив объектов, имя поля`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Record<string, T[]>`})}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayGroupByToArray`})}),(0,c.jsx)(t.td,{children:`Массив объектов, имя поля`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Array<{ key: string; items: T[] }>`})}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayToMap`})}),(0,c.jsx)(t.td,{children:`Массив объектов, имя поля`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`Record<string, T>`})}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayUniqueBy`})}),(0,c.jsx)(t.td,{children:`Массив объектов, имя поля`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`T[]`}),` без повторных строковых ключей`]}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`arrayDeduplicate`})}),(0,c.jsx)(t.td,{children:`Массив значений`}),(0,c.jsxs)(t.td,{children:[(0,c.jsx)(t.code,{children:`T[]`}),` без повторных значений или ссылок`]}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`filterAndDeduplicateIds`})}),(0,c.jsxs)(t.td,{children:[`ID или `,(0,c.jsx)(t.code,{children:`undefined`}),`, разрешённые ID`]}),(0,c.jsx)(t.td,{children:`Валидные уникальные ID`}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`appendMissingIds`})}),(0,c.jsx)(t.td,{children:`Базовые ID, добавляемые ID`}),(0,c.jsx)(t.td,{children:`Копия с отсутствующими ID в конце`}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`pickExistingMapValues`})}),(0,c.jsxs)(t.td,{children:[`Порядок ключей, `,(0,c.jsx)(t.code,{children:`ReadonlyMap`})]}),(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:`arraysEqual`})}),(0,c.jsx)(t.td,{children:`Два массива`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`boolean`})}),(0,c.jsx)(t.td,{children:`Нет`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`moveItem`})}),(0,c.jsxs)(t.td,{children:[`Массив, `,(0,c.jsx)(t.code,{children:`from`}),`, `,(0,c.jsx)(t.code,{children:`to`})]}),(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:`moveArrayItem`})}),(0,c.jsxs)(t.td,{children:[`Массив, `,(0,c.jsx)(t.code,{children:`fromIndex`}),`, `,(0,c.jsx)(t.code,{children:`toIndex`})]}),(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:`moveArrayItemByIndex`})}),(0,c.jsxs)(t.td,{children:[`Массив, `,(0,c.jsx)(t.code,{children:`index`}),`, `,(0,c.jsx)(t.code,{children:`ReorderAction`})]}),(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:`normalizeStringArray`})}),(0,c.jsxs)(t.td,{children:[`Строки или `,(0,c.jsx)(t.code,{children:`undefined`})]}),(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:(0,c.jsx)(t.code,{children:`normalizeObjects`})}),(0,c.jsxs)(t.td,{children:[`Объекты, строковое поле, callback или `,(0,c.jsx)(t.code,{children:`false`})]}),(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:(0,c.jsx)(t.code,{children:`addUnique`})}),(0,c.jsxs)(t.td,{children:[`Изменяемый массив, `,(0,c.jsx)(t.code,{children:`Set`}),`, строка или `,(0,c.jsx)(t.code,{children:`undefined`})]}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`void`})}),(0,c.jsx)(t.td,{children:`Да`})]}),(0,c.jsxs)(t.tr,{children:[(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`ReorderAction`})}),(0,c.jsx)(t.td,{children:`TypeScript type`}),(0,c.jsx)(t.td,{children:(0,c.jsx)(t.code,{children:`"start" | "end" | "up" | "down"`})}),(0,c.jsx)(t.td,{children:`Не применимо`})]})]})]}),`
+`,(0,c.jsx)(t.h2,{id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-функции-принимают-readonly-t-но-возвращают-t`,children:[`Почему функции принимают `,(0,c.jsx)(t.code,{children:`readonly T[]`}),`, но возвращают `,(0,c.jsx)(t.code,{children:`T[]`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`readonly`}),` запрещает функции изменять входной массив. Результат создаётся заново и может быть изменяемым. Это позволяет безопасно передавать как обычные массивы, так и readonly-массивы.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-arraytomap-называется-map-но-возвращает-объект`,children:[`Почему `,(0,c.jsx)(t.code,{children:`arrayToMap`}),` называется `,(0,c.jsx)(t.code,{children:`Map`}),`, но возвращает объект?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Имя описывает идею сопоставления ключа и значения. Фактический тип результата — `,(0,c.jsx)(t.code,{children:`Record<string, T>`}),`, поэтому доступ выполняется как `,(0,c.jsx)(t.code,{children:`result[id]`}),`, а не `,(0,c.jsx)(t.code,{children:`result.get(id)`}),`.`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Если нужен ключ не строкового типа, гарантированное сохранение порядка вставки или безопасная работа с произвольными внешними ключами, используйте встроенный `,(0,c.jsx)(t.code,{children:`Map`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-arraysequal-возвращает-false-для-одинаково-выглядящих-объектов`,children:[`Почему `,(0,c.jsx)(t.code,{children:`arraysEqual`}),` возвращает `,(0,c.jsx)(t.code,{children:`false`}),` для одинаково выглядящих объектов?`]}),`
+`,(0,c.jsx)(t.p,{children:`Потому что функция использует строгое сравнение элементов. Отдельно созданные объекты имеют разные ссылки. Сравните стабильные ID или используйте предметный comparator.`}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-arraydeduplicate-не-удалил-одинаковые-объекты`,children:[`Почему `,(0,c.jsx)(t.code,{children:`arrayDeduplicate`}),` не удалил одинаковые объекты?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Она удаляет повторные ссылки, а не объекты с одинаковыми полями. Для уникальности по полю используйте `,(0,c.jsx)(t.code,{children:`arrayUniqueBy`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-normalizeobjects-не-записал-обрезанный-ключ-в-объект`,children:[`Почему `,(0,c.jsx)(t.code,{children:`normalizeObjects`}),` не записал обрезанный ключ в объект?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`В режиме по умолчанию нормализованный ключ используется только для проверки пустоты и дублей. Результат содержит поверхностную копию исходного объекта. Передайте callback и явно запишите `,(0,c.jsx)(t.code,{children:`normalizedKey`}),`.`]}),`
+`,(0,c.jsxs)(t.h3,{id:`почему-normalizer-возвращает-undefined-а-не-`,children:[`Почему normalizer возвращает `,(0,c.jsx)(t.code,{children:`undefined`}),`, а не `,(0,c.jsx)(t.code,{children:`[]`}),`?`]}),`
+`,(0,c.jsxs)(t.p,{children:[`Так контракт позволяет обозначить отсутствие полезной конфигурации. Если вашему коду нужен пустой массив, используйте `,(0,c.jsx)(t.code,{children:`normalizeStringArray(value) ?? []`}),` или `,(0,c.jsx)(t.code,{children:`normalizeObjects(value, "id") ?? []`}),`.`]}),`
+`,(0,c.jsx)(t.h3,{id:`можно-ли-использовать-функции-в-react-state`,children:`Можно ли использовать функции в React state?`}),`
+`,(0,c.jsx)(t.p,{children:`Да. Функции перемещения и большинство преобразований возвращают новый массив, поэтому подходят для функционального обновления state:`}),`
+`,(0,c.jsx)(t.pre,{children:(0,c.jsx)(t.code,{className:`language-tsx`,children:`setItems((currentItems) => moveArrayItem(currentItems, fromIndex, toIndex));
+`})}),`
+`,(0,c.jsxs)(t.p,{children:[(0,c.jsx)(t.code,{children:`addUnique`}),` мутирует аргументы, поэтому не вызывайте её напрямую над текущим state-массивом. Сначала создайте копию или соберите новый результат вне state.`]}),`
+`,(0,c.jsx)(t.h3,{id:`меняют-ли-функции-вложенные-объекты`,children:`Меняют ли функции вложенные объекты?`}),`
+`,(0,c.jsx)(t.p,{children:`Нет, но обычно сохраняют ссылки на них. Если вызывающий код затем мутирует вложенный объект через результат, это изменение будет видно и через исходные данные.`}),`
+`,(0,c.jsxs)(t.h3,{id:`считаются-ли-a-и-a-дублями`,children:[`Считаются ли `,(0,c.jsx)(t.code,{children:`"A"`}),` и `,(0,c.jsx)(t.code,{children:`"a"`}),` дублями?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет. Сравнение строк чувствительно к регистру. Если регистр не должен иметь значения, создайте отдельное нормализованное identity в своём предметном контракте.`}),`
+`,(0,c.jsxs)(t.h3,{id:`нужно-ли-оборачивать-каждый-вызов-в-trycatch`,children:[`Нужно ли оборачивать каждый вызов в `,(0,c.jsx)(t.code,{children:`try/catch`}),`?`]}),`
+`,(0,c.jsx)(t.p,{children:`Нет, если аргументы соответствуют TypeScript-сигнатуре. Эти функции не используют сеть и не выполняют асинхронные операции. Ошибка обычно означает нарушение контракта входных данных, которое нужно исправить или валидировать на внешней boundary.`})]})}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};