@dxtmisha/wiki 0.39.7 → 0.56.0

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

@@ -18,15 +18,29 @@ Ngoài ra, hàm cho phép đính kèm một bộ chọn CSS vào chuỗi trả v
 ```typescript
 import { getElementId } from '@dxtmisha/functional-basic'
 
-// Phần tử ban đầu không có ID
+// Phần tử 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)
+console.log(id) // Ví dụ: 'id-100000'
+console.log(div.id) // 'id-100000' (được gán tự động)
 
 // Sử dụng bộ chọn bổ sung
 const selector = getElementId(div, ' > span.active')
-console.log(selector) // '#id-123456 > span.active'
+console.log(selector) // '#id-100000 > span.active'
+```
+
+## `initGetElementId`
+
+Khởi tạo hàm để sử dụng trong môi trường SSR. Điều này là cần thiết để đảm bảo tính đồng bộ của các ID được tạo ra giữa máy chủ và máy khách.
+
+Khi sử dụng **Vue 3.5+**, khuyến nghị sử dụng hàm `useId()` có sẵn.
+
+```typescript
+import { useId } from 'vue'
+import { initGetElementId } from '@dxtmisha/functional-basic'
+
+// Khởi tạo (ví dụ: trong một plugin hoặc thành phần gốc)
+initGetElementId(() => useId())
 ```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getElementSafeScript - Generation of a safe script for hydration'/>
