@dxtmisha/wiki 0.39.7 → 0.39.8

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

@@ -1,27 +1,31 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/en/functional-basic/Functions/copyObject - Copy an object'/>
 
 # `copyObject`
 
-Creates a deep copy of objects and arrays containing basic data types.
-
-This is useful when you need to avoid mutating the original state. Keep in mind that it does not copy functions, symbols, or `undefined` values, and it cannot handle circular references (under the hood it uses `JSON.parse(JSON.stringify(value))`).
+Creates a deep copy of an object for independent data management. The goal of the method is to obtain a completely separate instance of the data to prevent unintended mutations in the original object.
 
 **Parameters:**
-- `value: T` — The object or value to be copied.
+- `value: T` — The object or array to be copied.
 
 **Returns:**
 `T` — A new copy of the object.
 
-```typescript
-import { copyObject } from '@dxtmisha/functional-basic'
+## Examples
 
-const original = { name: 'John', details: { age: 30 } }
-const copy = copyObject(original)
+<Source
+  language='typescript'
+  code={`
+import { copyObject } from '@dxtmisha/functional-basic'
 
-copy.details.age = 31
+const original = { 
+  name: 'John', 
+  age: 30,
+  details: { role: 'admin' }
+}
 
-console.log(original.details.age) // 30 (the original object did not change)
-console.log(copy.details.age) // 31
-```
+const copy = copyObject(original)
+// copy is a completely new object for independent management
+  `}
+/>

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

@@ -1,27 +1,31 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/functional-basic/Functions/copyObject - Копирование объекта'/>
 
 # `copyObject`
 
-Создает глубокую копию (deep copy) объектов и массивов, содержащих базовые типы данных.
-
-Это полезно, когда нужно избежать мутаций исходного состояния. Однако следует помнить, что утилита не копирует функции, символы, значения `undefined` и не может обработать циклические ссылки (внутри используется `JSON.parse(JSON.stringify(value))`).
+Создает глубокую копию объекта для независимого управления данными. Цель метода — получить полностью новый отдельный экземпляр данных во избежание нежелательных мутаций в исходном объекте.
 
 **Параметры:**
-- `value: T` — Объект или значение, которое необходимо скопировать.
+- `value: T` — Объект или массив, который необходимо скопировать.
 
 **Возвращает:**
 `T` — Новая копия объекта.
 
-```typescript
-import { copyObject } from '@dxtmisha/functional-basic'
+## Примеры
 
-const original = { name: 'John', details: { age: 30 } }
-const copy = copyObject(original)
+<Source
+  language='typescript'
+  code={`
+import { copyObject } from '@dxtmisha/functional-basic'
 
-copy.details.age = 31
+const original = { 
+  name: 'John', 
+  age: 30,
+  details: { role: 'admin' }
+}
 
-console.log(original.details.age) // 30 (исходный объект не изменился)
-console.log(copy.details.age) // 31
-```
+const copy = copyObject(original)
+// copy — это полностью новый экземпляр для независимого управления
+  `}
+/>

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

@@ -1,27 +1,31 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/vi/functional-basic/Functions/copyObject - Sao chép đối tượng'/>
 
 # `copyObject`
 
-Tạo bản sao sâu (deep copy) của các đối tượng và mảng chứa các kiểu dữ liệu cơ bản.
-
-Điều này hữu ích khi bạn cần tránh thay đổi trực tiếp dữ liệu (mutate) của trạng thái ban đầu. Hãy nhớ rằng nó không sao chép các hàm, ký hiệu symbols, giá trị `undefined` và không thể xử lý các tham chiếu vòng (circular references) (do tiện ích sử dụng `JSON.parse(JSON.stringify(value))`).
+Tạo bản sao sâu của đối tượng để quản lý dữ liệu độc lập. Mục tiêu của phương thức là có được một phiên bản riêng biệt hoàn toàn mới của dữ liệu để tránh các thay đổi ngoài ý muốn đối với đối tượng gốc.
 
 **Tham số:**
-- `value: T` — Đối tượng hoặc giá trị cần sao chép.
+- `value: T` — Đối tượng hoặc mảng cần sao chép.
 
 **Trả về:**
 `T` — Bản sao mới của đối tượng.
 
