@dxtmisha/wiki 0.39.1 → 0.39.3

package/src/media/functional/functional-basic/functions/removeCommonPrefix/removeCommonPrefix.en.mdx

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/removeCommonPrefix - Remove common prefix'/>
+
+# `removeCommonPrefix`
+
+Removes a common prefix from the beginning of the main string. If the main string starts with the specified prefix, the function trims it and returns the string without leading and trailing whitespaces.
+
+**Parameters:**
+- `mainStr: string` — The main string.
+- `prefix: string` — The prefix string to remove.
+
+**Returns:**
+`string` — A new string without the prefix and trimmed of whitespaces.
+
+```typescript
+import { removeCommonPrefix } from '@dxtmisha/functional-basic'
+
+console.log(removeCommonPrefix('Hello, world!', 'Hello, ')) // 'world!'
+console.log(removeCommonPrefix('user_name', 'user_')) // 'name'
+```

package/src/media/functional/functional-basic/functions/removeCommonPrefix/removeCommonPrefix.ru.mdx

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/removeCommonPrefix - Удаление общего префикса'/>
+
+# `removeCommonPrefix`
+
+Удаляет общий префикс из начала основной строки. Если основная строка начинается с указанного префикса, функция обрезает его и возвращает строку без пробелов по краям.
+
+**Параметры:**
+- `mainStr: string` — Основная строка.
+- `prefix: string` — Строка префикса для удаления.
+
+**Возвращает:**
+`string` — Новая строка без префикса и лишних пробелов по краям.
+
+```typescript
+import { removeCommonPrefix } from '@dxtmisha/functional-basic'
+
+console.log(removeCommonPrefix('Привет, мир!', 'Привет, ')) // 'мир!'
+console.log(removeCommonPrefix('user_name', 'user_')) // 'name'
+```

package/src/media/functional/functional-basic/functions/removeCommonPrefix/removeCommonPrefix.vi.mdx

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/removeCommonPrefix - Xóa tiền tố chung'/>
+
+# `removeCommonPrefix`
+
+Xóa tiền tố chung khỏi phần đầu của chuỗi chính. Nếu chuỗi chính bắt đầu bằng tiền tố được chỉ định, hàm sẽ cắt bỏ nó và trả về chuỗi đã được loại bỏ khoảng trắng dư thừa ở hai đầu.
+
+**Tham số:**
+- `mainStr: string` — Chuỗi chính.
+- `prefix: string` — Chuỗi tiền tố cần xóa.
+
+**Trả về:**
+`string` — Một chuỗi mới không có tiền tố và đã được loại bỏ khoảng trắng thừa.
+
+```typescript
+import { removeCommonPrefix } from '@dxtmisha/functional-basic'
+
+console.log(removeCommonPrefix('Xin chào, thế giới!', 'Xin chào, ')) // 'thế giới!'
+console.log(removeCommonPrefix('user_name', 'user_')) // 'name'
+```

package/src/media/functional/functional-basic/functions/replaceComponentName/replaceComponentName.en.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/replaceComponentName - Replace component name in text'/>
+
+# `replaceComponentName`
+
+Replaces HTML tags of a specific component within a text string with new ones. It searches for opening (`<name`) and closing (`</name`) tags case-insensitively and replaces them with `componentName`.
+
+**Parameters:**
+- `text: string | undefined` — The original text.
+- `name: string` — The component name to replace.
+- `componentName: string` — The new component name.
+
+**Returns:**
+`string | undefined` — The modified text with new tags, or `undefined` if the original text was not provided.
+
+```typescript
+import { replaceComponentName } from '@dxtmisha/functional-basic'
+
+const template = '<Button>Click me</Button>'
+console.log(replaceComponentName(template, 'Button', 'AppButton')) 
+// '<AppButton>Click me</AppButton>'
+```