+
+# `getElementSafeScript`
+
+A utility for generating a safe `<script type="application/json">` tag, which is used for transferring data from the server to the client (hydration).
+
+This function automatically serializes data into JSON and escapes closing `</script>` tags, preventing XSS attacks and HTML parsing errors when embedding data.
+
+**Parameters:**
+- `id: string` — The unique identifier (ID) for the script tag.
+- `data: any` — The data that needs to be serialized and stored in the tag.
+
+**Returns:**
+`string` — A string containing the ready HTML script tag.
+
+```typescript
+import { getElementSafeScript } from '@dxtmisha/functional-basic'
+
+const data = { 
+  user: 'Misha', 
+  content: '</script><script>alert(1)</script>' 
+}
+
+console.log(getElementSafeScript('hydration-data', data))
+// Result:
+// <script id="hydration-data" type="application/json">
+//   {"user":"Misha","content":"<\\/script><script>alert(1)<\\/script>"}
+// </script>
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getElementSafeScript - Генерация безопасного скрипта для гидратации'/>
+
+# `getElementSafeScript`
+
+Утилита для генерации безопасного тега `<script type="application/json">`, который используется для передачи данных с сервера на клиент (гидратации).
+
+Эта функция автоматически сериализует данные в JSON и экранирует закрывающие теги `</script>`, предотвращая XSS-атаки и ошибки парсинга HTML при встраивании данных.
+
+**Параметры:**
+- `id: string` — Уникальный идентификатор (ID) тега скрипта.
+- `data: any` — Данные, которые необходимо сериализовать и сохранить в теге.
+
+**Возвращает:**
+`string` — Готовая строка с HTML-тегом скрипта.
+
+```typescript
+import { getElementSafeScript } from '@dxtmisha/functional-basic'
+
+const data = { 
+  user: 'Misha', 
+  content: '</script><script>alert(1)</script>' 
+}
+
+console.log(getElementSafeScript('hydration-data', data))
+// Результат:
+// <script id="hydration-data" type="application/json">
+//   {"user":"Misha","content":"<\\/script><script>alert(1)<\\/script>"}
+// </script>
+```

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

@@ -0,0 +1,31 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getElementSafeScript - Tạo một script an toàn cho hydration'/>
+
+# `getElementSafeScript`
+
+Một tiện ích để tạo thẻ `<script type="application/json">` an toàn, được sử dụng để chuyển dữ liệu từ máy chủ sang máy khách (hydration).
+
+Hàm này tự động tuần tự hóa dữ liệu thành JSON và thoát các thẻ đóng `</script>`, ngăn chặn các cuộc tấn công XSS và lỗi phân tích cú pháp HTML khi nhúng dữ liệu.
+
+**Tham số:**
+- `id: string` — Mã định danh duy nhất (ID) cho thẻ script.
+- `data: any` — Dữ liệu cần được tuần tự hóa và lưu trữ trong thẻ.
+
+**Trả về:**
+`string` — Một chuỗi chứa thẻ script HTML đã sẵn sàng.
+
+```typescript
+import { getElementSafeScript } from '@dxtmisha/functional-basic'
+
+const data = { 
+  user: 'Misha', 
+  content: '</script><script>alert(1)</script>' 
+}
+
+console.log(getElementSafeScript('hydration-data', data))
+// Kết quả:
+// <script id="hydration-data" type="application/json">
+//   {"user":"Misha","content":"<\\/script><script>alert(1)<\\/script>"}
+// </script>
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/getOnlyText - Extraction of letters, numbers and spaces from a string'/>
+
+# `getOnlyText`
+
+A utility that extracts only letters, numbers, and spaces from any given input, removing punctuation, special characters, and other symbols.
+
+This is useful for cleaning up user input or preparing text for simplified processing where only alphanumeric content and basic spacing are required.
+
+**Parameters:**
+- `text: any` — The value to process.
+
+**Returns:**
+`string` — A string containing only the characters that are letters, numbers, or spaces.
+
+```typescript
+import { getOnlyText } from '@dxtmisha/functional-basic'
+
+console.log(getOnlyText('Hello, World!')) // 'Hello World'
+console.log(getOnlyText('Price: $100.00')) // 'Price 10000'
+console.log(getOnlyText('Text with symbols: #@!%')) // 'Text with symbols'
+console.log(getOnlyText(12345)) // '12345'
+console.log(getOnlyText(null)) // ''
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/getOnlyText - Извлечение букв, цифр и пробелов из строки'/>
+
+# `getOnlyText`
+
+Утилита, которая возвращает из строки только буквы, цифры и пробелы, удаляя знаки препинания, специальные символы и прочие знаки.
+
+Это полезно для очистки пользовательского ввода или подготовки текста к упрощенной обработке, когда требуется только алфавитно-цифровое содержимое.
+
+**Параметры:**
+- `text: any` — Текст для обработки.
+
+**Возвращает:**
+`string` — Строка, содержащая только буквы, цифры или пробелы.
+
+```typescript
+import { getOnlyText } from '@dxtmisha/functional-basic'
+
+console.log(getOnlyText('Hello, World!')) // 'Hello World'
+console.log(getOnlyText('Цена: 100 руб.')) // 'Цена 100 руб'
+console.log(getOnlyText('Текст с символами: #@!%')) // 'Текст с символами'
+console.log(getOnlyText(12345)) // '12345'
+console.log(getOnlyText(null)) // ''
+```

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

@@ -0,0 +1,25 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/getOnlyText - Trích xuất các chữ cái, số và dấu cách từ một chuỗi'/>
+
+# `getOnlyText`
+
+Một tiện ích giúp trích xuất chỉ các chữ cái, con số và dấu cách từ bất kỳ dữ liệu đầu vào nào, loại bỏ các dấu câu, ký tự đặc biệt và các ký hiệu khác.
+
+Điều này rất hữu ích để làm sạch dữ liệu nhập từ người dùng hoặc chuẩn bị văn bản để xử lý đơn giản hơn khi chỉ cần nội dung chữ và số.
+
+**Tham số:**
+- `text: any` — Giá trị cần xử lý.
+
+**Trả về:**
+`string` — Một chuỗi chỉ chứa các ký tự là chữ cái, số hoặc dấu cách.
+
+```typescript
+import { getOnlyText } from '@dxtmisha/functional-basic'
+
+console.log(getOnlyText('Hello, World!')) // 'Hello World'
+console.log(getOnlyText('Giá: 100.000đ')) // 'Giá 100000'
+console.log(getOnlyText('Văn bản với ký tự: #@!%')) // 'Văn bản với ký tự'
+console.log(getOnlyText(12345)) // '12345'
+console.log(getOnlyText(null)) // ''
+```

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

@@ -4,27 +4,34 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `getSearchExp`
 
-A utility that builds a case-insensitive global `RegExp` matching strings that contain **all** words from the search string (in any order).
+A utility that builds a case-insensitive `RegExp` matching strings that contain **all** words from the search string (in any order).
 
-Each word is split by spaces, escaped, and wrapped in a lookahead `(?=.*?word)`. This makes it ideal for live search or multi-word filtering UIs.
+Each word is split by spaces, escaped, and wrapped in a positive lookahead `(?=.*?word)`. This makes it ideal for live search or multi-word filtering UIs.
 
 **Parameters:**
 - `search: string` — A search string consisting of one or more space-separated words.
+- `limit: number` (optional, default: `128`) — The maximum allowed length of the search string.
 
 **Returns:**
-`RegExp` — A regular expression with flags `ig` (global, case-insensitive).
+`RegExp` — A regular expression with the `i` flag (case-insensitive).
+- If the `search` string is empty, not a string, or exceeds the `limit`, it returns `/^/` (matching the start of any string).
 
 ```typescript
 import { getSearchExp } from '@dxtmisha/functional-basic'
 
