@dxtmisha/wiki 0.39.7 → 0.39.8

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

@@ -1,33 +1,51 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/functional-basic/Functions/anyToString - Преобразование значения в строку'/>
 
 # `anyToString`
 
-Утилита, которая безопасно приводит любые входящие данные к строковому типу.
-
-Это полезно при выводе данных в интерфейс, когда заранее неизвестен тип переменной (объект, массив, boolean или null).
+Утилита для безопасного приведения любых данных к строковому типу.
 
 **Параметры:**
-- `value: V` — Значения для преобразования.
-- `isArrayString: boolean` (необязательно, по умолчанию: `true`) — Если `true`, массивы примитивов будут объединены через запятую. Если `false`, они будут преобразованы в строку JSON.
+- `value: V` — Значение для преобразования.
+- `isArrayString: boolean = true` — Если `true`, массивы примитивов объединяются через запятую.
+- `trim: boolean = true` — Если `true`, обрезает лишние пробелы (только для строк).
+
+**Правила преобразования:**
+- **Строки**: Возвращаются как есть (с `trim`, если включено).
+- **Массивы**: Если `isArrayString: true` и в массиве нет объектов, элементы объединяются через запятую. В остальных случаях — JSON.
+- **Объекты**: Преобразуются в JSON. При ошибке (например, циклической ссылке) возвращается стандартный `toString()`.
+- **Boolean**: `true` преобразуется в `'1'`, `false` — в `'0'`.
+- **Прочие типы**: `null` и `undefined` дают пустую строку. Для остальных вызывается `toString()`.
 
 **Возвращает:**
-`string` — Строковое представление переданного значения.
+`string` — Строковое представление значения.
+
+## Примеры
 
-```typescript
+<Source
+  language='typescript'
+  code={`
 import { anyToString } from '@dxtmisha/functional-basic'
 
-console.log(anyToString(' test ')) // 'test' (trimmed)
-console.log(anyToString([1, 2, 3])) // '1,2,3' (isArrayString = true)
-console.log(anyToString([1, 2, 3], false)) // '[1,2,3]' (isArrayString = false)
+// 1. Строки
+anyToString('  Hello  ')               // 'Hello'
+anyToString('  Hello  ', true, false)  // '  Hello  '
+
+// 2. Массивы
+anyToString([1, 2, 3])                 // '1,2,3'
+anyToString([1, 2, 3], false)          // '[1,2,3]'
+
+// 3. Объекты
+anyToString({ a: 1 })                  // '{"a":1}'
 
-console.log(anyToString([[1], [2]])) // '[[1],[2]]' (вложенные массивы превращаются в JSON)
-console.log(anyToString([{ a: 1 }, 2])) // '[{"a":1},2]' (массивы с объектами превращаются в JSON)
+// 4. Логические значения (преобразование в 1/0)
+anyToString(true)                      // '1'
+anyToString(false)                     // '0'
 
-console.log(anyToString({ a: 1 })) // '{"a":1}'
-console.log(anyToString(true)) // '1'
-console.log(anyToString(false)) // '0'
-console.log(anyToString(123)) // '123'
-console.log(anyToString(null)) // ''
-```
+// 5. Пустые значения и типы
+anyToString(null)                      // ''
+anyToString(123)                       // '123'
+anyToString(Symbol('test'))            // 'Symbol(test)'
+  `}
+/>

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

@@ -1,33 +1,51 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/vi/functional-basic/Functions/anyToString - Chuyển đổi một giá trị thành chuỗi'/>
 
 # `anyToString`
 
-Một tiện ích chuyển đổi an toàn bất kỳ dữ liệu đầu vào nào thành kiểu chuỗi.
-
-Điều này rất hữu ích khi xuất dữ liệu ra giao diện mà không biết trước kiểu của biến (đối tượng, mảng, boolean hoặc null).
+Tiện ích để chuyển đổi an toàn bất kỳ dữ liệu đầu vào nào thành kiểu chuỗi.
 
 **Tham số:**
 - `value: V` — Giá trị cần chuyển đổi.
