@dxtmisha/wiki 0.25.1 → 0.39.2

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

@@ -0,0 +1,26 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getElement - Truy xuất phần tử HTML'/>
+
+# `getElement`
+
+Trả về một `Element` (nút HTML) từ tài liệu. Tiện ích này nhận vào một chuỗi bộ chọn CSS, đối tượng `Window` hoặc một `Element` có sẵn và trả về nút DOM tương ứng nếu được thực thi trong môi trường trình duyệt. Trong các môi trường không có DOM (ví dụ: SSR), nó trả về `undefined`.
+
+**Tham số:**
+- `element?: ElementOrString<E>` — Bộ chọn CSS (ví dụ: `'.btn'`), đối tượng `Window`, hoặc một nút `Element` đã có.
+
+**Trả về:**
+`R | undefined` — Nút DOM được tìm thấy hoặc được cung cấp, hoặc `document.body` nếu truyền vào là `Window`. Trả về `undefined` nếu không tìm thấy phần tử hoặc môi trường DOM không khả dụng.
+
+```typescript
+import { getElement } from '@dxtmisha/functional-basic'
+
+// Tìm kiếm theo bộ chọn CSS
+const btn = getElement('.submit-btn')
+
+// Truyền vào một phần tử đã có sẵn
+const sameBtn = getElement(btn)
+
+// Truyền vào Window sẽ trả về document.body
+const body = getElement(window)
+```

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

@@ -0,0 +1,32 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getElementId - Get or assign element ID'/>
+
+# `getElementId`
+
+Returns the `id` of a specified DOM element. If the element exists but does not have an `id` attribute, the function will automatically generate a unique identifier, assign it to the element, and return it.
+
+Additionally, the function allows appending a CSS selector to the returned string, so you can immediately use the result as a compound selector (e.g., `"#id-123456 .child-class"`).
+
+**Parameters:**
+- `element?: ElementOrString<E>` — A DOM element or selector from which to obtain the ID.
+- `selector?: string` — An optional string that will be appended to the returned ID (like pseudo-classes or descendant selectors).
+
+**Returns:**
+`string` — The element's ID string, or a newly generated ID string if the element is not found.
+
+```typescript
+import { getElementId } from '@dxtmisha/functional-basic'
+
+// Element has no ID
+const div = document.createElement('div')
+console.log(div.id) // ''
+
+const id = getElementId(div)
+console.log(id) // For example: 'id-123456'
+console.log(div.id) // 'id-123456' (assigned automatically)
+
+// Using an additional selector
+const selector = getElementId(div, ' > span.active')
+console.log(selector) // '#id-123456 > span.active'
+```

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

@@ -0,0 +1,32 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getElementId - Получение или назначение ID элемента'/>
+
+# `getElementId`
+
+Возвращает `id` указанного DOM-элемента. Если элемент существует, но у него нет атрибута `id`, функция автоматически сгенерирует уникальный идентификатор, назначит его элементу и вернет.
+
+Также функция позволяет опционально добавить CSS-селектор к возвращаемой строке, чтобы сразу использовать результат как готовый составной селектор (например, `"#id-123456 .child-class"`).
+
+**Параметры:**
+- `element?: ElementOrString<E>` — DOM-элемент или селектор, для которого нужно получить/назначить ID.
+- `selector?: string` — Опциональная строка, которая будет добавлена к возвращаемому значению (например, псевдоклассы или селекторы потомков).
+
+**Возвращает:**
+`string` — Строка с ID элемента, либо строка сгенерированного ID, если элемент не найден.
+
+```typescript
+import { getElementId } from '@dxtmisha/functional-basic'
+
+// У элемента нет ID
+const div = document.createElement('div')
+console.log(div.id) // ''
+
+const id = getElementId(div)
+console.log(id) // Например: 'id-123456'
+console.log(div.id) // 'id-123456' (назначился автоматически)
+
+// Использование дополнительного селектора
+const selector = getElementId(div, ' > span.active')
+console.log(selector) // '#id-123456 > span.active'
+```

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

