@dxtmisha/wiki 0.39.1 → 0.39.2

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

@@ -0,0 +1,34 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getObjectNoUndefined - Loại bỏ các thuộc tính có giá trị ngoại lệ'/>
+
+# `getObjectNoUndefined`
+
+Tạo và trả về một đối tượng mới bao gồm các thuộc tính từ đối tượng hoặc mảng gốc có giá trị **không bằng** giá trị ngoại lệ (so sánh nghiệm ngặt tuyệt đối). Theo mặc định, giá trị ngoại lệ là `undefined`.
+
+Hàm này thường được dùng để dọn dẹp dữ liệu trước khi gửi tới máy chủ hoặc để chuẩn hóa các đối tượng. Khi bạn truyền vào một mảng, các chỉ số của mảng sẽ được chuyển dạng thành khóa (key) kiểu chuỗi trong kết quả trả về.
+
+**Tham số:**
+- `data: T` — Đối tượng hoặc mảng nguồn (nơi `T extends Record<string | number, any>`).
+- `exception: any` — Giá trị sẽ khiến thuộc tính mang nó bị loại bỏ. Mặc định là `undefined`.
+
+**Trả về:**
+`T` — Một đối tượng mới đã được dọn dẹp các thuộc tính chứa giá trị đã bị loại trừ.
+
+```typescript
+import { getObjectNoUndefined } from '@dxtmisha/functional-basic'
+
+const user = {
+  name: 'John',
+  age: 25,
+  description: undefined, // Sẽ tự động bị xóa (mặc định)
+  status: 'guest'
+}
+
+console.log(getObjectNoUndefined(user)) 
+// { name: 'John', age: 25, status: 'guest' }
+
+// Xóa tất cả các thuộc tính có giá trị bằng 'guest'
+console.log(getObjectNoUndefined(user, 'guest'))
+// { name: 'John', age: 25, description: undefined }
+```

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

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getObjectOrNone - Safe object return'/>
+
+# `getObjectOrNone`
+
+A simple utility that checks whether the passed value is an actual object (not `null`, not an array, not a primitive) and returns it. If the passed argument is not a plain object, a new empty object `{}` is returned. This function is useful for safe variable initialization or parameter assignments.
+
+**Parameters:**
+- `value: T` — Any value, usually expected to be an object.
+
+**Returns:**
+`T & Record<string, any>` — The original object if the check passes; otherwise, an empty object `{}`.
+
+```typescript
+import { getObjectOrNone } from '@dxtmisha/functional-basic'
+
+// Successful object return
+console.log(getObjectOrNone({ name: 'Admin' })) // { name: 'Admin' }
+
+// Arrays are not considered plain objects, returns {}
+console.log(getObjectOrNone([1, 2, 3])) // {}
+
+// Primitives and null return {}
+console.log(getObjectOrNone(null)) // {}
+console.log(getObjectOrNone('a string')) // {}
+```

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

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getObjectOrNone - Гарантированный возврат объекта'/>
+
+# `getObjectOrNone`
+
+Простая утилита, которая проверяет, является ли переданное значение «настоящим» объектом (не `null`, не массивом, не примитивом), и возвращает его. Если переданный аргумент не объект, возвращается новый пустой объект `{}`. Функция полезна для безопасной инициализации или передачи параметров.
+
+**Параметры:**
+- `value: T` — Любое значение, которое предполагается быть объектом.
+
+**Возвращает:**
+`T & Record<string, any>` — Исходный объект, либо пустой объект `{}`, если исходное значение не прошло проверку.
+
+```typescript
+import { getObjectOrNone } from '@dxtmisha/functional-basic'
+
+// Успешный возврат объекта
+console.log(getObjectOrNone({ name: 'Admin' })) // { name: 'Admin' }
+
+// Массив — не подходящий тип объекта, вернется {}
+console.log(getObjectOrNone([1, 2, 3])) // {}
+
+// Примитивы и null возвращают {}
+console.log(getObjectOrNone(null)) // {}
+console.log(getObjectOrNone('строка')) // {}
+```

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

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getObjectOrNone - Đảm bảo trả về một đối tượng'/>
+
+# `getObjectOrNone`
+
+Một tiện ích đơn giản kiểm tra xem giá trị được cung cấp có phải là một đối tượng thực tế (không phải `null`, không phải mảng, không phải kiểu nguyên thủy) hay không và trả về chính nó. Nếu đối số không phải là một đối tượng, hàm sẽ trả về một đối tượng rỗng `{}`. Việc này rất hữu ích trong việc đảm bảo an toàn khi khởi tạo hoặc truyền tham số.
+
+**Tham số:**
+- `value: T` — Bất kỳ giá trị nào, thường mong đợi đây là một đối tượng.
+
+**Trả về:**
+`T & Record<string, any>` — Chính đối tượng ban đầu nếu kiểu dữ liệu đúng; ngược lại, trả về đối tượng rỗng `{}`.
+
+```typescript
+import { getObjectOrNone } from '@dxtmisha/functional-basic'
+
+// Trả về đối tượng thành công
+console.log(getObjectOrNone({ name: 'Admin' })) // { name: 'Admin' }
+
+// Mảng không được coi là plain object, trả về {}
+console.log(getObjectOrNone([1, 2, 3])) // {}
+
+// Các kiểu thông thường và null sẽ trả về {}
+console.log(getObjectOrNone(null)) // {}
+console.log(getObjectOrNone('a string')) // {}
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getRandomText - Generate random text'/>
+
+# `getRandomText`
+
+Generates a string consisting of a random number of "words". A word is defined as a sequence of identical symbols of a specific length. This function is useful for populating UI layouts with placeholder text that mimics the structure of real text without carrying any meaning or language constraints.
+
+It relies on the `random` (for choosing random numbers) and `strFill` (for repeating the symbol) utility functions.
+
+**Parameters:**
+- `min: number` — Minimum number of words in the resulting string.
+- `max: number` — Maximum number of words in the resulting string.
+- `symbol: string` — (Optional) The character used to construct the generated words. Defaults to `#`.
+- `lengthMin: number` — (Optional) Minimum length of a single word. Defaults to `2`.
+- `lengthMax: number` — (Optional) Maximum length of a single word. Defaults to `12`.
+
+**Returns:**
+`string` — A string of space-separated generated words.
+
+```typescript
+import { getRandomText } from '@dxtmisha/functional-basic'
+
+// Generate between 2 and 5 words made of '#' symbols
+// Length of each word ranges from 2 to 12 chars
+console.log(getRandomText(2, 5)) // '#### ## #######'
+
+// Exact number of words (3) with a specific symbol ('*')
+// Word lengths are strictly 5 chars
+console.log(getRandomText(3, 3, '*', 5, 5)) // '***** ***** *****'
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getRandomText - Генерация случайного текста'/>
+
+# `getRandomText`
+
+Генерирует строку, состоящую из случайного количества «слов». Под словом понимается последовательность одинаковых символов заданной длины. Функция полезна для заполнения интерфейса заглушками (placeholder), похожими на текст, но не имеющими смысла или языковой привязки.
+
+Она работает на основе утилит `random` (для выбора случайных чисел) и `strFill` (для заполнения слова символами).
+
+**Параметры:**
+- `min: number` — Минимальное количество слов в итоговой строке.
+- `max: number` — Максимальное количество слов в итоговой строке.
+- `symbol: string` — (Необязательно) Символ, из которого состоят сгенерированные слова. По умолчанию `#`.
+- `lengthMin: number` — (Необязательно) Минимальная длина одного слова. По умолчанию `2`.
+- `lengthMax: number` — (Необязательно) Максимальная длина одного слова. По умолчанию `12`.
+
+**Возвращает:**
+`string` — Строку, состоящую из слов, разделённых пробелами.
+
+```typescript
+import { getRandomText } from '@dxtmisha/functional-basic'
+
+// Сгенерирует от 2 до 5 слов, состоящих из символа '#'
+// Длина каждого слова от 2 до 12 символов
+console.log(getRandomText(2, 5)) // '#### ## #######'
+
+// Генерация точного числа слов (3) из определенного символа ('*')
+// Длина слов строго по 5 символов
+console.log(getRandomText(3, 3, '*', 5, 5)) // '***** ***** *****'
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getRandomText - Tạo văn bản ngẫu nhiên'/>
+
+# `getRandomText`
+
+Tạo một chuỗi bao gồm số lượng ngẫu nhiên các "từ". Từ ở đây là một chuỗi liên tiếp các ký tự giống nhau với độ dài cụ thể. Hàm này hữu ích trong việc làm dữ liệu giả (placeholder) cho giao diện, nó mô phỏng cách dàn trang chữ thật mà không bị ảnh hưởng bởi ngữ nghĩa hoặc rào cản ngôn ngữ.
+
+Hàm này được xây dựng dựa trên các tiện ích `random` (để lấy ngẫu nhiên các giá trị số) và `strFill` (để lặp ký tự theo độ dài thành một từ).
+
+**Tham số:**
+- `min: number` — Số lượng từ tối thiểu của chuỗi trả về.
+- `max: number` — Số lượng từ tối đa của chuỗi trả về.
+- `symbol: string` — (Tùy chọn) Ký tự sẽ được dùng để tạo thành chữ. Mặc định là `#`.
+- `lengthMin: number` — (Tùy chọn) Chiều dài tối thiểu một từ. Mặc định là `2`.
+- `lengthMax: number` — (Tùy chọn) Chiều dài tối đa của một từ. Mặc định là `12`.
+
+**Trả về:**
+`string` — Một chuỗi được tạo bằng các từ cách nhau bởi khoảng trắng.
+
+```typescript
+import { getRandomText } from '@dxtmisha/functional-basic'
+
+// Tạo ra từ 2 tới 5 từ bằng ký tự '#'
+// Độ dài mỗi từ trong khoảng 2 tới 12 ký tự
+console.log(getRandomText(2, 5)) // '#### ## #######'
+
+// Số lượng từ cố định (3) với một ký tự cụ thể ('*')
+// Độ dài từ khóa cứng là 5 ký tự
+console.log(getRandomText(3, 3, '*', 5, 5)) // '***** ***** *****'
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getRequestString - Build query string'/>
+
+# `getRequestString`
+
+Transforms a dictionary object into a URL-style formatted string (by default, a query string for GET parameters) where keys and values are joined by designated delimiters. Before string construction, all values are cast to strings, trimmed of whitespace, and passed through `encodeURIComponent` to ensure safe URL transmission. Keys are sorted alphabetically.
+
+**Parameters:**
+- `request: Record<string, any>` — The data object to convert.
+- `sign: string` — (Optional) The character linking a key to its value. Defaults to `=`.
+- `separator: string` — (Optional) The character separating pairs. Defaults to `&`.
+
+**Returns:**
+`string` — A formatted and sorted string.
+
+```typescript
+import { getRequestString } from '@dxtmisha/functional-basic'
+
+const params = {
+  sort: 'desc',
+  page: 2,
+  search: 'comfortable chair'
+}
+
+console.log(getRequestString(params)) 
+// 'page=2&search=comfortable%20chair&sort=desc'
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getRequestString - Формирование строки запроса'/>
+
+# `getRequestString`
+
+Преобразует объект словаря в URL-формат (по умолчанию строку запроса для GET-параметров), где ключи и значения объединяются заданными разделителями. Перед формированием строки все значения приводятся к строке, очищаются от пробелов по краям и пропускаются через `encodeURIComponent` для безопасной передачи через URL. Ключи сортируются в алфавитном порядке.
+
+**Параметры:**
+- `request: Record<string, any>` — Объект с данными для преобразования.
+- `sign: string` — (Необязательно) Символ соединения между ключом и значением. По умолчанию `=`.
+- `separator: string` — (Необязательно) Разделитель между парами. По умолчанию `&`.
+
+**Возвращает:**
+`string` — Отформатированная и отсортированная строка.
+
+```typescript
+import { getRequestString } from '@dxtmisha/functional-basic'
+
+const params = {
+  sort: 'desc',
+  page: 2,
+  search: 'удобный стул'
+}
+
+console.log(getRequestString(params)) 
+// 'page=2&search=%D1%83%D0%B4%D0%BE%D0%B1%D0%BD%D1%8B%D0%B9%20%D1%81%D1%82%D1%83%D0%BB&sort=desc'
+```

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

