@dxtmisha/wiki 0.25.1 → 0.39.2

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] (добавление нового)
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/setValues - Quản lý danh sách các giá trị đã chọn'/>
+
+# `setValues`
+
+Xử lý việc cập nhật các giá trị đã chọn dựa trên chế độ lựa chọn (đơn hoặc đa). Cho phép thêm, xóa hoặc thay thế các giá trị với sự hỗ trợ của các ràng buộc về số lượng phần tử tối đa.
+
+**Tham số:**
+- `selected: T | T[] | undefined` — Các giá trị hiện đang được chọn.
+- `value: any` — Giá trị mới cần xử lý.
+- `options` — Một đối tượng chứa các thiết lập:
+    - `multiple: boolean` — Chế độ đa lựa chọn (mặc định là `false`).
+    - `maxlength: number` — Số lượng phần tử tối đa cho chế độ đa lựa chọn (mặc định là `0` — không giới hạn).
+    - `alwaysChange: boolean` — Cờ ép buộc thay thế giá trị (mặc định là `true`).
+    - `notEmpty: boolean` — Ngăn không cho danh sách bị xóa sạch hoàn toàn (mặc định là `false`).
+
+**Trả về:**
+`T | T[] | undefined` — Trạng thái mới của các giá trị đã chọn.
+
+```typescript
+import { setValues } from '@dxtmisha/functional-basic'
+
+// Lựa chọn đơn
+console.log(setValues(1, 2, {})) // 2
+
+// Đa lựa chọn (bật/tắt)
+let list = [1, 2]
+list = setValues(list, 2, { multiple: true }) // [1] (xóa giá trị đang tồn tại)
+list = setValues(list, 3, { multiple: true }) // [1, 3] (thêm giá trị mới)
+```

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

@@ -0,0 +1,26 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/sleep - Timeout delay'/>
+
+# `sleep`
+
+Pause execution for a specified number of milliseconds.
+
+**Parameters:**
+- `ms: number` — The number of milliseconds to pause execution.
+
+**Returns:**
+`Promise<void>` — A promise that resolves after the specified delay.
+
+```typescript
+import { sleep } from '@dxtmisha/functional-basic'
+
+async function performTask() {
+  console.log('Task started')
+  // Wait for 2 seconds
+  await sleep(2000)
+  console.log('Task resumed after 2 seconds')
+}
+
+performTask()
+```

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

@@ -0,0 +1,26 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/sleep - Задержка выполнения'/>
+
+# `sleep`
+
+Приостановить выполнение на указанное количество миллисекунд.
+
+**Параметры:**
+- `ms: number` — Количество миллисекунд, на которое нужно приостановить выполнение.
+
+**Возвращает:**
+`Promise<void>` — Промис, который разрешится после указанной задержки.
+
+```typescript
+import { sleep } from '@dxtmisha/functional-basic'
+
+async function performTask() {
+  console.log('Начало задачи')
+  // Подождать 2 секунды
+  await sleep(2000)
+  console.log('Задача возобновлена через 2 секунды')
+}
+
+performTask()
+```

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