-```typescript
-import { copyObject } from '@dxtmisha/functional-basic'
+## Ví dụ
 
-const original = { name: 'John', details: { age: 30 } }
-const copy = copyObject(original)
+<Source
+  language='typescript'
+  code={`
+import { copyObject } from '@dxtmisha/functional-basic'
 
-copy.details.age = 31
+const original = { 
+  name: 'John', 
+  age: 30,
+  details: { role: 'admin' }
+}
 
-console.log(original.details.age) // 30 (đối tượng gốc không bị thay đổi)
-console.log(copy.details.age) // 31
-```
+const copy = copyObject(original)
+// copy là một phiên bản hoàn toàn mới để quản lý độc lập
+  `}
+/>

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

@@ -8,6 +8,8 @@ In a browser environment, creates a new HTML element with the specified tag name
 
 The function relies on `isDomRuntime()` to verify the presence of a DOM environment. If the code executes outside the browser (e.g., during SSR on the server), the function will return `undefined`.
 
+> **Warning (SSR):** When running on the server, the function always returns `undefined`. If you use it within a component's rendering logic, it may lead to hydration mismatches. It is recommended to call this function only inside lifecycle hooks that run exclusively on the client (e.g., `onMounted` in Vue or `useEffect` in React).
+
 **Parameters:**
 - `parentElement?: HTMLElement` — The parent element into which the new node will be inserted.
 - `tagName: string = 'div'` — A string specifying the type of element to create (defaults to `'div'`).

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

@@ -8,6 +8,8 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Функция проверяет наличие DOM-окружения с помощью `isDomRuntime()`. Если код выполняется не в браузере (например, на сервере во время SSR), функция вернёт `undefined`.
 
+> **Внимание (SSR):** При выполнении на сервере функция всегда возвращает `undefined`. Если вы используете её внутри логики рендеринга компонента, это может привести к ошибкам гидратации. Рекомендуется вызывать эту функцию только в хуках жизненного цикла, которые выполняются на клиенте (например, `onMounted` в Vue или `useEffect` в React).
+
 **Параметры:**
 - `parentElement?: HTMLElement` — Родительский элемент, в который будет вставлен новый узел.
 - `tagName: string = 'div'` — Строка, определяющая тип создаваемого элемента (по умолчанию `'div'`).

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

@@ -8,6 +8,8 @@ Trong môi trường trình duyệt, tạo một phần tử HTML mới với th
 
 Hàm này kiểm tra sự tồn tại của môi trường DOM thông qua `isDomRuntime()`. Nếu mã không chạy trong trình duyệt (ví dụ: trên máy chủ trong quá trình SSR), hàm sẽ trả về `undefined`.
 
+> **Cảnh báo (SSR):** Khi chạy trên máy chủ, hàm luôn trả về `undefined`. Nếu bạn sử dụng nó trong logic hiển thị của component, nó có thể dẫn đến lỗi không khớp hyradtion (hydration mismatch). Bạn nên gọi hàm này trong các hook vòng đời chỉ chạy trên client (ví dụ: `onMounted` trong Vue hoặc `useEffect` trong React).
+
 **Tham số:**
 - `parentElement?: HTMLElement` — Phần tử mẹ sẽ chứa nút DOM mới.
 - `tagName: string = 'div'` — Chuỗi xác định loại phần tử sẽ được tạo (mặc định là `'div'`).

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

@@ -6,13 +6,11 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Encodes special characters in a string (`&`, `<`, `>`, `"`, `'`) into their corresponding HTML entities (`&amp;`, `&lt;`, `&gt;`, `&quot;`, `&#39;`). This is essential for safely inserting user or dynamic text into HTML attributes to prevent XSS attacks.
 
-Additionally, the function trims whitespace from the edges of the string using the `.trim()` method.
-
 **Parameters:**
 - `text: string` — The string to encode.
 
 **Returns:**