@@ -0,0 +1,32 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getElementId - Lấy hoặc gán ID phần tử'/>
+
+# `getElementId`
+
+Trả về `id` của một phần tử DOM được chỉ định. Nếu phần tử tồn tại nhưng không có thuộc tính `id`, hàm sẽ tự động tạo một mã định danh duy nhất, gán nó cho phần tử và trả về mã đó.
+
+Ngoài ra, hàm cho phép đính kèm một bộ chọn CSS vào chuỗi trả về, để bạn có thể sử dụng ngay kết quả dưới dạng một bộ chọn kết hợp (ví dụ: `"#id-123456 .child-class"`).
+
+**Tham số:**
+- `element?: ElementOrString<E>` — Phần tử DOM hoặc chuỗi chọn để lấy ID.
+- `selector?: string` — Chuỗi tùy chọn sẽ được gắn vào giá trị ID trả về (chẳng hạn như các lớp giả hoặc bộ chọn phần tử con).
+
+**Trả về:**
+`string` — Chuỗi ID của phần tử, hoặc một chuỗi ID mới được tạo ra nếu không tìm thấy phần tử.
+
+```typescript
+import { getElementId } from '@dxtmisha/functional-basic'
+
+// Phần tử ban đầu không có ID
+const div = document.createElement('div')
+console.log(div.id) // ''
+
+const id = getElementId(div)
+console.log(id) // Ví dụ: 'id-123456'
+console.log(div.id) // 'id-123456' (tự động được gán)
+
+// Sử dụng bộ chọn bổ sung
+const selector = getElementId(div, ' > span.active')
+console.log(selector) // '#id-123456 > span.active'
+```

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

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getElementImage - Get image element'/>
+
+# `getElementImage`
+
+Used to safely retrieve an `HTMLImageElement` node. If a string (an image URL) is passed as input, the function automatically creates an `<img>` tag and assigns the URL to its `src` attribute. If an `HTMLImageElement` object is already passed, it simply returns it unchanged.
+
+**Parameters:**
+- `image: HTMLImageElement | string` — An image element or a string source (URL).
+
+**Returns:**
+`HTMLImageElement | undefined` — A ready-to-use `<img>` tag, or `undefined` if the environment does not allow its creation (e.g., no DOM).
+
+```typescript
+import { getElementImage } from '@dxtmisha/functional-basic'
+
+// Passing a string URL
+const img1 = getElementImage('/path/to/image.png')
+console.log(img1 instanceof HTMLImageElement) // true
+console.log(img1?.src) // 'http://.../path/to/image.png'
+
+// Passing an existing img tag
+const existingImg = document.createElement('img')
+const img2 = getElementImage(existingImg)
+console.log(img1 === existingImg) // true
+```

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

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getElementImage - Получение элемента изображения'/>
+
+# `getElementImage`
+
+Служит для безопасного получения узла `HTMLImageElement`. Если на вход подана строка (ссылка на изображение), функция автоматически создаст тег `<img>` и назначит ему эту ссылку (`src`). Если на вход уже передан объект изображения `HTMLImageElement`, он просто возвращается без изменений.
+
+**Параметры:**
+- `image: HTMLImageElement | string` — Элемент изображения или строковый источник (URL).
+
+**Возвращает:**
+`HTMLImageElement | undefined` — Готовый к использованию тег `<img>`, либо `undefined` если окружение не позволяет его создать (например, нет DOM).
+
+```typescript
+import { getElementImage } from '@dxtmisha/functional-basic'
+
+// Передаем строку - ссылка
+const img1 = getElementImage('/path/to/image.png')
+console.log(img1 instanceof HTMLImageElement) // true
+console.log(img1?.src) // 'http://.../path/to/image.png'
+
+// Передаем существующий тег img
+const existingImg = document.createElement('img')
+const img2 = getElementImage(existingImg)
+console.log(img1 === existingImg) // true
+```

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