@@ -0,0 +1,26 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/sleep - Tạm dừng thực thi'/>
+
+# `sleep`
+
+Tạm dừng thực thi trong một số mili giây nhất định.
+
+**Tham số:**
+- `ms: number` — Số mili giây để tạm dừng thực thi.
+
+**Trả về:**
+`Promise<void>` — Một promise sẽ giải quyết sau khoảng thời gian chờ đã chỉ định.
+
+```typescript
+import { sleep } from '@dxtmisha/functional-basic'
+
+async function performTask() {
+  console.log('Bắt đầu công việc')
+  // Đợi 2 giây
+  await sleep(2000)
+  console.log('Công việc tiếp tục sau 2 giây')
+}
+
+performTask()
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/splice - Copying and merging properties into an object'/>
+
+# `splice`
+
+Copies and recursively merges properties from one object into another. Supports inserting new properties starting from a specific key or index.
+
+**Parameters:**
+- `array: ObjectItem<I>` — The target object or array.
+- `replacement?: ObjectItem<I> | I` — The source object containing new data.
+- `indexStart?: string` — The key or element value from which the insertion will begin.
+
+**Returns:**
+`ObjectItem<I>` — A new object or array with the changes applied.
+
+```typescript
+import { splice } from '@dxtmisha/functional-basic'
+
+const target = { first: 1, last: 3 }
+const source = { second: 2 }
+
+// Simple insertion
+console.log(splice(target, source)) // { first: 1, last: 3, second: 2 }
+
+// Insertion after a specific key
+console.log(splice(target, source, 'first')) // { first: 1, second: 2, last: 3 }
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/splice - Копирование и слияние свойств в объект'/>
+
+# `splice`
+
+Выполняет копирование и рекурсивное слияние свойств из одного объекта в другой. Поддерживает вставку новых свойств начиная с определенного ключа или индекса.
+
+**Параметры:**
+- `array: ObjectItem<I>` — Целевой объект или массив.
+- `replacement?: ObjectItem<I> | I` — Исходный объект с новыми данными.
+- `indexStart?: string` — Ключ или значение элемента, начиная с которого будет выполнена вставка.
+
+**Возвращает:**
+`ObjectItem<I>` — Новый объект или массив с примененными изменениями.
+
+```typescript
+import { splice } from '@dxtmisha/functional-basic'
+
+const target = { first: 1, last: 3 }
+const source = { second: 2 }
+
+// Простая вставка
+console.log(splice(target, source)) // { first: 1, last: 3, second: 2 }
+
+// Вставка после определенного ключа
+console.log(splice(target, source, 'first')) // { first: 1, second: 2, last: 3 }
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/splice - Sao chép và hợp nhất các thuộc tính vào đối tượng'/>
+
+# `splice`
+
+Sao chép và hợp nhất đệ quy các thuộc tính từ một đối tượng vào một đối tượng khác. Hỗ trợ chèn các thuộc tính mới bắt đầu từ một khóa hoặc chỉ số cụ thể.
+
+**Tham số:**
+- `array: ObjectItem<I>` — Đối tượng hoặc mảng mục tiêu.
+- `replacement?: ObjectItem<I> | I` — Đối tượng nguồn chứa dữ liệu mới.
+- `indexStart?: string` — Khóa hoặc giá trị phần tử mà từ đó quá trình chèn sẽ bắt đầu.
+
+**Trả về:**
+`ObjectItem<I>` — Một đối tượng hoặc mảng mới với các thay đổi đã được áp dụng.
+
+```typescript
+import { splice } from '@dxtmisha/functional-basic'
+
+const target = { first: 1, last: 3 }
+const source = { second: 2 }
+
+// Chèn đơn giản
+console.log(splice(target, source)) // { first: 1, last: 3, second: 2 }
+
+// Chèn sau một khóa cụ thể
+console.log(splice(target, source, 'first')) // { first: 1, second: 2, last: 3 }
+```

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

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/strFill - Create a string filled with a value'/>
+
+# `strFill`
+
+The method creates a string of length count, consisting of the characters value.
+
+**Parameters:**
+- `value: string` — character for filling.
+- `count: number` — length of the string.
+
+**Returns:**
+`string` — a string filled with the specified value.
+
+```typescript
+import { strFill } from '@dxtmisha/functional-basic'
+
+const string = strFill('a', 3)
+console.log(string) // 'aaa'
+```

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

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/strFill - Создание строки, заполненной значением'/>
+
+# `strFill`
+
+Метод создает строку длиной count, состоящую из символов value.
+
+**Параметры:**
+- `value: string` — символ для заполнения.
+- `count: number` — длина строки.
+
+**Возвращает:**
+`string` — строка, заполненная указанным значением.
+
+```typescript
+import { strFill } from '@dxtmisha/functional-basic'
+
+const string = strFill('a', 3)
+console.log(string) // 'aaa'
+```

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

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/strFill - Tạo chuỗi được điền giá trị'/>
+
+# `strFill`
+
+Phương thức tạo một chuỗi có độ dài count, bao gồm các ký tự value.
+
+**Tham số:**
+- `value: string` — ký tự để điền.
+- `count: number` — độ dài của chuỗi.
+
+**Trả về:**
+`string` — một chuỗi được điền với giá trị đã chỉ định.
+
+```typescript
+import { strFill } from '@dxtmisha/functional-basic'
+
+const string = strFill('a', 3)
+console.log(string) // 'aaa'
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/strSplit - Splitting a string with limit support (PHP style)'/>
+
+# `strSplit`
+
+Splits a string into an array of substrings using a specified separator. Unlike the standard `String.prototype.split`, when a limit is specified, the remainder of the string is preserved in the last element of the array (similar to the `explode` function in PHP).
+
+**Parameters:**
+- `value: number | string` — The original value.
+- `separator: string` — The separator.
+- `limit?: number` — The maximum number of elements. If there are more elements than the limit, the last element will contain the entire remainder of the string.
+
+**Returns:**
+`string[]` — An array of substrings.
+
+```typescript
+import { strSplit } from '@dxtmisha/functional-basic'
+
+// Without limit
+strSplit('a.b.c.d', '.') // ['a', 'b', 'c', 'd']
+
+// With limit 2
+strSplit('a.b.c.d', '.', 2) // ['a', 'b.c.d']
+
+// With a number as the value
+strSplit(123.456, '.') // ['123', '456']
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/strSplit - Разделение строки с поддержкой лимита (PHP style)'/>
+
+# `strSplit`
+
+Разделяет строку на массив подстрок по указанному разделителю. В отличие от стандартного `String.prototype.split`, при указании лимита оставшаяся часть строки сохраняется в последнем элементе массива (аналогично функции `explode` в PHP).
+
+**Параметры:**
+- `value: number | string` — Исходное значение.
+- `separator: string` — Разделитель.
+- `limit?: number` — Максимальное количество элементов. Если элементов больше лимита, последний элемент будет содержать весь остаток строки.
+
+**Возвращает:**
+`string[]` — Массив подстрок.
+
+```typescript
+import { strSplit } from '@dxtmisha/functional-basic'
+
+// Без лимита
+strSplit('a.b.c.d', '.') // ['a', 'b', 'c', 'd']
+
+// С лимитом 2
+strSplit('a.b.c.d', '.', 2) // ['a', 'b.c.d']
+
+// С числом в качестве значения
+strSplit(123.456, '.') // ['123', '456']
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/strSplit - Chia chuỗi hỗ trợ giới hạn (phong cách PHP)'/>
+
+# `strSplit`
+
+Chia một chuỗi thành một mảng các chuỗi con bằng cách sử dụng dấu phân cách được chỉ định. Khác với `String.prototype.split` tiêu chuẩn, khi chỉ định giới hạn (limit), phần còn lại của chuỗi sẽ được giữ lại trong phần tử cuối cùng của mảng (tương tự như hàm `explode` trong PHP).
+
+**Tham số:**
+- `value: number | string` — Giá trị gốc.
+- `separator: string` — Dấu phân cách.
+- `limit?: number` — Số lượng phần tử tối đa. Nếu có nhiều phần tử hơn giới hạn, phần tử cuối cùng sẽ chứa toàn bộ phần còn lại của chuỗi.
+
+**Trả về:**
+`string[]` — Một mảng các chuỗi con.
+
+```typescript
+import { strSplit } from '@dxtmisha/functional-basic'
+
+// Không có giới hạn
+strSplit('a.b.c.d', '.') // ['a', 'b', 'c', 'd']
+
+// Với giới hạn 2
+strSplit('a.b.c.d', '.', 2) // ['a', 'b.c.d']
+
+// Với giá trị là số
+strSplit(123.456, '.') // ['123', '456']
+```

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