-- `isArrayString: boolean` (tùy chọn, mặc định: `true`) — Nếu `true`, các mảng nguyên thủy sẽ được nối với nhau bằng dấu phẩy. Nếu `false`, chúng sẽ được chuyển đổi thành chuỗi JSON.
+- `isArrayString: boolean = true` — Nếu `true`, các mảng nguyên thủy sẽ được nối với nhau bằng dấu phẩy.
+- `trim: boolean = true` — Nếu `true`, loại bỏ khoảng trắng dư thừa (chỉ dành cho chuỗi).
+
+**Quy tắc chuyển đổi:**
+- **Chuỗi**: Trả về nguyên bản (có `trim` nếu được bật).
+- **Mảng**: Nếu `isArrayString: true` và không có đối tượng trong mảng, các phần tử sẽ được nối bằng dấu phẩy. Ngược lại — chuyển thành chuỗi JSON.
+- **Đối tượng**: Chuyển đổi thành JSON. Trong trường hợp lỗi (ví dụ: tham chiếu vòng), trả về `toString()` tiêu chuẩn.
+- **Boolean**: `true` chuyển thành `'1'`, `false` thành `'0'`.
+- **Các kiểu khác**: `null` và `undefined` trả về chuỗi rỗng. Các kiểu khác gọi `toString()`.
 
 **Trả về:**
 `string` — Biểu diễn chuỗi của giá trị.
 