@@ -0,0 +1,27 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getElementImage - Lấy phần tử hình ảnh'/>
+
+# `getElementImage`
+
+Dùng để lấy nút `HTMLImageElement` một cách an toàn. Nếu truyền vào một chuỗi (đường dẫn URL), hàm sẽ tự động tạo thẻ `<img>` và gán chuỗi đó cho thuộc tính `src`. Nếu giá trị truyền vào đã là một đối tượng `HTMLImageElement`, hàm chỉ cần trả về đối tượng đó giữ nguyên.
+
+**Tham số:**
+- `image: HTMLImageElement | string` — Phần tử hình ảnh hoặc một nguồn chuỗi (URL).
+
+**Trả về:**
+`HTMLImageElement | undefined` — Một thẻ `<img>` đã sẵn sàng để sử dụng, hoặc `undefined` nếu môi trường không cho phép tạo (ví dụ: không có DOM).
+
+```typescript
+import { getElementImage } from '@dxtmisha/functional-basic'
+
+// Truyền vào đường dẫn chuỗi (URL)
+const img1 = getElementImage('/path/to/image.png')
+console.log(img1 instanceof HTMLImageElement) // true
+console.log(img1?.src) // 'http://.../path/to/image.png'
+
+// Truyền vào thẻ img có sẵn
+const existingImg = document.createElement('img')
+const img2 = getElementImage(existingImg)
+console.log(img1 === existingImg) // true
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getElementItem - Retrieve element property value'/>
+
+# `getElementItem`
+
+Returns the value of a specific property from an HTML element (e.g., `id`, `className`, or any custom property if it's defined as a key on the element type). The utility uses `getElement` to find the node, and if the element is not found or lacks the specified property, it returns `defaultValue` (which defaults to `undefined`).
+
+**Parameters:**
+- `element: ElementOrString<T>` — A selector string or an existing DOM element.
+- `index: K | string` — The property name (key) of the element whose value is required.
+- `defaultValue?: D` — A fallback value returned if the property is not found.
+
+**Returns:**
+`T[K] | D | undefined` — The value of the requested property or the `defaultValue`.
+
+```typescript
+import { getElementItem } from '@dxtmisha/functional-basic'
+
+const input = document.createElement('input')
+input.type = 'text'
+input.id = 'my-input'
+
+// Getting the ID
+const elementId = getElementItem(input, 'id') 
+console.log(elementId) // 'my-input'
+
+// If the property is missing and we provide a fallback
+const testValue = getElementItem('.non-existent', 'id', 'fallback-id')
+console.log(testValue) // 'fallback-id'
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getElementItem - Получение значения свойства элемента'/>
+
+# `getElementItem`
+
+Возвращает значение определенного свойства из HTML-элемента (например, `id`, `className`, пользовательское свойство, если оно определено как ключ объекта типа элемента). Утилита использует `getElement` для поиска узла, и если элемент не найден или у него нет указанного свойства, возвращает `defaultValue` (которое по умолчанию равно `undefined`).
+
+**Параметры:**
+- `element: ElementOrString<T>` — Строка селектора или готовый DOM-элемент.
+- `index: K | string` — Имя свойства элемента (ключ), значение которого требуется получить.
+- `defaultValue?: D` — Значение по умолчанию, возвращаемое, если свойство не найдено.
+
+**Возвращает:**
+`T[K] | D | undefined` — Значение запрашиваемого свойства или `defaultValue`.
+
+```typescript
+import { getElementItem } from '@dxtmisha/functional-basic'
+
+const input = document.createElement('input')
+input.type = 'text'
+input.id = 'my-input'
+
+// Получение ID
+const elementId = getElementItem(input, 'id') 
+console.log(elementId) // 'my-input'
+
+// Если свойство отсутствует и мы передаем fallback
+const testValue = getElementItem('.non-existent', 'id', 'fallback-id')
+console.log(testValue) // 'fallback-id'
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getElementItem - Lấy giá trị thuộc tính phần tử'/>
+
+# `getElementItem`
+
+Trả về giá trị của một thuộc tính cụ thể từ một phần tử HTML (ví dụ: `id`, `className`, hoặc bất kỳ thuộc tính tùy chỉnh nào nếu nó được khai báo là khóa của kiểu phần tử đó). Tiện ích sử dụng `getElement` để tìm nút, và nếu không tìm thấy phần tử hoặc phân tử không có thuộc tính được chỉ định, tiện ích sẽ trả về `defaultValue` (mặc định là `undefined`).
+
+**Tham số:**
+- `element: ElementOrString<T>` — Một chuỗi bộ chọn CSS hoặc một phần tử DOM có sẵn.
+- `index: K | string` — Tên thuộc tính (khóa) của phần tử có giá trị đang được yêu cầu.
+- `defaultValue?: D` — Giá trị dự phòng sẽ được trả về nếu không tìm thấy thuộc tính.
+
+**Trả về:**
+`T[K] | D | undefined` — Giá trị của thuộc tính được yêu cầu hoặc `defaultValue`.
+
+```typescript
+import { getElementItem } from '@dxtmisha/functional-basic'
+
+const input = document.createElement('input')
+input.type = 'text'
+input.id = 'my-input'
+
+// Lấy ID
+const elementId = getElementItem(input, 'id') 
+console.log(elementId) // 'my-input'
+
+// Nếu thiếu thuộc tính và chúng ta cung cấp một fallback
+const testValue = getElementItem('.non-existent', 'id', 'fallback-id')
+console.log(testValue) // 'fallback-id'
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getElementOrWindow - Retrieve Element or Window'/>
+
+# `getElementOrWindow`
+
+This utility is similar to `getElement`, but with one significant difference: if the global `window` object is passed as an argument, the function returns it exactly. `getElement` in the same scenario would return `document.body`.
+
+If a string or another element is passed, the function behaves exactly like the standard `getElement` utility.
+
+**Parameters:**
+- `element?: ElementOrString<E>` — A selector to search for, an `Element` node, or the `Window` object.
+
+**Returns:**
+`E | undefined` — The located element, the originally passed element, the `window` object (if it was passed), or `undefined` if nothing matched.
+
+```typescript
+import { getElementOrWindow } from '@dxtmisha/functional-basic'
+
+// Passing Window returns Window (by contrast, getElement would return document.body)
+const win = getElementOrWindow(window)
+
+// Normal search by selector
+const btn = getElementOrWindow('.submit-btn')
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getElementOrWindow - Получение элемента или объекта window'/>
+
+# `getElementOrWindow`
+
+Эта утилита аналогична `getElement`, но с одним существенным отличием: если в качестве аргумента передан глобальный объект `window`, функция вернёт именно его. `getElement` в такой же ситуации возвращает `document.body`. 
+
+Если передана строка или другой элемент, функция действует как стандартный `getElement`.
+
+**Параметры:**
+- `element?: ElementOrString<E>` — Селектор для поиска, элемент `Element` или объект `Window`.
+
+**Возвращает:**
+`E | undefined` — Найденный элемент, изначальный переданный элемент, сам объект `window` (если он был передан), или `undefined` если ничего не найдено.
+
+```typescript
+import { getElementOrWindow } from '@dxtmisha/functional-basic'
+
+// Передача Window вернет Window (для сравнения getElement вернул бы document.body)
+const win = getElementOrWindow(window)
+
+// Обычный поиск по селектору
+const btn = getElementOrWindow('.submit-btn')
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getElementOrWindow - Truy xuất Element hoặc Window'/>
+
+# `getElementOrWindow`
+
+Tiện ích này tương tự như `getElement`, nhưng có một điểm khác biệt đáng kể: nếu đối tượng toàn cục `window` được truyền vào dưới dạng một tham số, hàm sẽ trả về chính xác đối tượng đó. (Trái ngược với `getElement`, khi `getElement` sẽ trả về `document.body`).
+
+Nếu truyền vào một chuỗi hoặc một phần tử khác, hàm sẽ hoạt động giống hệt như tiện ích `getElement` tiêu chuẩn.
+
+**Tham số:**
+- `element?: ElementOrString<E>` — Một bộ chọn để tìm kiếm, một nút `Element`, hoặc đối tượng `Window`.
+
+**Trả về:**
+`E | undefined` — Phần tử được tìm thấy, phần tử được truyền vào ban đầu, bản thân đối tượng `window` (nếu đối tượng này được truyền vào), hoặc `undefined` nếu không có phần tử nào khớp.
+
+```typescript
+import { getElementOrWindow } from '@dxtmisha/functional-basic'
+
+// Việc truyền vào Window sẽ trả về Window (ngược lại, getElement sẽ trả về document.body)
+const win = getElementOrWindow(window)
+
+// Tìm kiếm bình thường bằng bộ chọn
+const btn = getElementOrWindow('.submit-btn')
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getExactSearchExp - Build a RegExp for exact match'/>
+
+# `getExactSearchExp`
+
+A utility that builds a case-insensitive `RegExp` for an exact match of the given string.
+
+Unlike `getSearchExp`, this function matches the entire string (with special characters escaped) without splitting it into separate words.
+
+**Parameters:**
+- `search: string` — The search string for exact matching.
+
+**Returns:**
+`RegExp` — A regular expression with the `i` flag (case-insensitive).
+
+```typescript
+import { getExactSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getExactSearchExp('hello')
+
+regex.test('hello')       // true
+regex.test('HELLO')       // true
+regex.test('hello world') // false — not an exact match
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getExactSearchExp - Создание RegExp для точного поиска'/>
+
+# `getExactSearchExp`
+
+Утилита, создающая регистронезависимое регулярное выражение `RegExp` для поиска точного совпадения строки.
+
+В отличие от `getSearchExp`, эта функция ищет строку целиком (с экранированием спецсимволов), не разделяя её на отдельные слова.
+
+**Параметры:**
+- `search: string` — Строка поиска для точного сопоставления.
+
+**Возвращает:**
+`RegExp` — Регулярное выражение с флагом `i` (без учёта регистра).
+
+```typescript
+import { getExactSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getExactSearchExp('hello')
+
+regex.test('hello')       // true
+regex.test('HELLO')       // true
+regex.test('hello world') // false — не точное совпадение
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getExactSearchExp - Tạo RegExp để khớp chính xác'/>
+
+# `getExactSearchExp`
+
+Tiện ích tạo một `RegExp` không phân biệt chữ hoa/thường để khớp chính xác với chuỗi đã cho.
+
+Khác với `getSearchExp`, hàm này khớp với toàn bộ chuỗi (với các ký tự đặc biệt được escape) mà không tách nó thành các từ riêng biệt.
+
+**Tham số:**
+- `search: string` — Chuỗi tìm kiếm để khớp chính xác.
+
+**Trả về:**
+`RegExp` — Biểu thức chính quy với cờ `i` (không phân biệt chữ hoa/thường).
+
+```typescript
+import { getExactSearchExp } from '@dxtmisha/functional-basic'
+
+const regex = getExactSearchExp('hello')
+
+regex.test('hello')       // true
+regex.test('HELLO')       // true
+regex.test('hello world') // false — không phải khớp chính xác
+```

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

@@ -0,0 +1,29 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getExp - Create a RegExp with escaped string'/>
+
+# `getExp`
+
+A utility that creates a `RegExp` object from a template string by first escaping all special regular expression characters within it (such as `.` `*` `+` `?` `^` `$` `{` `}` `(` `)` `|` `[` `]` `\`).
+
+This is essential when the search string comes from user input or contains characters that could break a regular expression. The function allows you to specify the regex flags and a pattern string where the escaped text will replace the `:value` token.
+
+**Parameters:**
+- `value: string` — The target string to be escaped and matched.
+- `flags?: string` — (optional) Regular expression flags (e.g., `'ig'`). Defaults to `'ig'` (case-insensitive and global search).
+- `pattern?: string` — (optional) The regular expression template string. Defaults to just `':value'`.
+
+**Returns:**
+`RegExp` — The constructed regular expression object.
+
+```typescript
+import { getExp } from '@dxtmisha/functional-basic'
+
+// Basic search
+const rx1 = getExp('user.name')
+console.log(rx1) // /user\.name/gi  (dot is escaped)
+
+// Search with a custom flag and pattern (e.g., "starts with")
+const rx2 = getExp('query[1]', 'i', '^:value.*')
+console.log(rx2) // /^query\[1\].*/i
+```

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

@@ -0,0 +1,29 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getExp - Создание регулярного выражения из строки с экранированием'/>
+
+# `getExp`
+
+Утилита, создающая объект регулярного выражения `RegExp` из строки-шаблона, предварительно экранируя в ней все специальные символы регулярных выражений (такие как `.` `*` `+` `?` `^` `$` `{` `}` `(` `)` `|` `[` `]` `\`).
+
+Это необходимо, если искомая строка поступает от пользователя или содержит символы, которые могли бы сломать регулярное выражение. В функции также можно задать флаги регулярного выражения и шаблон, в который будет подставлена экранированная строка вместо метки `:value`.
+
+**Параметры:**
+- `value: string` — Искомая строка, которую нужно экранировать.
+- `flags?: string` — (опционально) Флаги регулярного выражения (например, `'ig'`). По умолчанию `'ig'` (игнорирование регистра и глобальный поиск).
+- `pattern?: string` — (опционально) Строка-шаблон регулярного выражения. По умолчанию просто `':value'`.
+
+**Возвращает:**
+`RegExp` — Объект регулярного выражения.
+
+```typescript
+import { getExp } from '@dxtmisha/functional-basic'
+
+// Обычный поиск
+const rx1 = getExp('user.name')
+console.log(rx1) // /user\.name/gi  (точка экранирована)
+
+// Поиск с пользовательским флагом и шаблоном (например, "начинается с")
+const rx2 = getExp('query[1]', 'i', '^:value.*')
+console.log(rx2) // /^query\[1\].*/i
+```

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

@@ -0,0 +1,29 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getExp - Tạo cấu trúc RegExp với chuỗi đã đánh dấu (escaped)'/>
+
+# `getExp`
+
+Tiện ích này tạo ra một đối tượng `RegExp` từ một chuỗi mẫu bằng cách thực hiện "thoát" (escape) tất cả các ký tự đặc biệt của biểu thức chính quy bên trong chuỗi đó (chẳng hạn như `.` `*` `+` `?` `^` `$` `{` `}` `(` `)` `|` `[` `]` `\`).
+
+Điều này rất cần thiết khi chuỗi tìm kiếm đến từ người dùng hoặc chứa các ký tự có thể phá vỡ một biểu thức chính quy. Hàm cho phép bạn chỉ định các cờ (flags) cho `RegExp` cũng như một chuỗi mẫu nơi đoạn văn bản đã "escape" sẽ thay thế token `:value`.
+
+**Tham số:**
+- `value: string` — Chuỗi đích cần escape.
+- `flags?: string` — (tuỳ chọn) Các cờ cấu hình (ví dụ: `'ig'`). Mặc định là `'ig'` (không phân biệt chữ hoa/thường và tìm toàn cục).
+- `pattern?: string` — (tuỳ chọn) Chuỗi mẫu biểu thức chính quy. Mặc định chỉ là `':value'`.
+
+**Trả về:**
+`RegExp` — Đối tượng biểu thức chính quy.
+
+```typescript
+import { getExp } from '@dxtmisha/functional-basic'
+
+// Tìm kiếm cơ bản
+const rx1 = getExp('user.name')
+console.log(rx1) // /user\.name/gi  (dấu chấm đã được escape)
+
+// Tìm kiếm với cờ và chuỗi mẫu tuỳ chỉnh (ví dụ: "bắt đầu bằng")
+const rx2 = getExp('query[1]', 'i', '^:value.*')
+console.log(rx2) // /^query\[1\].*/i
+```

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

@@ -0,0 +1,38 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getItemByPath - Access deeply nested properties'/>
+
+# `getItemByPath`
+
+A utility that safely retrieves a value from a deeply nested object using a path string with dot (`.`) separated keys. If the property or any intermediate segment is not found, the function gracefully returns `undefined` (preventing *Cannot read properties of undefined* errors).
+
+**Note:** The function allows specifying a generic return type `R` (which defaults to `string`). It supports accessing array items by using a stringified index in the path (e.g., `"list.0.name"`).
+
+**Parameters:**
+- `item: T` — The target object or array to inspect.
+- `path: string` — The dot-separated property path (e.g., `"user.address.city"` or `"list.1.id"`).
+
+**Returns:**
+`R | undefined` — The value of the requested property (of type `R`), or `undefined` if any segment in the path is missing.
+
+```typescript
+import { getItemByPath } from '@dxtmisha/functional-basic'
+
+const data = {
+  profile: {
+    details: {
+      bio: 'UI Developer'
+    }
+  },
+  roles: ['admin', 'manager']
+}
+
+// Successful retrieval
+console.log(getItemByPath(data, 'profile.details.bio')) // 'UI Developer'
+
+// Accessing an array via a string index
+console.log(getItemByPath(data, 'roles.0')) // 'admin'
+
+// Safely failing on nonexistent paths
+console.log(getItemByPath(data, 'profile.missing.key')) // undefined
+```

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

@@ -0,0 +1,38 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getItemByPath - Доступ к вложенному свойству'/>
+
+# `getItemByPath`
+
+Утилита, которая безопасно извлекает значение из глубоко вложенного объекта, используя строку с путем, где уровни вложенности разделены точкой (`.`). Если свойство на любом из этапов не найдено, функция изящно вернёт `undefined` (избегая ошибки *Cannot read properties of undefined*).
+
+**Примечание:** Функция позволяет передать обобщенный тип возвращаемого значения `R` (по умолчанию `string`). При доступе к массиву в качестве ключа можно указывать строковый индекс (`"list.0.name"`).
+
+**Параметры:**
+- `item: T` — Целевой объект или массив, в котором осуществляется поиск.
+- `path: string` — Путь к свойству, разделенный точками (например, `"user.address.city"` или `"list.1.id"`).
+
+**Возвращает:**
+`R | undefined` — Значение целевого свойства (типа `R`), либо `undefined`, если свойство или промежуточный шаг отсутствует.
+
+```typescript
+import { getItemByPath } from '@dxtmisha/functional-basic'
+
+const data = {
+  profile: {
+    details: {
+      bio: 'Разработчик интерфейсов'
+    }
+  },
+  roles: ['admin', 'manager']
+}
+
+// Успешный доступ
+console.log(getItemByPath(data, 'profile.details.bio')) // 'Разработчик интерфейсов'
+
+// Доступ к массиву по индексу (написанному строкой)
+console.log(getItemByPath(data, 'roles.0')) // 'admin'
+
+// Безопасное падение на несуществующее свойство
+console.log(getItemByPath(data, 'profile.missing.key')) // undefined
+```