@@ -0,0 +1,20 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/toArray - Convert value to array'/>
+
+# `toArray`
+
+Converts a value to an array. If the value is already an array, it returns it as is. Otherwise, it wraps the value in an array.
+
+**Parameters:**
+- `value: T` — The value to be converted into an array.
+
+**Returns:**
+`T[]` — An array containing the provided value.
+
+```typescript
+import { toArray } from '@dxtmisha/functional-basic'
+
+console.log(toArray([1, 2, 3])) // [1, 2, 3]
+console.log(toArray(1)) // [1]
+```

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

@@ -0,0 +1,20 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/toArray - Преобразование значения в массив'/>
+
+# `toArray`
+
+Преобразует значение в массив. Если переданное значение уже является массивом, возвращается оно само. В противном случае значение оборачивается в массив.
+
+**Параметры:**
+- `value: T` — Значение, которое необходимо преобразовать в массив.
+
+**Возвращает:**
+`T[]` — Массив, содержащий переданное значение.
+
+```typescript
+import { toArray } from '@dxtmisha/functional-basic'
+
+console.log(toArray([1, 2, 3])) // [1, 2, 3]
+console.log(toArray(1)) // [1]
+```

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

@@ -0,0 +1,20 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/toArray - Chuyển đổi giá trị thành mảng'/>
+
+# `toArray`
+
+Chuyển đổi một giá trị thành một mảng. Nếu giá trị đã là một mảng, nó sẽ trả về chính nó. Ngược lại, nó sẽ bọc giá trị trong một mảng.
+
+**Tham số:**
+- `value: T` — Giá trị cần chuyển đổi thành mảng.
+
+**Trả về:**
+`T[]` — Một mảng chứa giá trị được cung cấp.
+
+```typescript
+import { toArray } from '@dxtmisha/functional-basic'
+
+console.log(toArray([1, 2, 3])) // [1, 2, 3]
+console.log(toArray(1)) // [1]
+```

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

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/toCamelCase - Converting a string to camelCase'/>
+
+# `toCamelCase`
+
+Converts a text string to `camelCase` format. The function removes special characters, replaces spaces with dashes, converts letters after dashes to uppercase, and ensures that the first letter of the entire string is lowercase.
+
+**Parameters:**
+- `value: string` — The original string to convert.
+
+**Returns:**
+`string` — The string in `camelCase` format.
+
+```typescript
+import { toCamelCase } from '@dxtmisha/functional-basic'
+
+console.log(toCamelCase('Hello World')) // 'helloWorld'
+console.log(toCamelCase('user-profile-data')) // 'userProfileData'
+console.log(toCamelCase('Some_Special@String')) // 'someSpecialString'
+```