-```typescript
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
 import { anyToString } from '@dxtmisha/functional-basic'
 
-console.log(anyToString(' test ')) // 'test' (đã trimmed)
-console.log(anyToString([1, 2, 3])) // '1,2,3' (isArrayString = true)
-console.log(anyToString([1, 2, 3], false)) // '[1,2,3]' (isArrayString = false)
+// 1. Chuỗi (Strings)
+anyToString('  Hello  ')               // 'Hello'
+anyToString('  Hello  ', true, false)  // '  Hello  '
+
+// 2. Mảng (Arrays)
+anyToString([1, 2, 3])                 // '1,2,3'
+anyToString([1, 2, 3], false)          // '[1,2,3]'
+
+// 3. Đối tượng (Objects)
+anyToString({ a: 1 })                  // '{"a":1}'
 
-console.log(anyToString([[1], [2]])) // '[[1],[2]]' (các mảng lồng nhau sẽ được chuyển thành JSON)
-console.log(anyToString([{ a: 1 }, 2])) // '[{"a":1},2]' (các mảng chứa đối tượng sẽ được chuyển thành JSON)
+// 4. Giá trị Boolean (chuyển đổi thành 1/0)
+anyToString(true)                      // '1'
+anyToString(false)                     // '0'
 
-console.log(anyToString({ a: 1 })) // '{"a":1}'
-console.log(anyToString(true)) // '1'
-console.log(anyToString(false)) // '0'
-console.log(anyToString(123)) // '123'
-console.log(anyToString(null)) // ''
-```
+// 5. Giá trị rỗng và các kiểu khác
+anyToString(null)                      // ''
+anyToString(123)                       // '123'
+anyToString(Symbol('test'))            // 'Symbol(test)'
+  `}
+/>

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

@@ -1,35 +1,47 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/en/functional-basic/Functions/applyTemplate - Applying a template to text'/>
 
 # `applyTemplate`
 
-A utility for dynamic text generation based on templates. This is useful for localization (i18n) tasks, generating system messages, or inserting user data into string constants.
-
-It supports:
-- Positional markers (`%d`, `%e`, etc.) to substitute values from an array in order.
-- Named markers (`[key]`, `{key}`) to substitute values from an object by keys.
-- Paired tags (`[key]content[/key]`, `{key}content{/key}`) to wrap content in HTML tags or other constructs (the word `[content]` inside the passed value is replaced by the tag's generic content).
+A utility for replacing markers in text with values from an object or an array.
 
 **Parameters:**
 - `text: string` — The original text containing template markers.
-- `replacement: Record<string, string | number> | string[]` — An object or array containing values for substitution. Defaults to `{}`.
+- `replacement: Record<string, string | number | boolean> | string[]` — An object or array containing values.
+
+**Replacement formats (replacement)**
+- **Array**: Used for positional markers like `%d`, `%e`, `%f`, and so on (alphabetically).
+- **Object**: Used for named markers in brackets `[key]` or `{key}`, as well as paired tags `[tag]text[/tag]`.
 
 **Returns:**
 `string` — The text with substituted values.
 
-```typescript
+## Examples
+
+<Source
+  language='typescript'
+  code={`
 import { applyTemplate } from '@dxtmisha/functional-basic'
 
-// Positional markers
-console.log(applyTemplate('Hello, %d %e!', ['John', 'Doe'])) // 'Hello, John Doe!'
+// 1. Positional markers (array)
+applyTemplate('Hello, %d %e!', ['John', 'Doe']) // 'Hello, John Doe!'
+
+// 2. Named markers (object)
+applyTemplate('Price: [price] {currency}', { price: 100, currency: 'USD' }) // 'Price: 100 USD'
+
+// 3. Handling 0 and false
+applyTemplate('Value: [val]', { val: 0 })      // 'Value: 0'
+applyTemplate('Status: [val]', { val: false })    // 'Status: false'
+
+// 4. Skipping missing keys
+applyTemplate('Missing: [none]', {})           // 'Missing: [none]'
 
-// Named markers
-console.log(applyTemplate('Hello, [name]!', { name: 'John' })) // 'Hello, John!'
-console.log(applyTemplate('Hello, {name}!', { name: 'John' })) // 'Hello, John!'
+// 5. Paired tags with content substitution
+const tags = { link: '<a href="https://google.com">[content]</a>' }
+applyTemplate('Click [link]here[/link]', tags)  // 'Click <a href="https://google.com">here</a>'
 
-// Wrapped tags with content substitution
-console.log(applyTemplate('Click [link]here[/link]', { link: '<a href="#">[content]</a>' }))
-console.log(applyTemplate('Click {link}here{/link}', { link: '<a href="#">{content}</a>' }))
-// 'Click <a href="#">here</a>'
-```
+// 6. List macros (handling out-of-bounds)
+applyTemplate('Macros: %d, %e, %f', ['A', 'B'])  // 'Macros: A, B, '
+  `}
+/>

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

@@ -1,35 +1,47 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/functional-basic/Functions/applyTemplate - Применение шаблона к тексту'/>
 
 # `applyTemplate`
 
-Утилита для динамического формирования текста на основе шаблонов. Это полезно для задач локализации (i18n), генерации системных сообщений или подстановки пользовательских данных в строковые константы.
-
-Она поддерживает:
-- Позиционные маркеры (`%d`, `%e` и т.д.) для подстановки значений из массива по порядку.
-- Именованные маркеры (`[key]`, `{key}`) для подстановки значений из объекта по ключам.
-- Парные теги (`[key]контент[/key]`, `{key}контент{/key}`) для оборачивания контента в HTML-теги или другие конструкции (слово `[content]` внутри переданного значения заменяется на содержимое тега).
+Утилита для замены меток в тексте на значения из объекта или массива.
 
 **Параметры:**
 - `text: string` — Исходный текст с шаблоном.
-- `replacement: Record<string, string | number> | string[]` — Объект или массив со значениями для подстановки. По умолчанию `{}`.
+- `replacement: Record<string, string | number | boolean> | string[]` — Объект или массив со значениями.
+
+**Форматы замены (replacement)**
+- **Массив**: Используется для позиционных меток `%d`, `%e`, `%f` и далее по алфавиту.
+- **Объект**: Используется для именованных меток в скобках `[key]` или `{key}`, а также для парных тегов `[tag]текст[/tag]`.
 
 **Возвращает:**
 `string` — Текст с подставленными значениями.
 
-```typescript
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
 import { applyTemplate } from '@dxtmisha/functional-basic'
 
-// Позиционные маркеры
-console.log(applyTemplate('Привет, %d %e!', ['Иван', 'Иванов'])) // 'Привет, Иван Иванов!'
+// 1. Позиционные маркеры (массив)
+applyTemplate('Привет, %d %e!', ['Иван', 'Иванов']) // 'Привет, Иван Иванов!'
+
+// 2. Именованные маркеры (объект)
+applyTemplate('Цена: [price] {currency}', { price: 100, currency: 'USD' }) // 'Цена: 100 USD'
+
+// 3. Обработка 0 и false
+applyTemplate('Значение: [val]', { val: 0 })      // 'Значение: 0'
+applyTemplate('Статус: [val]', { val: false })    // 'Статус: false'
+
+// 4. Пропуск отсутствующих ключей
+applyTemplate('Отсутствует: [none]', {})           // 'Отсутствует: [none]'
 
-// Именованные маркеры
-console.log(applyTemplate('Привет, [name]!', { name: 'Иван' })) // 'Привет, Иван!'
-console.log(applyTemplate('Привет, {name}!', { name: 'Иван' })) // 'Привет, Иван!'
+// 5. Парные теги с подстановкой контента
+const tags = { link: '<a href="https://google.com">[content]</a>' }
+applyTemplate('Нажми [link]здесь[/link]', tags)  // 'Нажми <a href="https://google.com">здесь</a>'
 
-// Обёртка с парными тегами и контентом
-console.log(applyTemplate('Нажми [link]здесь[/link]', { link: '<a href="#">[content]</a>' }))
-console.log(applyTemplate('Нажми {link}здесь{/link}', { link: '<a href="#">{content}</a>' }))
-// 'Нажми <a href="#">здесь</a>'
-```
+// 6. Макросы списка (выход за границы)
+applyTemplate('Список: %d, %e, %f', ['A', 'B'])  // 'Список: A, B, '
+  `}
+/>

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)) // 'İ'
 ```