package/src/media/functional/functional-basic/functions/replaceComponentName/replaceComponentName.ru.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/replaceComponentName - Замена имени компонента в тексте'/>
+
+# `replaceComponentName`
+
+Заменяет HTML-теги определенного компонента в текстовой строке на новые. Выполняет поиск открывающих (`<name`) и закрывающих (`</name`) тегов без учета регистра и заменяет их на `componentName`.
+
+**Параметры:**
+- `text: string | undefined` — Исходный текст.
+- `name: string` — Имя компонента, которое нужно заменить.
+- `componentName: string` — Новое имя компонента.
+
+**Возвращает:**
+`string | undefined` — Измененный текст с новыми тегами или `undefined`, если исходный текст не был передан.
+
+```typescript
+import { replaceComponentName } from '@dxtmisha/functional-basic'
+
+const template = '<Button>Нажми меня</Button>'
+console.log(replaceComponentName(template, 'Button', 'AppButton')) 
+// '<AppButton>Нажми меня</AppButton>'
+```

package/src/media/functional/functional-basic/functions/replaceComponentName/replaceComponentName.vi.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/replaceComponentName - Thay thế tên thành phần trong văn bản'/>
+
+# `replaceComponentName`
+
+Thay thế các thẻ HTML của một thành phần (component) cụ thể trong chuỗi văn bản bằng các thẻ mới. Hàm tìm kiếm các thẻ mở (`<name`) và thẻ đóng (`</name`) không phân biệt chữ hoa chữ thường và thay thế chúng bằng `componentName`.
+
+**Tham số:**
+- `text: string | undefined` — Văn bản gốc.
+- `name: string` — Tên thành phần cần thay thế.
+- `componentName: string` — Tên thành phần mới.
+
+**Trả về:**
+`string | undefined` — Văn bản đã thay đổi với các thẻ mới hoặc `undefined` nếu không có văn bản gốc được cung cấp.
+
+```typescript
+import { replaceComponentName } from '@dxtmisha/functional-basic'
+
+const template = '<Button>Nhấp vào tôi</Button>'
+console.log(replaceComponentName(template, 'Button', 'AppButton')) 
+// '<AppButton>Nhấp vào tôi</AppButton>'
+```

package/src/media/functional/functional-basic/functions/replaceRecursive/replaceRecursive.en.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/replaceRecursive - Recursive merge of objects or arrays'/>
+
+# `replaceRecursive`
+
+Performs a deep (recursive) merge of the target object or array with data from a replacement object/array. If the `isMerge` parameter is enabled, arrays are concatenated with duplicates removed; otherwise, arrays from the replacement overwrite the original ones.
+
+**Parameters:**
+- `array: ObjectItem<I>` — The target array or object whose elements will be replaced/merged.
+- `replacement?: ObjectOrArray<I>` — Arrays or objects from which elements will be extracted for replacement.
+- `isMerge: boolean` — Flag to merge arrays of the same name (defaults to `true`). If `false`, elements are simply overwritten.
+
+**Returns:**
+`ObjectItem<I>` — A new object or array that is the result of the merge. The original object is not mutated.
+
+```typescript
+import { replaceRecursive } from '@dxtmisha/functional-basic'
+
+const target = { a: [1, 2], b: { x: 1 } }
+const source = { a: [2, 3], b: { y: 2 } }
+
+console.log(replaceRecursive(target, source)) 
+// { a: [1, 2, 3], b: { x: 1, y: 2 } }
+
+console.log(replaceRecursive(target, source, false)) 
+// { a: [2, 3], b: { x: 1, y: 2 } }
+```

package/src/media/functional/functional-basic/functions/replaceRecursive/replaceRecursive.ru.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/replaceRecursive - Рекурсивное слияние объектов или массивов'/>
+
+# `replaceRecursive`
+
+Выполняет глубокое (рекурсивное) слияние исходного объекта или массива с данными из объекта/массива замены. При включенном параметре `isMerge` массивы объединяются с удалением дубликатов, в противном случае массивы из замены перезаписывают исходные.
+
+**Параметры:**
+- `array: ObjectItem<I>` — Исходный массив или объект, элементы которого будут заменены/слиты.
+- `replacement?: ObjectOrArray<I>` — Массив или объект, из которого будут браться элементы для замены.
+- `isMerge: boolean` — Флаг слияния одноименных массивов (по умолчанию `true`). При `false` элементы просто перезаписываются.
+
+**Возвращает:**
+`ObjectItem<I>` — Новый объект или массив, являющийся результатом слияния. Исходный объект не мутирует.
+
+```typescript
+import { replaceRecursive } from '@dxtmisha/functional-basic'
+
+const target = { a: [1, 2], b: { x: 1 } }
+const source = { a: [2, 3], b: { y: 2 } }
+
+console.log(replaceRecursive(target, source)) 
+// { a: [1, 2, 3], b: { x: 1, y: 2 } }
+
+console.log(replaceRecursive(target, source, false)) 
+// { a: [2, 3], b: { x: 1, y: 2 } }
+```