+// Basic usage
 const regex = getSearchExp('foo bar')
 
 regex.test('foo bar baz')  // true  — contains both words
 regex.test('bar foo')      // true  — order doesn't matter
-regex.test('foo only')     // false — word bar is missing
+regex.test('foo only')     // false — word "bar" is missing
 
 // Special characters are escaped automatically
 const regex2 = getSearchExp('price $10.00')
 regex2.test('price $10.00') // true
 regex2.test('price X10Y00') // false
+
+// Using a custom limit
+const regex3 = getSearchExp('very long search string', 10)
+regex3.test('any string')   // true — returns /^/ because search length > 10
 ```

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

@@ -4,27 +4,34 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 # `getSearchExp`
 
-Утилита, строящая регистронезависимое глобальное регулярное выражение `RegExp` для поиска строк, содержащих **все** слова из поисковой строки (в любом порядке).
+Утилита, строящая регистронезависимое регулярное выражение `RegExp` для поиска строк, содержащих **все** слова из поисковой строки (в любом порядке).
 
-Каждое слово разбивается пробелами, экранируется и оборачивается в lookahead `(?=.*?слово)`. Это удобно для реализации живого поиска/фильтрации по нескольким словам одновременно.
+Каждое слово разбивается пробелами, экранируется и оборачивается в positive lookahead `(?=.*?слово)`. Это удобно для реализации живого поиска или фильтрации по нескольким словам одновременно.
 
 **Параметры:**
 - `search: string` — Строка поиска, состоящая из одного или нескольких слов, разделённых пробелами.
+- `limit: number` (необязательно, по умолчанию: `128`) — Максимально допустимая длина строки поиска.
 
 **Возвращает:**
-`RegExp` — Регулярное выражение с флагами `ig` (глобальный, без учёта регистра).
+`RegExp` — Регулярное выражение с флагом `i` (без учёта регистра).
+- Если строка `search` пустая, не является строкой или превышает `limit`, возвращается `/^/` (совпадает с началом любой строки).
 
 ```typescript
 import { getSearchExp } from '@dxtmisha/functional-basic'
 
+// Базовое использование
 const regex = getSearchExp('foo bar')
 
 regex.test('foo bar baz')  // true  — содержит оба слова
 regex.test('bar foo')      // true  — порядок не важен
-regex.test('foo only')     // false — слово bar отсутствует
+regex.test('foo only')     // false — слово "bar" отсутствует
 
 // Специальные символы экранируются автоматически
-const regex2 = getSearchExp('price $10.00')
-regex2.test('price $10.00') // true
-regex2.test('price X10Y00') // false
+const regex2 = getSearchExp('цена $10.00')
+regex2.test('цена $10.00') // true
+regex2.test('цена X10Y00') // false
+
+// Использование пользовательского лимита
+const regex3 = getSearchExp('очень длинная строка поиска', 10)
+regex3.test('любая строка') // true — возвращает /^/, так как длина поиска > 10
 ```

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

@@ -6,25 +6,32 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 Tiện ích tạo một `RegExp` không phân biệt chữ hoa/thường, khớp với chuỗi chứa **tất cả** các từ trong chuỗi tìm kiếm (theo bất kỳ thứ tự nào).
 
-Mỗi từ được tách bởi khoảng trắng, escape và bọc trong lookahead `(?=.*?từ)`. Rất phù hợp để xây dựng tính năng tìm kiếm trực tiếp hoặc lọc theo nhiều từ.
+Mỗi từ được tách bởi khoảng trắng, escape và bọc trong positive lookahead `(?=.*?từ)`. Rất phù hợp để xây dựng tính năng tìm kiếm trực tiếp hoặc lọc theo nhiều từ.
 
 **Tham số:**
 - `search: string` — Chuỗi tìm kiếm gồm một hoặc nhiều từ phân cách bởi khoảng trắng.
+- `limit: number` (tùy chọn, mặc định: `128`) — Độ dài tối đa cho phép của chuỗi tìm kiếm.
 
 **Trả về:**
-`RegExp` — Biểu thức chính quy với cờ `ig` (toàn cục, không phân biệt chữ hoa/thường).
+`RegExp` — Biểu thức chính quy với cờ `i` (không phân biệt chữ hoa/thường).
+- Nếu chuỗi `search` trống, không phải là chuỗi hoặc vượt quá `limit`, nó trả về `/^/` (khớp với vị trí bắt đầu của bất kỳ chuỗi nào).
 
 ```typescript
 import { getSearchExp } from '@dxtmisha/functional-basic'
 