@@ -0,0 +1,28 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getRequestString - Tạo chuỗi truy vấn'/>
+
+# `getRequestString`
+
+Chuyển đổi một đối tượng từ điển thành một chuỗi định dạng kiểu URL (mặc định là chuỗi truy vấn cho tham số GET), trong đó các khóa và giá trị được nối với nhau bằng các dấu phân cách quy định. Trước khi tạo chuỗi, tất cả các giá trị đều được đưa về kiểu chuỗi, cắt khoảng trắng dư thừa và đưa qua hàm `encodeURIComponent` để đảm bảo an toàn khi truyền qua URL. Các khóa sẽ được sắp xếp theo thứ tự bảng chữ cái.
+
+**Tham số:**
+- `request: Record<string, any>` — Đối tượng dữ liệu cần chuyển đổi.
+- `sign: string` — (Tùy chọn) Ký tự kết nối giữa khóa và giá trị. Mặc định là `=`.
+- `separator: string` — (Tùy chọn) Ký tự phân tách các cặp khóa-giá trị. Mặc định là `&`.
+
+**Trả về:**
+`string` — Một chuỗi kí tự đã được định dạng và sắp xếp.
+
+```typescript
+import { getRequestString } from '@dxtmisha/functional-basic'
+
+const params = {
+  sort: 'desc',
+  page: 2,
+  search: 'ghế thoải mái'
+}
+
+console.log(getRequestString(params)) 
+// 'page=2&search=gh%E1%BA%BF%20tho%E1%BA%A3i%20m%C3%A1i&sort=desc'
+```

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