package/src/media/functional/functional-basic/functions/replaceRecursive/replaceRecursive.vi.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/replaceRecursive - Hợp nhất đệ quy các đối tượng hoặc mảng'/>
+
+# `replaceRecursive`
+
+Thực hiện hợp nhất sâu (đệ quy) một đối tượng hoặc mảng đích với dữ liệu từ một đối tượng/mảng thay thế. Nếu tham số `isMerge` được bật, các mảng sẽ được nối lại với nhau và loại bỏ các phần tử trùng lặp; nếu không, các mảng từ đối tượng thay thế sẽ ghi đè lên các mảng ban đầu.
+
+**Tham số:**
+- `array: ObjectItem<I>` — Mảng hoặc đối tượng ban đầu mà các phần tử sẽ được thay thế/hợp nhất.
+- `replacement?: ObjectOrArray<I>` — Mảng hoặc đối tượng chứa các phần tử được sử dụng để thay thế.
+- `isMerge: boolean` — Cờ để hợp nhất các mảng cùng tên (mặc định là `true`). Nếu là `false`, các phần tử đơn giản sẽ bị ghi đè.
+
+**Trả về:**
+`ObjectItem<I>` — Một đối tượng hoặc mảng mới là kết quả của việc hợp nhất. Đối tượng ban đầu không bị biến đổi (mutate).
+
+```typescript
+import { replaceRecursive } from '@dxtmisha/functional-basic'
+
+const target = { a: [1, 2], b: { x: 1 } }
+const source = { a: [2, 3], b: { y: 2 } }
+
+console.log(replaceRecursive(target, source)) 
+// { a: [1, 2, 3], b: { x: 1, y: 2 } }
+
+console.log(replaceRecursive(target, source, false)) 
+// { a: [2, 3], b: { x: 1, y: 2 } }
+```

package/src/media/functional/functional-basic/functions/replaceTemplate/replaceTemplate.en.mdx

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/replaceTemplate - Substituting values into a template string'/>
+
+# `replaceTemplate`
+
+Searches the original string for markers in the form `[pattern]` and replaces them with corresponding values from the provided object. If the marker's value is a function, it is automatically called, and its result is substituted into the string.
+
+**Parameters:**
+- `value: string` — The template string containing markers (e.g., `[name]`).
+- `replaces: Record<string, string | FunctionReturn<string>>` — An object containing replacement data, where the key is the marker name inside brackets, and the value is a string or a function returning a string.
+
+**Returns:**
+`string` — A new string with the substituted values.
+
+```typescript
+import { replaceTemplate } from '@dxtmisha/functional-basic'
+
+const template = 'Hello, [name]! Your balance: [balance].'
+const data = {
+  name: 'John',
+  balance: () => '$100' // The function is evaluated during substitution
+}
+
+console.log(replaceTemplate(template, data)) 
+// 'Hello, John! Your balance: $100.'
+```