+// Cách dùng cơ bản
 const regex = getSearchExp('foo bar')
 
 regex.test('foo bar baz')  // true  — chứa cả hai từ
 regex.test('bar foo')      // true  — thứ tự không quan trọng
-regex.test('foo only')     // false — thiếu từ bar
+regex.test('foo only')     // false — thiếu từ "bar"
 
 // Các ký tự đặc biệt được escape tự động
-const regex2 = getSearchExp('price $10.00')
-regex2.test('price $10.00') // true
-regex2.test('price X10Y00') // false
+const regex2 = getSearchExp('giá $10.00')
+regex2.test('giá $10.00') // true
+regex2.test('giá X10Y00') // false
+
+// Sử dụng giới hạn tùy chỉnh
+const regex3 = getSearchExp('một chuỗi tìm kiếm rất dài', 10)
+regex3.test('bất kỳ chuỗi nào') // true — trả về /^/ vì độ dài tìm kiếm > 10
 ```

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

@@ -9,10 +9,11 @@ A utility that builds a case-insensitive global `RegExp` for searching strings c
 Each word is split by spaces, escaped, and joined with the OR operator `|`. This is useful when you want to find a match for at least one of the entered words.
 
 **Parameters:**
-- `search: string` — A search string consisting of one or more space-separated words.
+- `search: string | RegExp` — A search string consisting of one or more space-separated words, or a `RegExp` object.
+- `limit: number = 128` — The maximum allowed length of the search string (ignored if a `RegExp` is passed).
 
 **Returns:**
-`RegExp` — A regular expression with flags `ig` (global, case-insensitive).
+`RegExp` — A regular expression with flags `ig` (global, case-insensitive). If the search string is empty or exceeds the limit, a regex that matches nothing is returned.
 
 ```typescript
 import { getSeparatingSearchExp } from '@dxtmisha/functional-basic'

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

@@ -9,10 +9,11 @@ import { Meta } from '@storybook/addon-docs/blocks'
 Каждое слово разбивается пробелами, экранируется и объединяется символом "или" `|`. Это полезно, когда нужно найти совпадение хотя бы по одному из введённых слов.
 
 **Параметры:**
-- `search: string` — Строка поиска, состоящая из одного или нескольких слов, разделённых пробелами.
+- `search: string | RegExp` — Строка поиска, состоящая из одного или нескольких слов, разделённых пробелами, или объект `RegExp`.
+- `limit: number = 128` — Максимальная длина строки поиска (игнорируется, если передан `RegExp`).
 
 **Возвращает:**
-`RegExp` — Регулярное выражение с флагами `ig` (глобальный, без учёта регистра).
+`RegExp` — Регулярное выражение с флагами `ig` (глобальный, без учёта регистра). Если строка поиска пуста или превышает лимит, возвращается регулярное выражение, которое ничего не находит.
 
 ```typescript
 import { getSeparatingSearchExp } from '@dxtmisha/functional-basic'

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

@@ -9,10 +9,11 @@ Tiện ích tạo một `RegExp` toàn cục, không phân biệt chữ hoa/thư
 Mỗi từ được tách bởi dấu cách, escape và nối với nhau bằng toán tử OR `|`. Điều này hữu ích khi bạn muốn tìm kết quả khớp với ít nhất một trong các từ đã nhập.
 
 **Tham số:**
-- `search: string` — Chuỗi tìm kiếm gồm một hoặc nhiều từ phân cách bởi dấu cách.
+- `search: string | RegExp` — Chuỗi tìm kiếm gồm một hoặc nhiều từ phân cách bởi dấu cách, hoặc đối tượng `RegExp`.
+- `limit: number = 128` — Độ dài tối đa cho phép của chuỗi tìm kiếm (bị bỏ qua nếu một `RegExp` được truyền vào).
 
 **Trả về:**
-`RegExp` — Biểu thức chính quy với cờ `ig` (toàn cục, không phân biệt chữ hoa/thường).
+`RegExp` — Biễu thức chính quy với cờ `ig` (toàn cục, không phân biệt chữ hoa/thường). Nếu chuỗi tìm kiếm trống hoặc vượt quá giới hạn, một regex không khớp với bất kỳ thứ gì sẽ được trả về.
 
 ```typescript
 import { getSeparatingSearchExp } from '@dxtmisha/functional-basic'

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