-`string` — The encoded string, trimmed of extra edge whitespace.
+`string` — The encoded string.
 
 ```typescript
 import { encodeAttribute } from '@dxtmisha/functional-basic'

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

@@ -6,13 +6,11 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Кодирует специальные символы в строке (`&`, `<`, `>`, `"`, `'`) в соответствующие HTML-сущности (`&amp;`, `&lt;`, `&gt;`, `&quot;`, `&#39;`). Это необходимо для безопасной вставки пользовательского или динамического текста в HTML-атрибуты для предотвращения XSS-атак.
 
-Кроме того, функция удаляет пробельные символы по краям строки с помощью метода `.trim()`.
-
 **Параметры:**
 - `text: string` — Строка, которую необходимо закодировать.
 
 **Возвращает:**
-`string` — Закодированная и очищенная от лишних пробелов по краям строка.
+`string` — Закодированная строка.
 
 ```typescript
 import { encodeAttribute } from '@dxtmisha/functional-basic'

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

@@ -6,13 +6,11 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Mã hóa các ký tự đặc biệt trong chuỗi (`&`, `<`, `>`, `"`, `'`) thành các thực thể HTML tương ứng (`&amp;`, `&lt;`, `&gt;`, `&quot;`, `&#39;`). Điều này là cần thiết để chèn văn bản người dùng hoặc văn bản động vào thuộc tính HTML một cách an toàn nhằm phòng chống tấn công XSS.
 
-Hơn nữa, hàm cũng loại bỏ các khoảng trắng ở hai đầu chuỗi bằng phương thức `.trim()`.
-
 **Tham số:**
 - `text: string` — Chuỗi cần được mã hóa.
 
 **Trả về:**
-`string` — Chuỗi đã được mã hóa và xóa khoảng trắng dư thừa ở hai đầu.
+`string` — Chuỗi đã được mã hóa.
 
 ```typescript
 import { encodeAttribute } from '@dxtmisha/functional-basic'

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

@@ -4,25 +4,28 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `executeFunction`
 
-A utility that checks the provided argument. If the argument is a function, it executes the function and returns its result. Otherwise, it simply returns the provided argument as is.
+A flexible utility designed to handle arguments that can be either a static value or a function. If the provided argument is a function, `executeFunction` invokes it with the specified arguments and returns the result. Otherwise, it returns the argument itself.
 
-This is extremely useful for handling arguments that can flexibly be either a static value or a function that calculates the value on demand (such as lazy evaluation or dynamic defaults).
+This pattern is highly effective for implementing lazy evaluation, dynamic default values, or configuration properties that can be either fixed or computed.
 
 **Parameters:**
-- `callback: T | FunctionArgs<any, T>` — A value of any type, or a function that returns a value of type `T`.
+- `callback: T | ((...args: any[]) => T)` — The value to process. Can be a literal value or a function returning type `T`.
+- `...args: any[]` (optional) — Arguments to pass to the function if `callback` is callable.
 
 **Returns:**
-`T` — The result of the function execution, or the raw value provided.
+`T` — The result of the function execution or the raw value.
 
 ```typescript
 import { executeFunction } from '@dxtmisha/functional-basic'
 
-// Passing a static value
+// 1. Static value handling
 console.log(executeFunction('Hello')) // 'Hello'
 