@@ -0,0 +1,30 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getSearchExp - Build a RegExp matching all search words'/>
+
+# `getSearchExp`
+
+A utility that builds a case-insensitive global `RegExp` matching strings that contain **all** words from the search string (in any order).
+
+Each word is split by spaces, escaped, and wrapped in a lookahead `(?=.*?word)`. This makes it ideal for live search or multi-word filtering UIs.
+
+**Parameters:**
+- `search: string` — A search string consisting of one or more space-separated words.
+
+**Returns:**
+`RegExp` — A regular expression with flags `ig` (global, case-insensitive).
+
+```typescript
+import { getSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getSearchExp('foo bar')
+
+regex.test('foo bar baz')  // true  — contains both words
+regex.test('bar foo')      // true  — order doesn't matter
+regex.test('foo only')     // false — word bar is missing
+
+// Special characters are escaped automatically
+const regex2 = getSearchExp('price $10.00')
+regex2.test('price $10.00') // true
+regex2.test('price X10Y00') // false
+```

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

@@ -0,0 +1,30 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getSearchExp - Создание RegExp для поиска по всем словам'/>
+
+# `getSearchExp`
+
+Утилита, строящая регистронезависимое глобальное регулярное выражение `RegExp` для поиска строк, содержащих **все** слова из поисковой строки (в любом порядке).
+
+Каждое слово разбивается пробелами, экранируется и оборачивается в lookahead `(?=.*?слово)`. Это удобно для реализации живого поиска/фильтрации по нескольким словам одновременно.
+
+**Параметры:**
+- `search: string` — Строка поиска, состоящая из одного или нескольких слов, разделённых пробелами.
+
+**Возвращает:**
+`RegExp` — Регулярное выражение с флагами `ig` (глобальный, без учёта регистра).
+
+```typescript
+import { getSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getSearchExp('foo bar')
+
+regex.test('foo bar baz')  // true  — содержит оба слова
+regex.test('bar foo')      // true  — порядок не важен
+regex.test('foo only')     // false — слово bar отсутствует
+
+// Специальные символы экранируются автоматически
+const regex2 = getSearchExp('price $10.00')
+regex2.test('price $10.00') // true
+regex2.test('price X10Y00') // false
+```

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