@@ -1,21 +1,37 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/en/functional-basic/Functions/toNumber - Converting a value to a number'/>
 
 # `toNumber`
 
-Extracts a numeric value from a string or a number. The function removes extra characters and correctly handles various thousands and decimal separators (spaces, commas, periods).
+Converts a string or number into a finite floating-point number. The function is designed to handle various formatting styles, including thousands separators and different decimal markers.
 
 **Parameters:**
-- `value?: T` — The input value (a string or a number).
+- `value?: NumberOrString` — The input value for conversion.
 
 **Returns:**
-`number` — The transformed float number. If the value is empty or invalid, `0` is returned.
+`number` — The parsed float number or `0` if conversion fails or the value is non-finite.
 
-```typescript
+## Examples
+
+<Source
+  language='typescript'
+  code={`
 import { toNumber } from '@dxtmisha/functional-basic'
 
-console.log(toNumber('1 250,50')) // 1250.5
-console.log(toNumber('1,000,000.99')) // 1000000.99
-console.log(toNumber('abc-12.5')) // 12.5
-```
+// 1. Handling various separators
+toNumber('1 250,50')       // 1250.5
+toNumber('1,000,000.99')   // 1000000.99
+toNumber('1.250,50')       // 1250.5
+
+// 2. Stripping non-numeric characters
+toNumber('abc-12.5')       // -12.5
+toNumber('$1,234.56')      // 1234.56
+
+// 3. Numbers and special values
+toNumber(123.45)           // 123.45
+toNumber(-0)               // 0 (normalized)
+toNumber(Infinity)         // 0
+toNumber(undefined)        // 0
+  `}
+/>

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

@@ -1,21 +1,37 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/functional-basic/Functions/toNumber - Преобразование значения в число'/>
 
 # `toNumber`
 
-Извлекает числовое значение из строки или числа. Функция удаляет лишние символы и корректно обрабатывает различные разделители тысяч и дробной части (пробелы, запятые, точки).
+Преобразует строку или число в конечное число с плавающей точкой. Функция разработана для обработки различных стилей форматирования, включая разделители тысяч и различные десятичные маркеры.
 
 **Параметры:**
-- `value?: T` — Входное значение (строка или число).
+- `value?: NumberOrString` — Входное значение для преобразования.
 
 **Возвращает:**
-`number` — Преобразованное число типа float. Если значение пустое или невалидное, возвращается `0`.
+`number` — Распарсенное число float или `0`, если преобразование не удалось или значение не является конечным числом.
 
-```typescript
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
 import { toNumber } from '@dxtmisha/functional-basic'
 
-console.log(toNumber('1 250,50')) // 1250.5
-console.log(toNumber('1,000,000.99')) // 1000000.99
-console.log(toNumber('abc-12.5')) // 12.5
-```
+// 1. Обработка различных разделителей
+toNumber('1 250,50')       // 1250.5
+toNumber('1,000,000.99')   // 1000000.99
+toNumber('1.250,50')       // 1250.5
+
+// 2. Очистка от нечисловых символов
+toNumber('abc-12.5')       // -12.5
+toNumber('$1,234.56')      // 1234.56
+
+// 3. Числа и специальные значения
+toNumber(123.45)           // 123.45
+toNumber(-0)               // 0 (нормализовано)
+toNumber(Infinity)         // 0
+toNumber(undefined)        // 0
+  `}
+/>

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

@@ -1,21 +1,37 @@
-import { Meta } from '@storybook/addon-docs/blocks'
+import { Meta, Source } from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/vi/functional-basic/Functions/toNumber - Chuyển đổi giá trị sang kiểu số'/>
 
 # `toNumber`
 
-Trích xuất giá trị số từ một chuỗi hoặc một số. Hàm loại bỏ các ký tự thừa và xử lý chính xác các ký hiệu phân cách phần nghìn và phần thập phân khác nhau (khoảng trắng, dấu phẩy, dấu chấm).
+Chuyển đổi một chuỗi hoặc một số thành một số thực (float) hữu hạn. Hàm được thiết kế để xử lý nhiều kiểu định dạng khác nhau, bao gồm các ký tự phân cách phần nghìn và các dấu thập phân khác nhau.
 
 **Tham số:**
-- `value?: T` — Giá trị đầu vào (chuỗi hoặc số).
+- `value?: NumberOrString` — Giá trị đầu vào cần chuyển đổi.
 
 **Trả về:**
-`number` — Số thực (float) sau khi chuyển đổi. Nếu giá trị trống hoặc không hợp lệ, hàm trả về `0`.
+`number` — Số thực sau khi phân tách hoặc `0` nếu chuyển đổi thất bại hoặc giá trị là vô hạn.
 
-```typescript
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
 import { toNumber } from '@dxtmisha/functional-basic'
 