-// Passing a function
-const lazyValue = () => {
-  return 'Loaded lazily'
-}
-console.log(executeFunction(lazyValue)) // 'Loaded lazily'
+// 2. Dynamic execution
+const getLabel = (prefix: string) => `${prefix}: Dynamic Label`
+console.log(executeFunction(getLabel, 'Admin')) // 'Admin: Dynamic Label'
+
+// 3. Conditional logic in caller
+const value = Math.random() > 0.5 ? 'Static' : () => 'Computed'
+console.log(executeFunction(value)) // either 'Static' or 'Computed'
 ```

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

@@ -1,28 +1,31 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/ru/functional-basic/Functions/executeFunction - Выполнение функции или возврат значения'/>
+<Meta title='@dxtmisha/ru/functional-basic/Functions/executeFunction - Выполнить функцию или вернуть значение'/>
 
 # `executeFunction`
 
-Утилита, которая проверяет переданный аргумент. Если аргумент является функцией, он выполняется, и функция возвращает результат этого выполнения. В противном случае, переданный аргумент возвращается как есть (без изменений).
+Универсальная утилита для обработки аргументов, которые могут быть как статическим значением, так и функцией. Если переданный аргумент является функцией, `executeFunction` выполняет его с указанными аргументами и возвращает результат. В противном случае возвращается сам аргумент.
 
-Это полезно для параметров, которые могут быть как статическим значением, так и функцией, вычисляющей это значение по требованию (например, для ленивых вычислений или значений по умолчанию).
+Этот паттерн крайне эффективен для реализации «ленивых» вычислений, динамических значений по умолчанию или свойств конфигурации, которые могут быть как фиксированными, так и вычисляемыми.
 
 **Параметры:**
-- `callback: T | FunctionArgs<any, T>` — Значение любого типа или функция, возвращающая значение типа `T`.
+- `callback: T | ((...args: any[]) => T)` — Значение для обработки. Может быть литералом или функцией, возвращающей тип `T`.
+- `...args: any[]` (опционально) — Аргументы, которые будут переданы в функцию, если `callback` является вызываемым.
 
 **Возвращает:**
-`T` — Результат выполнения функции или переданное значение.
+`T` — Результат выполнения функции или само исходное значение.
 
 ```typescript
 import { executeFunction } from '@dxtmisha/functional-basic'
 
-// Передаем статическое значение
+// 1. Обработка статического значения
 console.log(executeFunction('Привет')) // 'Привет'
 
-// Передаем функцию
-const lazyValue = () => {
-  return 'Загружено лениво'
-}
-console.log(executeFunction(lazyValue)) // 'Загружено лениво'
+// 2. Динамическое выполнение
+const getLabel = (prefix: string) => `${prefix}: Текст`
+console.log(executeFunction(getLabel, 'Админ')) // 'Админ: Текст'
+
+// 3. Гибкая логика вызова
+const value = Math.random() > 0.5 ? 'Статика' : () => 'Вычислено'
+console.log(executeFunction(value)) // 'Статика' или 'Вычислено'
 ```

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

@@ -4,12 +4,13 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `executeFunction`
 
-Tiện ích kiểm tra đối số được cung cấp. Nếu đối số đó là một hàm, nó sẽ thực thi hàm và trả về kết quả của hàm đó. Trong trường hợp ngược lại, nó đơn giản trả về đối số đầu vào (giữ nguyên).
+Một tiện ích linh hoạt được thiết kế để xử lý các đối số có thể là giá trị tĩnh hoặc hàm. Nếu đối số được cung cấp là một hàm, `executeFunction` sẽ gọi hàm đó với các đối số đã chỉ định và trả về kết quả. Nếu không, nó sẽ trả về chính đối số đó.
 
-Điều này rất hữu ích cho các tham số có thể linh hoạt chấp nhận một giá trị tĩnh hoặc một hàm tính toán giá trị đó theo yêu cầu (ví dụ như khởi tạo chậm/lazy evaluation hoặc giá trị mặc định động).
+Mô hình này rất hiệu quả để triển khai tính toán lười biếng (lazy evaluation), các giá trị mặc định động hoặc các thuộc tính cấu hình có thể cố định hoặc được tính toán.
 
 **Tham số:**
-- `callback: T | FunctionArgs<any, T>` — Giá trị của bất kỳ loại nào, hoặc một hàm trả về giá trị kiểu `T`.
+- `callback: T | ((...args: any[]) => T)` — Giá trị cần xử lý. Có thể là một giá trị cụ thể hoặc một hàm trả về kiểu `T`.
+- `...args: any[]` (tùy chọn) — Các đối số được truyền vào hàm nếu `callback` có thể gọi được.
 
 **Trả về:**
 `T` — Kết quả của việc thực thi hàm hoặc chính giá trị ban đầu.
@@ -17,12 +18,14 @@ Tiện ích kiểm tra đối số được cung cấp. Nếu đối số đó l
 ```typescript
 import { executeFunction } from '@dxtmisha/functional-basic'
 