package/src/media/functional/functional-basic/functions/replaceTemplate/replaceTemplate.ru.mdx

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/replaceTemplate - Подстановка значений в строку шаблона'/>
+
+# `replaceTemplate`
+
+Ищет в исходной строке маркеры вида `[pattern]` и заменяет их на значения из переданного объекта. Если значением маркера является функция, она автоматически вызывается, и в строку подставляется результат ее выполнения.
+
+**Параметры:**
+- `value: string` — Строка шаблона с маркерами (например, `[name]`).
+- `replaces: Record<string, string | FunctionReturn<string>>` — Объект с данными для замены, где ключ — имя маркера внутри скобок, а значение — строка или функция, возвращающая строку.
+
+**Возвращает:**
+`string` — Новая строка с подставленными значениями.
+
+```typescript
+import { replaceTemplate } from '@dxtmisha/functional-basic'
+
+const template = 'Привет, [name]! Твой баланс: [balance].'
+const data = {
+  name: 'Иван',
+  balance: () => '100$' // Функция вычисляется при подстановке
+}
+
+console.log(replaceTemplate(template, data)) 
+// 'Привет, Иван! Твой баланс: 100$.'
+```

package/src/media/functional/functional-basic/functions/replaceTemplate/replaceTemplate.vi.mdx

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/replaceTemplate - Thay thế giá trị vào chuỗi mẫu'/>
+
+# `replaceTemplate`
+
+Tìm kiếm các điểm đánh dấu có dạng `[pattern]` trong chuỗi gốc và thay thế chúng bằng các giá trị tương ứng từ đối tượng được cung cấp. Nếu giá trị của điểm đánh dấu là một hàm, hàm đó sẽ tự động được gọi và kết quả của nó sẽ được chèn vào chuỗi.
+
+**Tham số:**
+- `value: string` — Chuỗi mẫu chứa các điểm đánh dấu (ví dụ: `[name]`).
+- `replaces: Record<string, string | FunctionReturn<string>>` — Một đối tượng chứa dữ liệu thay thế, trong đó khóa là tên của điểm đánh dấu bên trong ngoặc vuông, và giá trị là một chuỗi hoặc một hàm trả về chuỗi.
+
+**Trả về:**
+`string` — Một chuỗi mới với các giá trị đã được thay thế.
+
+```typescript
+import { replaceTemplate } from '@dxtmisha/functional-basic'
+
+const template = 'Xin chào, [name]! Số dư của bạn: [balance].'
+const data = {
+  name: 'John',
+  balance: () => '$100' // Hàm được thực thi trong quá trình thay thế
+}
+
+console.log(replaceTemplate(template, data)) 
+// 'Xin chào, John! Số dư của bạn: $100.'
+```

package/src/media/functional/functional-basic/functions/resizeImageByMax/resizeImageByMax.en.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/resizeImageByMax - Resize image by maximum dimension'/>
+
+# `resizeImageByMax`
+
+Proportionally resizes an image to fit within the specified maximum size constraints (by width, height, or automatically by the longest side). Returns a Base64-encoded Data URL of the scaled image.
+
+This function is useful for compressing images on the fly before uploading to a server.
+
+**Parameters:**
+- `image: HTMLImageElement | string` — The image element or URL.
+- `maxSize: number` — The maximum allowed size in pixels (for width or height).
+- `type: ResizeImageByMaxType` — The scaling strategy: `'auto'`, `'width'`, or `'height'`. Defaults to `'auto'`.
+- `typeData?: string` — Optional MIME type for the resulting Data URL (e.g., `'image/jpeg'`). Defaults to `'image/png'`.
+
+**Returns:**
+`string | undefined` — A Data URL string containing the resized image, or `undefined` if the image could not be processed or is already smaller than or equal to `maxSize`.
+
+```typescript
+import { resizeImageByMax } from '@dxtmisha/functional-basic'
+
+const imgElement = document.querySelector('img')
+const resizedDataUrl = resizeImageByMax(imgElement, 800)
+
+console.log(resizedDataUrl) 
+// 'data:image/png;base64,iVBORw0KGgo...'
+```