-console.log(toNumber('1 250,50')) // 1250.5
-console.log(toNumber('1,000,000.99')) // 1000000.99
-console.log(toNumber('abc-12.5')) // 12.5
-```
+// 1. Xử lý các loại dấu phân cách
+toNumber('1 250,50')       // 1250.5
+toNumber('1,000,000.99')   // 1000000.99
+toNumber('1.250,50')       // 1250.5
+
+// 2. Loại bỏ các ký tự không phải số
+toNumber('abc-12.5')       // -12.5
+toNumber('$1,234.56')      // 1234.56
+
+// 3. Số và các giá trị đặc biệt
+toNumber(123.45)           // 123.45
+toNumber(-0)               // 0 (đã chuẩn hóa)
+toNumber(Infinity)         // 0
+toNumber(undefined)        // 0
+  `}
+/>

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

@@ -0,0 +1,28 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Functions/toString - Conversion of a value to a string'/>
+
+# `toString`
+
+A utility for converting a value to a string. Returns an empty string if the value is null or undefined.
+
+**Parameters:**
+- `value: string | null | undefined` — The value for conversion.
+
+**Returns:**
+`string` — The string representation of the value.
+
+
+## Examples
+
+<Source
+  language='typescript'
+  code={`
+import { toString } from '@dxtmisha/functional-basic'
+
+toString('Hello')         // 'Hello'
+toString(null)            // ''
+toString(undefined)       // ''
+
+  `}
+/>

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

@@ -0,0 +1,28 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Functions/toString - Преобразование значения в строку'/>
+
+# `toString`
+
+Утилита для преобразования значения в строку. Возвращает пустую строку, если значение равно null или undefined.
+
+**Параметры:**
+- `value: string | null | undefined` — Значение для преобразования.
+
+**Возвращает:**
+`string` — Строковое представление значения.
+
+
+## Примеры
+
+<Source
+  language='typescript'
+  code={`
+import { toString } from '@dxtmisha/functional-basic'
+
+toString('Привет')        // 'Привет'
+toString(null)            // ''
+toString(undefined)       // ''
+
+  `}
+/>

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

@@ -0,0 +1,28 @@
+import { Meta, Source } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/toString - Chuyển đổi một giá trị thành chuỗi'/>
+
+# `toString`
+
+Một tiện ích để chuyển đổi một giá trị thành chuỗi. Trả về một chuỗi rỗng nếu giá trị là null hoặc undefined.
+
+**Tham số:**
+- `value: string | null | undefined` — Giá trị cần chuyển đổi.
+
+**Trả về:**
+`string` — Biểu diễn chuỗi của giá trị.
+
+
+## Ví dụ
+
+<Source
+  language='typescript'
+  code={`
+import { toString } from '@dxtmisha/functional-basic'
+
+toString('Xin chào')      // 'Xin chào'
+toString(null)            // ''
+toString(undefined)       // ''
+
+  `}
+/>

package/src/media/functional/functional-basic/icons/icons.en.mdx

@@ -23,6 +23,9 @@ Icons.addByList({
 if (Icons.is('home')) {
   const path = await Icons.get('home')
 }
+
+// 4. Synchronous retrieval
+const fastPath = Icons.getAsync('search') // returns string or empty string
 ```
 
 ## Lazy Loading

package/src/media/functional/functional-basic/icons/icons.ru.mdx

@@ -23,6 +23,9 @@ Icons.addByList({
 if (Icons.is('home')) {
   const path = await Icons.get('home')
 }
+
+// 4. Синхронное получение
+const fastPath = Icons.getAsync('search') // возвращает строку или пустую строку
 ```
 
 ## Ленивая загрузка