-// Truyền một giá trị tĩnh
+// 1. Xử lý giá trị tĩnh
 console.log(executeFunction('Xin chào')) // 'Xin chào'
 
-// Truyền một hàm
-const lazyValue = () => {
-  return 'Được tải lazy'
-}
-console.log(executeFunction(lazyValue)) // 'Được tải lazy'
+// 2. Thực thi động
+const getLabel = (prefix: string) => `${prefix}: Nhãn động`
+console.log(executeFunction(getLabel, 'Admin')) // 'Admin: Nhãn động'
+
+// 3. Logic điều kiện trong cuộc gọi
+const value = Math.random() > 0.5 ? 'Tĩnh' : () => 'Đã tính toán'
+console.log(executeFunction(value)) // 'Tĩnh' hoặc 'Đã tính toán'
 ```

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

@@ -4,29 +4,30 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `executePromise`
 
-A utility that safely executes a function and/or awaits the resolution of an asynchronous result (Promise).
+A robust utility for safely executing and awaiting results from flexible sources. It handles synchronous values, Promises, and functions (both synchronous and asynchronous) by ensuring the final result is always resolved and returned as a Promise.
 
-Under the hood, it uses the `executeFunction` utility. If passed a function returning a Promise, `executePromise` executes it and waits for the `Promise` to resolve. If a synchronous value or a regular function returning a synchronous value is passed, the utility immediately returns that result.
+Under the hood, it leverages `executeFunction` to resolve callables and then ensures that if the result is a `Promise`, it is properly awaited.
 
 **Parameters:**
-- `callback: (() => Promise<T>) | (() => T) | T` — A value, a `Promise`, or a function capable of returning a `Promise` or a plain value.
+- `callback: ((...args: any[]) => Promise<T>) | ((...args: any[]) => T) | T` — The source to execute or resolve.
+- `...args: any[]` (optional) — Arguments to pass to the function if `callback` is callable.
 
 **Returns:**
-`Promise<T>` — A promise resolving to the provided or computed value.
+`Promise<T>` — A promise that resolves to the final computed or provided value.
 
 ```typescript
 import { executePromise } from '@dxtmisha/functional-basic'
 