package/src/media/functional/functional-basic/functions/resizeImageByMax/resizeImageByMax.ru.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/resizeImageByMax - Изменение размера изображения по максимальной стороне'/>
+
+# `resizeImageByMax`
+
+Изменяет размер изображения пропорционально, чтобы оно вписывалось в заданные ограничения максимального размера (по ширине, высоте или автоматически по большей стороне). Возвращает Data URL с уменьшенным изображением в формате Base64. 
+
+Функция полезна для сжатия изображений на лету перед их отправкой на сервер.
+
+**Параметры:**
+- `image: HTMLImageElement | string` — Элемент изображения или URL-адрес.
+- `maxSize: number` — Максимальный допустимый размер в пикселях (для ширины или высоты).
+- `type: ResizeImageByMaxType` — Стратегия масштабирования: `'auto'`, `'width'`, или `'height'`. По умолчанию `'auto'`.
+- `typeData?: string` — Опциональный MIME-тип для результирующего Data URL (например, `'image/jpeg'`). По умолчанию `'image/png'`.
+
+**Возвращает:**
+`string | undefined` — Строка Data URL с изображением нового размера, или `undefined`, если изображение невозможно обработать или оно меньше/равно `maxSize`.
+
+```typescript
+import { resizeImageByMax } from '@dxtmisha/functional-basic'
+
+const imgElement = document.querySelector('img')
+const resizedDataUrl = resizeImageByMax(imgElement, 800)
+
+console.log(resizedDataUrl) 
+// 'data:image/png;base64,iVBORw0KGgo...'
+```

package/src/media/functional/functional-basic/functions/resizeImageByMax/resizeImageByMax.vi.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/resizeImageByMax - Thay đổi kích thước hình ảnh theo cạnh tối đa'/>
+
+# `resizeImageByMax`
+
+Thay đổi kích thước hình ảnh theo tỷ lệ để vừa với giới hạn kích thước tối đa được chỉ định (theo chiều rộng, chiều cao hoặc tự động theo cạnh lớn nhất). Trả về Chuỗi Data URL được mã hóa Base64 của hình ảnh đã thu nhỏ.
+
+Hàm này hữu ích để nén hình ảnh trực tiếp (on the fly) trước khi tải lên máy chủ.
+
+**Tham số:**
+- `image: HTMLImageElement | string` — Phần tử hình ảnh hoặc đường dẫn URL.
+- `maxSize: number` — Kích thước pixel tối đa cho phép (đối với chiều rộng hoặc chiều cao).
+- `type: ResizeImageByMaxType` — Chiến lược mở rộng/thu nhỏ: `'auto'`, `'width'`, hoặc `'height'`. Mặc định là `'auto'`.
+- `typeData?: string` — Loại MIME tùy chọn cho chuỗi Data URL trả về (ví dụ, `'image/jpeg'`). Mặc định là `'image/png'`.
+
+**Trả về:**
+`string | undefined` — Một chuỗi Data URL chứa hình ảnh đã thay đổi kích thước hoặc `undefined` nếu hình ảnh không thể được xử lý hoặc kích thước của nó đã nhỏ hơn/bằng `maxSize`.
+
+```typescript
+import { resizeImageByMax } from '@dxtmisha/functional-basic'
+
+const imgElement = document.querySelector('img')
+const resizedDataUrl = resizeImageByMax(imgElement, 800)
+
+console.log(resizedDataUrl) 
+// 'data:image/png;base64,iVBORw0KGgo...'
+```

package/src/media/functional/functional-basic/functions/secondToTime/secondToTime.en.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/secondToTime - Convert seconds to a time string'/>
+
+# `secondToTime`
+
+Converts a given number of seconds into a time format string `MM:SS`.
+
+If the value of seconds is less than or equal to zero, or is not provided, the default value `00:00` is returned.
+
+**Parameters:**
+- `second: number | string | undefined` — The total number of seconds (both numbers and string representations of numbers are supported).
+
+**Returns:**
+`string` — A formatted string with minutes and seconds (e.g., `12:34`).
+
+```typescript
+import { secondToTime } from '@dxtmisha/functional-basic'
+
+console.log(secondToTime(125)) // '02:05'
+console.log(secondToTime('65')) // '01:05'
+console.log(secondToTime()) // '00:00'
+```

