@dxtmisha/wiki 0.39.7 → 0.56.0

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

@@ -1,35 +1,47 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/vi/functional-basic/Functions/applyTemplate - Áp dụng mẫu vào văn bản'/>
 
 # `applyTemplate`
 
-Một tiện ích tạo văn bản động dựa trên các mẫu. Điều này hữu ích cho các tác vụ đa ngôn ngữ (i18n), tạo thông báo hệ thống hoặc chèn dữ liệu người dùng vào các hằng số chuỗi.
-
-Hàm này hỗ trợ:
-- Các điểm đánh dấu theo vị trí (`%d`, `%e`, v.v.) để thay thế các giá trị từ một mảng theo thứ tự.
-- Các điểm đánh dấu theo tên (`[key]`, `{key}`) để thay thế các giá trị từ một đối tượng thông qua khóa.
-- Thẻ theo cặp (`[key]nội dung[/key]`, `{key}nội dung{/key}`) để bao bọc nội dung trong các thẻ HTML hoặc cấu trúc khác (từ `[content]` bên trong giá trị truyền vào sẽ được thay thế bởi nội dung của thẻ).
+Tiện ích để thay thế các thẻ đánh dấu trong văn bản bằng các giá trị từ một đối tượng hoặc mảng.
 
 **Tham số:**
-- `text: string` — Văn bản gốc chứa các điểm đánh dấu mẫu.
-- `replacement: Record<string, string | number> | string[]` — Một đối tượng hoặc mảng chứa các giá trị để thay thế. Mặc định là `{}`.
+- `text: string` — Văn bản gốc có mẫu.
+- `replacement: Record<string, string | number | boolean> | string[]` — Đối tượng hoặc mảng có các giá trị.
+
+**Định dạng thay thế (replacement)**
+- **Mảng**: Được sử dụng cho các thẻ vị trí như `%d`, `%e`, `%f`, v.v. (theo thứ tự bảng chữ cái).
+- **Đối tượng**: Được sử dụng cho các thẻ có tên trong ngoặc `[key]` hoặc `{key}`, cũng như các thẻ cặp `[tag]nội dung[/tag]`.
 
 **Trả về:**
 `string` — Văn bản với các giá trị đã được thay thế.
 