-// With an async function
-const fetchData = async () => {
-  return await fetch('/api/data').then(res => res.json())
+// 1. Awaiting an async function
+const fetchData = async (id: number) => {
+  return await fetch(`/api/user/${id}`).then(res => res.json())
 }
-const result1 = await executePromise(fetchData)
+const user = await executePromise(fetchData, 123)
 
-// With a synchronous function
-const staticData = () => 'Sync data'
-const result2 = await executePromise(staticData)
+// 2. Handling a synchronous function
+const getName = () => 'John Doe'
+const name = await executePromise(getName) // returns Promise resolving to 'John Doe'
 
-// With a static value
-const result3 = await executePromise('Data')
+// 3. Resolving a static value
+const result = await executePromise('Immediate Data')
 ```

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

@@ -1,32 +1,33 @@
 import { Meta } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/ru/functional-basic/Functions/executePromise - Выполнение Promise или функции'/>
+<Meta title='@dxtmisha/ru/functional-basic/Functions/executePromise - Выполнить Promise или функцию'/>
 
 # `executePromise`
 
-Утилита, которая безопасно выполняет функцию и/или дожидается разрешения асинхронного результата (Promise).
+Надежная утилита для безопасного выполнения и ожидания результатов из различных источников. Она обрабатывает синхронные значения, промисы (Promises) и функции (как синхронные, так и асинхронные), гарантируя, что конечный результат всегда будет разрешен и возвращен в виде промиса.
 
-Внутри используется функция `executeFunction`. Если передан аргумент в виде функции возвращающей промис, `executePromise` выполнит эту функцию и дождётся выполнения `Promise`. Если будет передано синхронное значение или обычная функция, возвращающая синхронное значение, утилита сразу вернёт этот результат.
+Внутренне она использует `executeFunction` для вызова функций, а затем проверяет, является ли результат промисом, чтобы дождаться его завершения.
 
 **Параметры:**
-- `callback: (() => Promise<T>) | (() => T) | T` — Значение, `Promise` или функция, способная вернуть `Promise` или обычное значение.
+- `callback: ((...args: any[]) => Promise<T>) | ((...args: any[]) => T) | T` — Источник для выполнения или разрешения.
+- `...args: any[]` (опционально) — Аргументы, которые будут переданы в функцию, если `callback` является вызываемым.
 
 **Возвращает:**
-`Promise<T>` — Промис, разрешающийся в переданное или вычисленное значение.
+`Promise<T>` — Промис, разрешающийся финальным вычисленным или предоставленным значением.
 
 ```typescript
 import { executePromise } from '@dxtmisha/functional-basic'
 
-// С асинхронной функцией
-const fetchData = async () => {
-  return await fetch('/api/data').then(res => res.json())
+// 1. Ожидание асинхронной функции
+const fetchData = async (id: number) => {
+  return await fetch(`/api/user/${id}`).then(res => res.json())
 }
-const result1 = await executePromise(fetchData)
+const user = await executePromise(fetchData, 123)
 
-// С обычной функцией
-const staticData = () => 'Синхронные данные'
-const result2 = await executePromise(staticData)
+// 2. Обработка синхронной функции
+const getName = () => 'Иван Иванов'
+const name = await executePromise(getName) // возвращает Promise, разрешающийся в 'Иван Иванов'
 
-// Со статическим значением
-const result3 = await executePromise('Данные')
+// 3. Разрешение статического значения
+const result = await executePromise('Мгновенные данные')
 ```

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

@@ -4,29 +4,30 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `executePromise`
 
-Một tiện ích thực thi an toàn một hàm và/hoặc chờ đợi kết quả bất đồng bộ (Promise) được hoàn thành.
+Một tiện ích mạnh mẽ để thực thi và chờ đợi kết quả từ các nguồn linh hoạt một cách an toàn. Nó xử lý các giá trị đồng bộ, Promise và các hàm (cả đồng bộ và bất đồng bộ) bằng cách đảm bảo kết quả cuối cùng luôn được giải quyết và trả về dưới dạng Promise.
 
-Bản chất bên trong, nó sử dụng tiện ích `executeFunction`. Nếu truyền vào một hàm trả về một Promise, `executePromise` sẽ thực thi hàm đó và đợi `Promise` hoàn thành. Nếu truyền vào một giá trị đồng bộ hoặc một hàm thông thường trả về giá trị đồng bộ, tiện ích sẽ trả về ngay kết quả đó.
+Bên dưới, nó tận dụng `executeFunction` để thực thi các hàm và sau đó đảm bảo rằng nếu kết quả là một `Promise`, nó sẽ được chờ đợi (await) đúng cách.
 
 **Tham số:**
-- `callback: (() => Promise<T>) | (() => T) | T` — Một giá trị, một `Promise`, hoặc một hàm có thể trả về một `Promise` hoặc một giá trị thông thường.
+- `callback: ((...args: any[]) => Promise<T>) | ((...args: any[]) => T) | T` — Nguồn để thực thi hoặc giải quyết.
+- `...args: any[]` (tùy chọn) — Các đối số được truyền vào hàm nếu `callback` có thể gọi được.
 
 **Trả về:**
-`Promise<T>` — Một promise sẽ được hoàn thành với giá trị được cung cấp hoặc được tính toán.
+`Promise<T>` — Một promise giải quyết thành giá trị cuối cùng được tính toán hoặc được cung cấp.
 
 ```typescript
 import { executePromise } from '@dxtmisha/functional-basic'
 
-// Với hàm async
-const fetchData = async () => {
-  return await fetch('/api/data').then(res => res.json())
+// 1. Chờ đợi một hàm bất đồng bộ
+const fetchData = async (id: number) => {
+  return await fetch(`/api/user/${id}`).then(res => res.json())
 }
-const result1 = await executePromise(fetchData)
+const user = await executePromise(fetchData, 123)
 
-// Với hàm đồng bộ
-const staticData = () => 'Dữ liệu đồng bộ'
-const result2 = await executePromise(staticData)
+// 2. Xử lý một hàm đồng bộ
+const getName = () => 'John Doe'
+const name = await executePromise(getName) // trả về Promise giải quyết thành 'John Doe'
 
-// Với giá trị tĩnh
-const result3 = await executePromise('Dữ liệu')
+// 3. Giải quyết một giá trị tĩnh
+const result = await executePromise('Dữ liệu tức thời')
 ```

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

@@ -19,7 +19,7 @@ The function performs the specified function once for each element in the object
 The function is a universal tool for iterating over various data structures and collecting results into an array.
 
 **Features:**
-- **Type Support** — works with `Array`, `Map`, and standard `Object`.
+- **Type Support** — works with `Array`, `Map`, `Set`, and standard `Object`.
 - **Result Collection** — unlike the standard `forEach`, this function collects the values returned from the `callback` into a new array.
 - **Undefined Filtering** — by default, all `undefined` values (e.g., if the callback returned nothing for an element) are filtered out of the resulting array.
 - **saveUndefined Parameter** — if `true` is passed as the third argument, the array will preserve all results, including `undefined`.

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

@@ -19,7 +19,7 @@ import { Meta } from '@storybook/addon-docs/blocks'
 Функция является универсальным инструментом для перебора различных структур данных и сбора результатов в массив.
 
 **Особенности:**
-- **Поддержка типов** — работает с `Array`, `Map` и обычными объектами (`Object`).
+- **Поддержка типов** — работает с `Array`, `Map`, `Set` и обычными объектами (`Object`).
 - **Сбор результатов** — в отличие от стандартного `forEach`, эта функция собирает значения, возвращаемые из `callback`, в новый массив.
 - **Фильтрация undefined** — по умолчанию все значения `undefined` (например, если callback ничего не вернул для элемента) отфильтровываются из итогового массива.
 - **Параметр saveUndefined** — если передать `true` третьим аргументом, массив сохранит все результаты, включая `undefined`.

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

@@ -19,7 +19,7 @@ Hàm thực hiện chức năng được chỉ định một lần cho mỗi ph
 Hàm này là một công cụ vạn năng để lặp qua các cấu trúc dữ liệu khác nhau và thu thập kết quả vào một mảng.
 
 **Tính năng:**
-- **Hỗ trợ kiểu dữ liệu** — hoạt động với `Array`, `Map` và các đối tượng thông thường (`Object`).
+- **Hỗ trợ kiểu dữ liệu** — hoạt động với `Array`, `Map`, `Set` và các đối tượng thông thường (`Object`).
 - **Thu thập kết quả** — khác với `forEach` tiêu chuẩn, hàm này thu thập các giá trị được trả về từ `callback` vào một mảng mới.
 - **Lọc undefined** — theo mặc định, tất cả các giá trị `undefined` (ví dụ: nếu callback không trả về gì cho một phần tử) sẽ bị lọc bỏ khỏi mảng kết quả.
 - **Tham số saveUndefined** — nếu truyền `true` làm đối số thứ ba, mảng sẽ giữ lại tất cả các kết quả, bao gồm cả `undefined`.

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

@@ -6,12 +6,15 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 A utility that cyclically calls `requestAnimationFrame` to perform frame-by-frame animation in the browser.
 
-It's useful for creating smooth animations because the browser automatically optimizes the frame rate (typically 60 FPS) and pauses the animation when the tab is inactive. In non-DOM environments (such as SSR), `requestAnimationFrame` is not used, and the function executes the callback synchronously to prevent crashing.
+It's useful for creating smooth animations because the browser automatically optimizes the frame rate (typically 60 FPS) and pauses the animation when the tab is inactive.
+
+**SSR Behavior:**
+In non-DOM environments (such as SSR), `requestAnimationFrame` is not used. The function executes the `callback` once synchronously and immediately calls `end` (the loop via `next` is not started) to prevent stack overflow and thread blocking on the server.
 
 **Parameters:**
-- `callback: () => void` — The function to call when it's time to update your animation for the repaint.
-- `next?: () => boolean` — A condition function. If it returns `true`, the animation loop continues. If `false`, the loop stops.
-- `end?: () => void` — A callback function that is executed once the animation loop ends (when `next` returns `false`).
+- `callback: () => void` — The function to call to update your animation.
+- `next?: () => boolean` — A condition function. If it returns `true` (only in browser), the animation loop continues.
+- `end?: () => void` — A callback function that is executed once the animation loop ends.
 
 **Returns:**
 `void`

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

@@ -6,12 +6,15 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Утилита, которая циклически вызывает `requestAnimationFrame` для выполнения покадровой анимации в браузере.
 
-Она полезна для создания плавных анимаций, поскольку браузер самостоятельно оптимизирует частоту кадров (обычно 60 FPS) и не рисует анимацию, когда вкладка неактивна. В средах без DOM (например, SSR) `requestAnimationFrame` не используется, и функция просто запускает коллбэк синхронно.
+Она полезна для создания плавных анимаций, поскольку браузер самостоятельно оптимизирует частоту кадров (обычно 60 FPS) и не рисует анимацию, когда вкладка неактивна.
+
+**SSR поведение:**
+В средах без DOM (например, SSR) `requestAnimationFrame` не используется. Функция выполняет `callback` один раз синхронно и сразу вызывает `end` (цикл через `next` не запускается), чтобы предотвратить переполнение стека и блокировку потока на сервере.
 
 **Параметры:**
 - `callback: () => void` — Функция, которая отрисовывает или обновляет анимацию на каждом кадре.
-- `next?: () => boolean` — Функция-условие. Если она возвращает `true`, анимация продолжится в следующем кадре. Если `false` — цикл прерывается.
-- `end?: () => void` — Функция, которая будет вызвана один раз, когда `next` вернёт `false` (цикл анимации остановлен).
+- `next?: () => boolean` — Функция-условие. Если она возвращает `true` (только в браузере), анимация продолжится в следующем кадре.
+- `end?: () => void` — Функция, которая будет вызвана один раз, когда цикл анимации завершен.
 
 **Возвращает:**
 `void`

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

@@ -6,12 +6,15 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Tiện ích này sẽ gọi vòng lặp `requestAnimationFrame` để thực hiện hoạt ảnh theo từng khung hình (frame-by-frame) trong trình duyệt.
 
-Trình duyệt tự động tối ưu hóa tốc độ khung hình (thường là 60 FPS) và dừng hoạt ảnh khi tab không hoạt động, giúp hiển thị mượt mà. Trong các môi trường không có DOM (chẳng hạn như SSR), `requestAnimationFrame` sẽ không được sử dụng và hàm chỉ thực thi lệnh callback một lần đồng bộ.
+Trình duyệt tự động tối ưu hóa tốc độ khung hình (thường là 60 FPS) và dừng hoạt ảnh khi tab không hoạt động, giúp hiển thị mượt mà.
+
+**Hành vi trong SSR:**
+Trong các môi trường không có DOM (chẳng hạn như SSR), `requestAnimationFrame` sẽ không được sử dụng. Hàm thực thi `callback` một lần đồng bộ và gọi ngay lập tức hàm `end` (vòng lặp qua `next` không được bắt đầu) để ngăn chặn tràn ngăn xếp (stack overflow) và chặn luồng trên máy chủ (server thread blocking).
 
 **Tham số:**
-- `callback: () => void` — Hàm được gọi khi đến thời điểm cập nhật hoạt ảnh cho lần vẽ lại tiếp theo.
-- `next?: () => boolean` — Hàm điều kiện. Nếu trả về `true`, vòng lặp hoạt ảnh tiếp tục. Nếu trả về `false`, vòng lặp dừng lại.
-- `end?: () => void` — Hàm được thực thi một lần khi vòng lặp hoạt ảnh dừng lại (nghĩa là `next` trả về false).
+- `callback: () => void` — Hàm được gọi để cập nhật hoạt ảnh.
+- `next?: () => boolean` — Hàm điều kiện. Nếu trả về `true` (chỉ trong trình duyệt), vòng lặp hoạt ảnh tiếp tục.
+- `end?: () => void` — Hàm được thực thi một lần khi vòng lặp hoạt ảnh kết thúc.
 
 **Trả về:**
 `void`