package/src/media/functional/functional-basic/functions/secondToTime/secondToTime.ru.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/secondToTime - Преобразование секунд в строку времени'/>
+
+# `secondToTime`
+
+Преобразует переданное количество секунд в строку формата времени `MM:SS`. 
+
+Если значение секунд меньше или равно нулю, или оно не было передано, возвращается значение по умолчанию `00:00`.
+
+**Параметры:**
+- `second: number | string | undefined` — Общее количество секунд (поддерживаются числа и строковые представления чисел).
+
+**Возвращает:**
+`string` — Отформатированная строка с минутами и секундами (например, `12:34`).
+
+```typescript
+import { secondToTime } from '@dxtmisha/functional-basic'
+
+console.log(secondToTime(125)) // '02:05'
+console.log(secondToTime('65')) // '01:05'
+console.log(secondToTime()) // '00:00'
+```

package/src/media/functional/functional-basic/functions/secondToTime/secondToTime.vi.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/secondToTime - Chuyển đổi giây sang chuỗi thời gian'/>
+
+# `secondToTime`
+
+Chuyển đổi số giây được cung cấp thành chuỗi định dạng thời gian `MM:SS`.
+
+Nếu giá trị số giây nhỏ hơn hoặc bằng 0, hoặc không được cung cấp, hàm sẽ trả về giá trị mặc định là `00:00`.
+
+**Tham số:**
+- `second: number | string | undefined` — Tổng số giây (hỗ trợ cả kiểu số nguyên và kiểu chuỗi biểu diễn số).
+
+**Trả về:**
+`string` — Một chuỗi được định dạng với số phút và số giây tương ứng (ví dụ: `12:34`).
+
+```typescript
+import { secondToTime } from '@dxtmisha/functional-basic'
+
+console.log(secondToTime(125)) // '02:05'
+console.log(secondToTime('65')) // '01:05'
+console.log(secondToTime()) // '00:00'
+```

package/src/media/functional/functional-basic/functions/setElementItem/setElementItem.en.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/setElementItem - Modifying an element value by key'/>
+
+# `setElementItem`
+
+Modifies the property or attribute value of a DOM element identified by a selector or passed directly. If the property is an object, it performs a merge with the new data.
+
+**Parameters:**
+- `element: ElementOrString<E>` — The target element, `window` object, or CSS selector.
+- `index: K` — The property key or attribute name.
+- `value: V | Record<string, V>` — The new value or an object for merging.
+
+**Returns:**
+`E | undefined` — The modified element, or `undefined` if not found.
+
+```typescript
+import { setElementItem } from '@dxtmisha/functional-basic'
+
+// Modifying text content
+setElementItem('#my-div', 'textContent', 'New text')
+
+// Merging styles
+setElementItem(document.body, 'style', { backgroundColor: 'red', color: 'white' })
+
+// Setting an attribute (if the property does not exist on the object)
+setElementItem('input', 'placeholder', 'Enter data...')
+```

package/src/media/functional/functional-basic/functions/setElementItem/setElementItem.ru.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/setElementItem - Изменение значения элемента по ключу'/>
+
+# `setElementItem`
+
+Изменяет значение свойства или атрибута DOM-элемента, найденного по селектору или переданного напрямую. Если свойство является объектом, выполняется слияние с новыми данными.
+
+**Параметры:**
+- `element: ElementOrString<E>` — Элемент, объект `window` или CSS-селектор.
+- `index: K` — Ключ свойства или имя атрибута.
+- `value: V | Record<string, V>` — Новое значение или объект для слияния.
+
+**Возвращает:**
+`E | undefined` — Модифицированный элемент или `undefined`, если элемент не найден.
+
+```typescript
+import { setElementItem } from '@dxtmisha/functional-basic'
+
+// Изменение текстового содержимого
+setElementItem('#my-div', 'textContent', 'Новый текст')
+
+// Слияние стилей
+setElementItem(document.body, 'style', { backgroundColor: 'red', color: 'white' })
+
+// Установка атрибута (если свойства нет в объекте)
+setElementItem('input', 'placeholder', 'Введите данные...')
+```