@@ -0,0 +1,30 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getSearchExp - Tạo RegExp khớp tất cả các từ tìm kiếm'/>
+
+# `getSearchExp`
+
+Tiện ích tạo một `RegExp` không phân biệt chữ hoa/thường, khớp với chuỗi chứa **tất cả** các từ trong chuỗi tìm kiếm (theo bất kỳ thứ tự nào).
+
+Mỗi từ được tách bởi khoảng trắng, escape và bọc trong lookahead `(?=.*?từ)`. Rất phù hợp để xây dựng tính năng tìm kiếm trực tiếp hoặc lọc theo nhiều từ.
+
+**Tham số:**
+- `search: string` — Chuỗi tìm kiếm gồm một hoặc nhiều từ phân cách bởi khoảng trắng.
+
+**Trả về:**
+`RegExp` — Biểu thức chính quy với cờ `ig` (toàn cục, không phân biệt chữ hoa/thường).
+
+```typescript
+import { getSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getSearchExp('foo bar')
+
+regex.test('foo bar baz')  // true  — chứa cả hai từ
+regex.test('bar foo')      // true  — thứ tự không quan trọng
+regex.test('foo only')     // false — thiếu từ bar
+
+// Các ký tự đặc biệt được escape tự động
+const regex2 = getSearchExp('price $10.00')
+regex2.test('price $10.00') // true
+regex2.test('price X10Y00') // false
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getSeparatingSearchExp - Build a RegExp for space-separated word search'/>
+
+# `getSeparatingSearchExp`
+
+A utility that builds a case-insensitive global `RegExp` for searching strings containing **any** of the words from the search string (separated by spaces).
+
+Each word is split by spaces, escaped, and joined with the OR operator `|`. This is useful when you want to find a match for at least one of the entered words.
+
+**Parameters:**
+- `search: string` — A search string consisting of one or more space-separated words.
+
+**Returns:**
+`RegExp` — A regular expression with flags `ig` (global, case-insensitive).
+
+```typescript
+import { getSeparatingSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getSeparatingSearchExp('foo bar')
+
+regex.test('foo')          // true
+regex.test('bar')          // true
+regex.test('foo bar baz')  // true
+regex.test('something')    // false
+
+// Special characters are escaped automatically
+const regex2 = getSeparatingSearchExp('$10 .')
+regex2.test('$10') // true
+regex2.test('.')   // true
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getSeparatingSearchExp - Создание RegExp для поиска по отдельным словам'/>
+
+# `getSeparatingSearchExp`
+
+Утилита, строящая регистронезависимое глобальное регулярное выражение `RegExp` для поиска строк, содержащих **любое** из слов поисковой строки (разделение пробелом).
+
+Каждое слово разбивается пробелами, экранируется и объединяется символом "или" `|`. Это полезно, когда нужно найти совпадение хотя бы по одному из введённых слов.
+
+**Параметры:**
+- `search: string` — Строка поиска, состоящая из одного или нескольких слов, разделённых пробелами.
+
+**Возвращает:**
+`RegExp` — Регулярное выражение с флагами `ig` (глобальный, без учёта регистра).
+
+```typescript
+import { getSeparatingSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getSeparatingSearchExp('foo bar')
+
+regex.test('foo')          // true
+regex.test('bar')          // true
+regex.test('foo bar baz')  // true
+regex.test('something')    // false
+
+// Специальные символы экранируются автоматически
+const regex2 = getSeparatingSearchExp('$10 .')
+regex2.test('$10') // true
+regex2.test('.')   // true
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getSeparatingSearchExp - Tạo RegExp tìm kiếm theo từ tách biệt'/>
+
+# `getSeparatingSearchExp`
+
+Tiện ích tạo một `RegExp` toàn cục, không phân biệt chữ hoa/thường để tìm kiếm các chuỗi chứa **bất kỳ** từ nào từ chuỗi tìm kiếm (phân tách bằng dấu cách).
+
+Mỗi từ được tách bởi dấu cách, escape và nối với nhau bằng toán tử OR `|`. Điều này hữu ích khi bạn muốn tìm kết quả khớp với ít nhất một trong các từ đã nhập.
+
+**Tham số:**
+- `search: string` — Chuỗi tìm kiếm gồm một hoặc nhiều từ phân cách bởi dấu cách.
+
+**Trả về:**
+`RegExp` — Biểu thức chính quy với cờ `ig` (toàn cục, không phân biệt chữ hoa/thường).
+
+```typescript
+import { getSeparatingSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getSeparatingSearchExp('foo bar')
+
+regex.test('foo')          // true
+regex.test('bar')          // true
+regex.test('foo bar baz')  // true
+regex.test('something')    // false
+
+// Các ký tự đặc biệt được escape tự động
+const regex2 = getSeparatingSearchExp('$10 .')
+regex2.test('$10') // true
+regex2.test('.')   // true
+```

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

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getStepPercent - Calculate percentage step'/>
+
+# `getStepPercent`
+
+Calculates what percentage of the total range (between the minimum and maximum values) corresponds to a single unit (or one step = 1). This function is helpful when positioning segments of sliders or progress bars using percentages.
+
+**Parameters:**
+- `min: number | undefined` — The minimum value of the range. If `undefined` is passed, `0` is used.
+- `max: number` — The maximum value of the range.
+
+**Returns:**
+`number` — The percentage (from 0 to 100) that one step occupies. If the maximum value is less than or equal to the minimum, it returns `0`.
+
+```typescript
+import { getStepPercent } from '@dxtmisha/functional-basic'
+
+// Range from 0 to 200, so a step of 1 corresponds to 0.5%
+console.log(getStepPercent(0, 200)) // 0.5
+
+// Range from 50 to 150 (difference 100), a step is 1%
+console.log(getStepPercent(50, 150)) // 1
+```

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

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getStepPercent - Вычисление шага в процентах'/>
+
+# `getStepPercent`
+
+Вычисляет, какой процент от общего диапазона (между минимальным и максимальным значениями) составляет одна единица (или один шаг = 1). Функция полезна для позиционирования элементов слайдеров или прогресс-баров в процентах.
+
+**Параметры:**
+- `min: number | undefined` — Минимальное значение диапазона. Если передано `undefined`, будет использован `0`.
+- `max: number` — Максимальное значение диапазона.
+
+**Возвращает:**
+`number` — Процент (от 0 до 100), который занимает один шаг. Если максимальное значение меньше или равно минимальному, функция вернет `0`.
+
+```typescript
+import { getStepPercent } from '@dxtmisha/functional-basic'
+
+// Диапазон от 0 до 200, значит 1 шаг это 0.5%
+console.log(getStepPercent(0, 200)) // 0.5
+
+// Диапазон от 50 до 150 (разница 100), шаг = 1%
+console.log(getStepPercent(50, 150)) // 1
+```

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

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getStepPercent - Tính toán phần trăm của một bước'/>
+
+# `getStepPercent`
+
+Tính toán xem phần trăm của toàn bộ phạm vi (tính từ giá trị nhỏ nhất đến giá trị lớn nhất) tương ứng với độ dài của một đơn vị (hoặc một bước = 1). Hàm này rất hữu ích khi thiết lập vị trí các thành phần của thanh trượt (slider) hoặc thanh tiến trình tính theo phần trăm.
+
+**Tham số:**
+- `min: number | undefined` — Giá trị tối thiểu của khoảng. Nếu truyền `undefined`, nó sẽ dùng `0`.
+- `max: number` — Giá trị tối đa của khoảng.
+
+**Trả về:**
+`number` — Phần trăm (từ 0 đến 100) mà một bước chiếm. Nếu giá trị tối đa nhỏ hơn hoặc bằng giá trị tối thiểu, hàm sẽ trả về `0`.
+
+```typescript
+import { getStepPercent } from '@dxtmisha/functional-basic'
+
+// Phạm vi từ 0 tới 200, vậy 1 bước sẽ bằng 0.5%
+console.log(getStepPercent(0, 200)) // 0.5
+
+// Phạm vi từ 50 tới 150 (chênh lệch 100), bước là 1%
+console.log(getStepPercent(50, 150)) // 1
+```

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

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getStepValue - Calculate absolute step value'/>
+
+# `getStepValue`
+
+Calculates the absolute value of one percent (`1%`) of the total range (the difference between the minimum and maximum values). This function is useful for determining by how much a slider's or a progress bar's coordinate should be updated when shifted by 1%.
+
+**Parameters:**
+- `min: number | undefined` — The minimum value of the range. If `undefined` is passed, `0` is used.
+- `max: number` — The maximum value of the range.
+
+**Returns:**
+`number` — The value representing 1% of the range's length. If the maximum value is less than or equal to the minimum, it returns `0`.
+
+```typescript
+import { getStepValue } from '@dxtmisha/functional-basic'
+
+// Range from 0 to 500, so 1% corresponds to 5 units
+console.log(getStepValue(0, 500)) // 5
+
+// Range from 50 to 150 (difference 100), 1% is 1 unit
+console.log(getStepValue(50, 150)) // 1
+```

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

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getStepValue - Расчет абсолютного значения шага'/>
+
+# `getStepValue`
+
+Вычисляет абсолютное значение одного процента (`1%`) от общего диапазона (разницы между минимальным и максимальным значениями). Функция полезна для определения, насколько изменить значение слайдера или прогресс-бара при сдвиге на 1%.
+
+**Параметры:**
+- `min: number | undefined` — Минимальное значение диапазона. Если передано `undefined`, будет использован `0`.
+- `max: number` — Максимальное значение диапазона.
+
+**Возвращает:**
+`number` — Значение, равное 1% от длины диапазона. Если максимальное значение меньше или равно минимальному, функция вернет `0`.
+
+```typescript
+import { getStepValue } from '@dxtmisha/functional-basic'
+
+// Диапазон от 0 до 500, значит 1% это 5 ед.
+console.log(getStepValue(0, 500)) // 5
+
+// Диапазон от 50 до 150 (разница 100), значит 1% это 1 ед.
+console.log(getStepValue(50, 150)) // 1
+```