-```typescript
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
 import { applyTemplate } from '@dxtmisha/functional-basic'
 
-// Đánh dấu theo vị trí
-console.log(applyTemplate('Xin chào, %d %e!', ['John', 'Doe'])) // 'Xin chào, John Doe!'
+// 1. Điểm đánh dấu vị trí (mảng)
+applyTemplate('Xin chào, %d %e!', ['John', 'Doe']) // 'Xin chào, John Doe!'
+
+// 2. Điểm đánh dấu có tên (đối tượng)
+applyTemplate('Giá: [price] {currency}', { price: 100, currency: 'USD' }) // 'Giá: 100 USD'
+
+// 3. Xử lý 0 và false
+applyTemplate('Giá trị: [val]', { val: 0 })      // // 'Giá trị: 0'
+applyTemplate('Trạng thái: [val]', { val: false }) // 'Trạng thái: false'
+
+// 4. Bỏ qua các khóa bị thiếu
+applyTemplate('Thiếu: [none]', {})              // 'Thiếu: [none]'
 
-// Đánh dấu theo tên
-console.log(applyTemplate('Xin chào, [name]!', { name: 'John' })) // 'Xin chào, John!'
-console.log(applyTemplate('Xin chào, {name}!', { name: 'John' })) // 'Xin chào, John!'
+// 5. Các thẻ cặp với thay thế nội dung
+const tags = { link: '<a href="https://google.com">[content]</a>' }
+applyTemplate('Nhấp vào [link]đây[/link]', tags) // 'Nhấp vào <a href="https://google.com">đây</a>'
 
-// Thẻ bao bọc với nội dung bị thay thế
-console.log(applyTemplate('Nhấp vào [link]đây[/link]', { link: '<a href="#">[content]</a>' }))
-console.log(applyTemplate('Nhấp vào {link}đây{/link}', { link: '<a href="#">{content}</a>' }))
-// 'Nhấp vào <a href="#">đây</a>'
-```
+// 6. Macro danh sách (vượt quá giới hạn)
+applyTemplate('Macros: %d, %e, %f', ['A', 'B'])  // 'Macros: A, B, '
+  `}
+/>

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

@@ -1,28 +1,42 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/en/functional-basic/Functions/blobToBase64 - Convert Blob to Base64'/>
+<Meta title='@dxtmisha/en/functional-basic/Functions/blobToBase64 - Converting Blob to Base64'/>
 
 # `blobToBase64`
 
 Asynchronously converts `Blob` or `File` objects into a Base64 string (Data URL).
 
-This is useful when preparing local files (e.g., user-uploaded images) for in-browser previews or for sending to the server in string format.
-
 **Parameters:**
-- `blob: Blob` — The `Blob` (or `File`) object to convert.
+- `blob: Blob` — The `Blob` (or `File`) object to be converted.
+- `clean: boolean = false` — If `true`, removes the Data URL prefix (e.g., `data:image/png;base64,`).
+
+**Environment Support:**
+The utility automatically detects the environment:
+- **Browser**: Uses `FileReader` to read the content.
+- **Server (SSR)**: Uses `Buffer` and the asynchronous `blob.arrayBuffer()` method.
 
 **Returns:**
-`Promise<string | ArrayBuffer | null>` — Returns a promise that resolves with the Base64 string (Data URL) or rejects with an error if reading fails.
+`Promise<string | undefined>` — Base64 string or `undefined` if conversion is not possible.
+
+## Examples
 
-```typescript
+<Source
+  language='typescript'
+  code={`
 import { blobToBase64 } from '@dxtmisha/functional-basic'
 
-async function uploadFile(file: File) {
-  try {
-    const base64String = await blobToBase64(file)
-    console.log(base64String) // 'data:image/png;base64,iVBORw0KGgo...'
-  } catch (error) {
-    console.error('Error reading the file', error)
-  }
+// 1. Default (returns Data URL)
+const dataUrl = await blobToBase64(file)
+// 'data:image/png;base64,iVBORw0KGgo...'
+
+// 2. Raw Base64 (without prefix)
+const rawBase64 = await blobToBase64(file, true)
+// 'iVBORw0KGgo...'
+
+// 3. Handling API unavailability
+const result = await blobToBase64(blob)
+if (result) {
+  // work with string
 }
-```
+  `}
+/>

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

@@ -1,4 +1,4 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/functional-basic/Functions/blobToBase64 - Преобразование Blob в Base64'/>
 
@@ -6,23 +6,37 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Асинхронно преобразует объекты `Blob` или `File` в строку формата Base64 (Data URL).
 
-Это полезно при подготовке локальных файлов (например, загруженных пользователем изображений) для их предпросмотра в браузере или отправки на сервер в строковом формате.
-
 **Параметры:**
-- `blob: Blob` — Объект `Blob` (или `File`), который необходимо преобразовать.
+- `blob: Blob` — Объект `Blob` (или `File`) для преобразования.
+- `clean: boolean = false` — Если `true`, удаляет префикс Data URL (например, `data:image/png;base64,`).
+
+**Среда выполнения:**
+Утилита автоматически определяет доступный метод конвертации:
+- **Браузер**: Использует `FileReader` для чтения содержимого.
+- **Сервер (SSR)**: Использует `Buffer` и асинхронный метод `blob.arrayBuffer()`.
 
 **Возвращает:**
-`Promise<string | ArrayBuffer | null>` — Возвращает промис, который разрешается в строку Base64 (Data URL) или отклоняется в случае ошибки чтения.
+`Promise<string | undefined>` — Строка Base64 или `undefined`, если конвертация невозможна.
+
+## Примеры
 
-```typescript
+<Source
+  language='typescript'
+  code={`
 import { blobToBase64 } from '@dxtmisha/functional-basic'
 
-async function uploadFile(file: File) {
-  try {
-    const base64String = await blobToBase64(file)
-    console.log(base64String) // 'data:image/png;base64,iVBORw0KGgo...'
-  } catch (error) {
-    console.error('Ошибка при чтении файла', error)
-  }
+// 1. По умолчанию (возвращает Data URL)
+const dataUrl = await blobToBase64(file)
+// 'data:image/png;base64,iVBORw0KGgo...'
+
+// 2. Чистый Base64 (без префикса)
+const rawBase64 = await blobToBase64(file, true)
+// 'iVBORw0KGgo...'
+
+// 3. Обработка случая недоступности API
+const result = await blobToBase64(blob)
+if (result) {
+  // работа со строкой
 }
-```
+  `}
+/>

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

@@ -1,28 +1,42 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/vi/functional-basic/Functions/blobToBase64 - Chuyển đổi Blob thành Base64'/>
 
 # `blobToBase64`
 
-Hàm chuyển đổi bất đồng bộ các đối tượng `Blob` hoặc `File` thành chuỗi kiểu Base64 (Data URL).
-
-Điều này hữu ích khi chuẩn bị các tệp cục bộ (ví dụ: hình ảnh do người dùng tải lên) để xem trước trực tiếp trên trình duyệt hoặc gửi dạng chuỗi văn bản lên máy chủ.
+Chuyển đổi bất đồng bộ các đối tượng `Blob` hoặc `File` thành chuỗi định dạng Base64 (Data URL).
 
 **Tham số:**
 - `blob: Blob` — Đối tượng `Blob` (hoặc `File`) cần chuyển đổi.
+- `clean: boolean = false` — Nếu `true`, loại bỏ tiền tố Data URL (ví dụ: `data:image/png;base64,`).
+
+**Môi trường thực thi:**
+Tiện ích tự động xác định phương pháp chuyển đổi khả dụng:
+- **Trình duyệt**: Sử dụng `FileReader` để đọc nội dung.
+- **Máy chủ (SSR)**: Sử dụng `Buffer` và phương thức bất đồng bộ `blob.arrayBuffer()`.
 
 **Trả về:**
-`Promise<string | ArrayBuffer | null>` — Trả về một promise sẽ được hoàn thành với chuỗi Base64 (Data URL) hoặc bị từ chối với một lỗi nếu việc đọc tệp thất bại.
+`Promise<string | undefined>` — Chuỗi Base64 hoặc `undefined` nếu không thể chuyển đổi.
+
+## Ví dụ
 
-```typescript
+<Source
+  language='typescript'
+  code={`
 import { blobToBase64 } from '@dxtmisha/functional-basic'
 
-async function uploadFile(file: File) {
-  try {
-    const base64String = await blobToBase64(file)
-    console.log(base64String) // 'data:image/png;base64,iVBORw0KGgo...'
-  } catch (error) {
-    console.error('Lỗi khi đọc tệp', error)
-  }
+// 1. Mặc định (trả về Data URL)
+const dataUrl = await blobToBase64(file)
+// 'data:image/png;base64,iVBORw0KGgo...'
+
+// 2. Base64 thô (không có tiền tố)
+const rawBase64 = await blobToBase64(file, true)
+// 'iVBORw0KGgo...'
+
+// 3. Xử lý trường hợp API không khả dụng
+const result = await blobToBase64(blob)
+if (result) {
+  // làm việc với chuỗi
 }
-```
+  `}
+/>

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

@@ -4,18 +4,22 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `capitalize`
 
-Capitalizes the first letter of a string. Returns the same string if the first character is not a letter or if the string is empty.
+Capitalizes the first letter of a string. Returns the same string if it is empty. The function is robust and safe for non-string inputs.
 
 **Parameters:**
 - `value: string` — The original string to capitalize.
+- `isLocale: boolean` (optional) — If `true`, uses the current global locale (via `Geo.getLocation()`) for capitalization rules.
 
 **Returns:**
 `string` — The string with the first letter capitalized.
 
 ```typescript
-import { capitalize } from '@dxtmisha/functional-basic'
+import { capitalize, Geo } from '@dxtmisha/functional-basic'
 
 console.log(capitalize('hello')) // 'Hello'
-console.log(capitalize('Hello')) // 'Hello'
 console.log(capitalize('123'))   // '123'
+
+// Locale-aware capitalization (e.g., for Turkish 'i' -> 'İ')
+Geo.set('tr-TR')
+console.log(capitalize('i', true)) // 'İ'
 ```

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

@@ -4,18 +4,22 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `capitalize`
 
-Делает первую букву строки заглавной. Возвращает ту же строку, если первый символ не является буквой или если строка пуста.
+Делает первую букву строки заглавной. Возвращает ту же строку, если она пуста. Функция устойчива к некорректным входным данным и безопасно обрабатывает не-строковые значения.
 
 **Параметры:**
 - `value: string` — Исходная строка для капитализации.
+- `isLocale: boolean` (опционально) — Если `true`, использует текущую глобальную локаль (через `Geo.getLocation()`) для правил капитализации.
 
 **Возвращает:**
 `string` — Строка с заглавной первой буквой.
 
 ```typescript
-import { capitalize } from '@dxtmisha/functional-basic'
+import { capitalize, Geo } from '@dxtmisha/functional-basic'
 
 console.log(capitalize('hello')) // 'Hello'
-console.log(capitalize('Hello')) // 'Hello'
 console.log(capitalize('123'))   // '123'
+
+// Капитализация с учетом локали (например, для турецкого 'i' -> 'İ')
+Geo.set('tr-TR')
+console.log(capitalize('i', true)) // 'İ'
 ```

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

@@ -4,18 +4,22 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `capitalize`
 
-Viết hoa chữ cái đầu tiên của một chuỗi. Trả về cùng một chuỗi nếu ký tự đầu tiên không phải là chữ cái hoặc nếu chuỗi trống.
+Viết hoa chữ cái đầu tiên của một chuỗi. Trả về cùng một chuỗi nếu nó trống. Hàm này mạnh mẽ và an toàn cho các đầu vào không phải chuỗi.
 
 **Tham số:**
 - `value: string` — Chuỗi gốc cần viết hoa.
+- `isLocale: boolean` (tùy chọn) — Nếu là `true`, sử dụng địa phương (locale) toàn cục hiện tại (thông qua `Geo.getLocation()`) cho các quy tắc viết hoa.
 
 **Trả về:**
 `string` — Chuỗi với chữ cái đầu tiên được viết hoa.
 
 ```typescript
-import { capitalize } from '@dxtmisha/functional-basic'
+import { capitalize, Geo } from '@dxtmisha/functional-basic'
 
 console.log(capitalize('hello')) // 'Hello'
-console.log(capitalize('Hello')) // 'Hello'
 console.log(capitalize('123'))   // '123'
+
+// Viết hoa theo ngữ cảnh địa phương (ví dụ: đối với tiếng Thổ Nhĩ Kỳ 'i' -> 'İ')
+Geo.set('tr-TR')
+console.log(capitalize('i', true)) // 'İ'
 ```

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'
 ```