package/src/media/functional/functional-basic/functions/setElementItem/setElementItem.vi.mdx

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/setElementItem - Thay đổi giá trị phần tử theo khóa'/>
+
+# `setElementItem`
+
+Thay đổi giá trị của một thuộc tính hoặc attribute của phần tử DOM được xác định bởi bộ chọn (selector) hoặc được truyền trực tiếp. Nếu thuộc tính là một đối tượng, hàm sẽ thực hiện hợp nhất với dữ liệu mới.
+
+**Tham số:**
+- `element: ElementOrString<E>` — Phần tử mục tiêu, đối tượng `window` hoặc bộ chọn CSS.
+- `index: K` — Khóa thuộc tính hoặc tên attribute.
+- `value: V | Record<string, V>` — Giá trị mới hoặc một đối tượng để hợp nhất.
+
+**Trả về:**
+`E | undefined` — Phần tử đã được sửa đổi, hoặc `undefined` nếu không tìm thấy.
+
+```typescript
+import { setElementItem } from '@dxtmisha/functional-basic'
+
+// Thay đổi nội dung văn bản
+setElementItem('#my-div', 'textContent', 'Văn bản mới')
+
+// Hợp nhất các kiểu (styles)
+setElementItem(document.body, 'style', { backgroundColor: 'red', color: 'white' })
+
+// Thiết lập attribute (nếu thuộc tính không tồn tại trong đối tượng)
+setElementItem('input', 'placeholder', 'Nhập dữ liệu...')
+```

package/src/media/functional/functional-basic/functions/setValues/setValues.en.mdx

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/setValues - Managing the list of selected values'/>
+
+# `setValues`
+
+Handles updating selected values based on the selection mode (single or multiple). Allows adding, removing, or replacing values with support for maximum element constraints.
+
+**Parameters:**
+- `selected: T | T[] | undefined` — The current selected values.
+- `value: any` — The new value to process.
+- `options` — An object with settings:
+    - `multiple: boolean` — Multiple selection mode (defaults to `false`).
+    - `maxlength: number` — Maximum number of elements for multiple selection (defaults to `0` — unlimited).
+    - `alwaysChange: boolean` — Forced value replacement flag (defaults to `true`).
+    - `notEmpty: boolean` — Prevents the list from being completely cleared (defaults to `false`).
+
+**Returns:**
+`T | T[] | undefined` — The new state of selected values.
+
+```typescript
+import { setValues } from '@dxtmisha/functional-basic'
+
+// Single selection
+console.log(setValues(1, 2, {})) // 2
+
+// Multiple selection (toggle)
+let list = [1, 2]
+list = setValues(list, 2, { multiple: true }) // [1] (removal of existing)
+list = setValues(list, 3, { multiple: true }) // [1, 3] (addition of new)
+```

package/src/media/functional/functional-basic/functions/setValues/setValues.ru.mdx

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/setValues - Управление списком выбранных значений'/>
+
+# `setValues`
+
+Обрабатывает обновление выбранных значений в зависимости от режима (одиночный или множественный выбор). Позволяет добавлять, удалять или заменять значения с поддержкой ограничений на максимальное количество элементов.
+
+**Параметры:**
+- `selected: T | T[] | undefined` — Текущие выбранные значения.
+- `value: any` — Новое значение для обработки.
+- `options` — Объект с настройками:
+    - `multiple: boolean` — Режим множественного выбора (по умолчанию `false`).
+    - `maxlength: number` — Максимальное количество элементов для множественного выбора (по умолчанию `0` — без ограничений).
+    - `alwaysChange: boolean` — Флаг принудительной замены значения (по умолчанию `true`).
+    - `notEmpty: boolean` — Запрет на полное очищение списка (по умолчанию `false`).
+
+**Возвращает:**
+`T | T[] | undefined` — Новое состояние выбранных значений.
+
+```typescript
+import { setValues } from '@dxtmisha/functional-basic'
+
+// Одиночный выбор
+console.log(setValues(1, 2, {})) // 2
+
+// Множественный выбор (переключение)
+let list = [1, 2]
+list = setValues(list, 2, { multiple: true }) // [1] (удаление существующего)
+list = setValues(list, 3, { multiple: true }) // [1, 3] (добавление нового)
+```