@dxtmisha/wiki 0.39.8 → 0.57.0

package/src/media/functional/functional-basic/classes/MetaStatic/MetaStatic.en.mdx

@@ -51,6 +51,7 @@ All setter methods return `typeof MetaStatic` to support method chaining.
 ### Output
 
 - `html(): string` — Generates a complete string of HTML meta tags for all managed properties.
+- `htmlTitle(): string` — Generates a complete HTML-safe title string.
 
 ## Architecture
 
@@ -74,5 +75,5 @@ MetaStatic
 
 console.log(MetaStatic.getTitle()); // "Summer Collection"
 document.title; // "Summer Collection - My Online Store"
+console.log(MetaStatic.htmlTitle()); // "Summer Collection - My Online Store"
 ```
-

package/src/media/functional/functional-basic/classes/MetaStatic/MetaStatic.ru.mdx

@@ -51,6 +51,7 @@ import {Meta} from '@storybook/addon-docs/blocks'
 ### Вывод
 
 - `html(): string` — Генерирует полную строку HTML-тегов для всех управляемых свойств.
+- `htmlTitle(): string` — Генерирует полную HTML-безопасную строку заголовка.
 
 ## Архитектура
 
@@ -74,5 +75,5 @@ MetaStatic
 
 console.log(MetaStatic.getTitle()); // "Летняя коллекция"
 document.title; // "Летняя коллекция - Мой Интернет Магазин"
+console.log(MetaStatic.htmlTitle()); // "Летняя коллекция - Мой Интернет Магазин"
 ```
-

package/src/media/functional/functional-basic/classes/MetaStatic/MetaStatic.vi.mdx

@@ -17,7 +17,7 @@ Lớp `MetaStatic` là **điểm truy cập tĩnh** để quản lý các thẻ
 
 ### Truy cập
 
-- `getItem(): Meta` — Trả về thực thể `Meta` cơ sở.
+- `getItem(): Meta` — Trả về thực entity `Meta` cơ sở.
 - `getOg(): MetaOg` — Lấy thực thể `MetaOg` cho các thao tác Open Graph nâng cao.
 - `getTwitter(): MetaTwitter` — Lấy thực thể `MetaTwitter` cho các thao tác Twitter Card nâng cao.
 
@@ -51,6 +51,7 @@ Tất cả các phương thức thiết lập đều trả về `typeof MetaStat
 ### Đầu ra
 
 - `html(): string` — Tạo ra một chuỗi đầy đủ các thẻ HTML meta cho tất cả các thuộc tính được quản lý.
+- `htmlTitle(): string` — Tạo ra chuỗi tiêu đề an toàn với HTML.
 
 ## Kiến trúc
 
@@ -74,5 +75,5 @@ MetaStatic
 
 console.log(MetaStatic.getTitle()); // "Bộ sưu tập mùa hè"
 document.title; // "Bộ sưu tập mùa hè - Cửa hàng trực tuyến của tôi"
+console.log(MetaStatic.htmlTitle()); // "Bộ sưu tập mùa hè - Cửa hàng trực tuyến của tôi"
 ```
-

package/src/media/functional/functional-basic/classes/ServerStorage/ServerStorage.en.mdx

@@ -52,6 +52,8 @@ Saves a value to the storage.
 
 - `init(listener: () => Record<string, any>): typeof ServerStorage` — Initializes the storage with a context listener. On the server, this listener should return an object unique to each request.
 - `has(key: string): boolean` — Checks for the existence of a key in the current context.
+- `remove(key: string): void` — Removes a value by key from the storage.
+- `setErrorStatus(hide: boolean): void` — Sets whether to hide context missing errors in the console/error center.
 - `reset(): void` — Resets the storage, clearing all stored data and the listener. Useful for performing cleanup.
 - `toString(): string` — Generates an HTML `<script type="application/json">` tag containing all data marked for hydration.
 
@@ -127,5 +129,3 @@ This method generates a special script tag:
   {"userSettings":{"fontSize":16}}
 </script>
 ```
-
-

package/src/media/functional/functional-basic/classes/ServerStorage/ServerStorage.ru.mdx

@@ -52,6 +52,8 @@ const theme = ServerStorage.get('theme') // 'dark'
 
 - `init(listener: () => Record<string, any>): typeof ServerStorage` — Инициализирует хранилище слушателем контекста. На сервере этот слушатель должен возвращать объект, уникальный для каждого запроса.
 - `has(key: string): boolean` — Проверяет наличие ключа в текущем контексте.
+- `remove(key: string): void` — Удаляет значение по ключу из хранилища.
+- `setErrorStatus(hide: boolean): void` — Устанавливает, нужно ли скрывать ошибки отсутствия контекста в консоли/центре ошибок.
 - `reset(): void` — Сбрасывает хранилище, очищая все сохраненные данные и слушателя. Полезно для выполнения очистки.
 - `toString(): string` — Генерирует HTML-тег `<script type="application/json">` со всеми данными, помеченными для гидратации.
 
@@ -127,5 +129,3 @@ ServerStorage.set('userSettings', () => ({ fontSize: 16 }), true)
   {"userSettings":{"fontSize":16}}
 </script>
 ```
-
-

package/src/media/functional/functional-basic/classes/ServerStorage/ServerStorage.vi.mdx

@@ -52,6 +52,8 @@ Lưu một giá trị vào kho lưu trữ.
 
 - `init(listener: () => Record<string, any>): typeof ServerStorage` — Khởi tạo kho lưu trữ với bộ lắng nghe ngữ cảnh. Trên máy chủ, bộ lắng nghe này sẽ trả về một đối tượng duy nhất cho mỗi yêu cầu.
 - `has(key: string): boolean` — Kiếm tra sự tồn tại của một khóa trong ngữ cảnh hiện tại.
+- `remove(key: string): void` — Xóa một giá trị theo khóa khỏi kho lưu trữ.
+- `setErrorStatus(hide: boolean): void` — Thiết lập việc ẩn lỗi thiếu ngữ cảnh trong bảng điều khiển hoặc trung tâm lỗi.
 - `reset(): void` — Đặt lại kho lưu trữ, xóa tất cả dữ liệu đã lưu và bộ lắng nghe. Hữu ích cho việc dọn dẹp.
 - `toString(): string` — Tạo một thẻ HTML `<script type="application/json">` chứa tất cả dữ liệu được đánh dấu để hydration.
 
@@ -127,5 +129,3 @@ Phương thức này tạo ra một thẻ script đặc biệt:
   {"userSettings":{"fontSize":16}}
 </script>
 ```
-
-

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') // возвращает строку или пустую строку
 ```
 
 ## Ленивая загрузка

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

@@ -23,6 +23,9 @@ Icons.addByList({
 if (Icons.is('home')) {
   const path = await Icons.get('home')
 }
+
+// 4. Lấy dữ liệu đồng bộ
+const fastPath = Icons.getAsync('search') // trả về chuỗi hoặc chuỗi rỗng
 ```
 
 ## Tải chậm (Lazy Loading)

package/src/media/functional/nitro-basic/about/about.en.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/nitro-basic/! About Library'/>
+
+# [@dxtmisha/nitro-basic](https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic)
+
+`@dxtmisha/nitro-basic` is a foundational utility library designed for building robust Server-Side Rendering (SSR) applications using Vue 3 and Nitro. It provides a set of tools for state synchronization between server and client, routing management, and simplifying the SSR application development process.
+
+## Installation
+
+To start using the library, install it via npm:
+
+```bash
+npm i @dxtmisha/nitro-basic
+```
+
+## What is this library for?
+
+Developing applications with SSR (Server-Side Rendering) requires special attention to detail: from isolating states for different users on the server to preventing hydration mismatches on the client.
+
+`@dxtmisha/nitro-basic` handles routine tasks for configuring the Nitro and Vue environment, providing a unified mechanism for initializing storages, API clients, and routing. It serves as a bridge between the powerful capabilities of Nitro and the reactivity of Vue 3.
+
+## What's inside?
+
+The library includes tools to solve key SSR tasks:
+
+**Environment Initialization** — the `uiCreateServerApp` and `uiCreateClientApp` functions provide a standardized way to launch the application in different environments, automatically configuring the necessary plugins and services.
+
+**State and Storage Management** — tools for working with server storage (`initServerStorage`) and cookies (`initCookieStorage`). They ensure that data received on the server is accessible to Vue components via the `provide/inject` mechanism.
+
+**Routing Synchronization** — utilities for creating and initializing the router (`uiCreateSsrRouter`, `initServerRouter`), which ensure correct URL navigation on the server side and smooth handover to the client.
+
+**Data Hydration** — automatic generation of JSON scripts (`initScriptsJson`) to transfer `ServerStorage` state and `Api` data from the server to the client, eliminating redundant API requests during page load.
+
+**API Integration** — means for configuring request headers and origin, allowing the use of absolute URLs during server-side calls and maintaining authorization via cookie forwarding.
+
+**Nitro Plugins** — ready-made functions to extend Nitro's capabilities, such as server-side API response caching.
+
+## Who is it for?
+
+The library is designed for developers building their solutions on the Vue 3 + Nitro stack (or Nuxt-like architectures) who need low-level but flexible tools to manage the lifecycle of an SSR application.
+
+## Principles
+
+- **SSR Safety** — all tools are designed to eliminate data leaks between requests from different users.
+- **Seamless Hydration** — minimizing differences between server and client states.
+- **Modularity** — the ability to use both comprehensive application creation functions and individual atomic initialization utilities.
+- **Integration** — deep compatibility with the `@dxtmisha/functional` ecosystem.
+
+## Git
+
+[https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic](https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic)

package/src/media/functional/nitro-basic/about/about.ru.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/nitro-basic/! О библиотеке'/>
+
+# [@dxtmisha/nitro-basic](https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic)
+
+`@dxtmisha/nitro-basic` — это базовая библиотека утилит, предназначенная для создания надежных приложений с серверным рендерингом (SSR) на базе Vue 3 и Nitro. Она предоставляет набор инструментов для синхронизации состояния между сервером и клиентом, управления маршрутизацией и упрощения процесса разработки SSR-приложений.
+
+## Установка
+
+Чтобы начать использовать библиотеку, установите ее через npm:
+
+```bash
+npm i @dxtmisha/nitro-basic
+```
+
+## Для чего эта библиотека?
+
+Разработка приложений с SSR (Server-Side Rendering) требует особого внимания к деталям: от изоляции состояний разных пользователей на сервере до предотвращения ошибок гидратации (hydration mismatch) на клиенте. 
+
+`@dxtmisha/nitro-basic` берет на себя рутинные задачи по настройке окружения Nitro и Vue, обеспечивая единый механизм инициализации хранилищ, API-клиентов и маршрутизации. Она служит связующим звеном между мощными возможностями Nitro и реактивностью Vue 3.
+
+## Что в ней есть?
+
+Библиотека включает в себя инструменты для решения ключевых задач SSR:
+
+**Инициализация окружения** — функции `uiCreateServerApp` и `uiCreateClientApp` предоставляют стандартизированный способ запуска приложения в разных средах, автоматически настраивая необходимые плагины и сервисы.
+
+**Управление состоянием и хранилищами** — инструменты для работы с серверным хранилищем (`initServerStorage`) и cookie (`initCookieStorage`). Они гарантируют, что данные, полученные на сервере, будут доступны компонентам Vue через механизм `provide/inject`.
+
+**Синхронизация маршрутизации** — утилиты для создания и инициализации роутера (`uiCreateSsrRouter`, `initServerRouter`), которые обеспечивают правильный переход по URL на стороне сервера и плавную передачу управления клиенту.
+
+**Гидратация данных** — автоматическая генерация JSON-скриптов (`initScriptsJson`) для передачи состояния `ServerStorage` и данных `Api` с сервера на клиент, что исключает повторные запросы к API при загрузке страницы.
+
+**Интеграция с API** — средства для настройки заголовков и источника (origin) запросов, позволяющие использовать абсолютные URL при серверных вызовах и сохранять авторизацию через проброс cookie.
+
+**Nitro Плагины** — готовые функции для расширения возможностей Nitro, такие как кэширование API ответов на уровне сервера.
+
+## Для кого это?
+
+Библиотека создана для разработчиков, которые строят свои решения на стеке Vue 3 + Nitro (или Nuxt-подобные архитектуры) и нуждаются в низкоуровневых, но гибких инструментах для управления жизненным циклом SSR-приложения.
+
+## Принципы
+
+- **Безопасность SSR** — все инструменты спроектированы так, чтобы исключить утечки данных между запросами разных пользователей.
+- **Бесшовная гидратация** — минимизация различий между серверным и клиентским состоянием.
+- **Модульность** — возможность использовать как комплексные функции создания приложения, так и отдельные атомарные утилиты инициализации.
+- **Интеграция** — глубокая совместимость с экосистемой `@dxtmisha/functional`.
+
+## Git
+
+[https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic](https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic)

package/src/media/functional/nitro-basic/about/about.vi.mdx

@@ -0,0 +1,52 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/nitro-basic/! Giới thiệu về thư viện'/>
+
+# [@dxtmisha/nitro-basic](https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic)
+
+`@dxtmisha/nitro-basic` là một thư viện tiện ích cơ bản được thiết kế để xây dựng các ứng dụng Server-Side Rendering (SSR) mạnh mẽ bằng Vue 3 và Nitro. Nó cung cấp một bộ công cụ để đồng bộ hóa trạng thái giữa server và client, quản lý định tuyến và đơn giản hóa quy trình phát triển ứng dụng SSR.
+
+## Cài đặt
+
+Để bắt đầu sử dụng thư viện, hãy cài đặt nó qua npm:
+
+```bash
+npm i @dxtmisha/nitro-basic
+```
+
+## Thư viện này dùng để làm gì?
+
+Phát triển các ứng dụng với SSR (Server-Side Rendering) đòi hỏi sự chú ý đặc biệt đến từng chi tiết: từ việc cô lập trạng thái cho những người dùng khác nhau trên server đến việc ngăn chặn lỗi không khớp khi hydrat hóa (hydration mismatch) trên client.
+
+`@dxtmisha/nitro-basic` xử lý các tác vụ thông thường để cấu hình môi trường Nitro và Vue, cung cấp một cơ chế thống nhất để khởi tạo bộ lưu trữ, API client và định tuyến. Nó đóng vai trò như một cầu nối giữa các khả năng mạnh mẽ của Nitro và tính phản ứng của Vue 3.
+
+## Có gì bên trong?
+
+Thư viện bao gồm các công cụ để giải quyết các tác vụ SSR chính:
+
+**Khởi tạo môi trường** — các hàm `uiCreateServerApp` và `uiCreateClientApp` cung cấp một cách tiêu chuẩn hóa để khởi chạy ứng dụng trong các môi trường khác nhau, tự động cấu hình các plugin và dịch vụ cần thiết.
+
+**Quản lý trạng thái và bộ lưu trữ** — các công cụ để làm việc với bộ lưu trữ server (`initServerStorage`) và cookie (`initCookieStorage`). Chúng đảm bảo rằng dữ liệu nhận được trên server có thể truy cập được bởi các thành phần Vue thông qua cơ chế `provide/inject`.
+
+**Đồng bộ hóa định tuyến** — các tiện ích để tạo và khởi tạo router (`uiCreateSsrRouter`, `initServerRouter`), đảm bảo điều hướng URL chính xác ở phía server và chuyển giao mượt mà cho client.
+
+**Hydrat hóa dữ liệu** — tự động tạo các kịch bản JSON (`initScriptsJson`) để chuyển trạng thái `ServerStorage` và dữ liệu `Api` từ server sang client, loại bỏ các yêu cầu API dư thừa trong quá trình tải trang.
+
+**Tích hợp API** — phương tiện để cấu hình các header và origin của yêu cầu, cho phép sử dụng URL tuyệt đối trong các cuộc gọi phía server và duy trì ủy quyền thông qua chuyển tiếp cookie.
+
+**Nitro Plugins** — các hàm có sẵn để mở rộng khả năng của Nitro, chẳng hạn như lưu trữ đệm phản hồi API phía server.
+
+## Nó dành cho ai?
+
+Thư viện được thiết kế cho các nhà phát triển đang xây dựng giải pháp của họ trên stack Vue 3 + Nitro (hoặc các kiến trúc giống Nuxt) và cần các công cụ cấp thấp nhưng linh hoạt để quản lý vòng đời của một ứng dụng SSR.
+
+## Nguyên tắc
+
+- **An toàn SSR** — tất cả các công cụ được thiết kế để loại bỏ rò rỉ dữ liệu giữa các yêu cầu từ những người dùng khác nhau.
+- **Hydrat hóa mượt mà** — giảm thiểu sự khác biệt giữa trạng thái server và client.
+- **Tính mô-đun** — khả năng sử dụng cả các hàm tạo ứng dụng toàn diện và các tiện ích khởi tạo nguyên tử riêng lẻ.
+- **Tích hợp** — khả năng tương thích sâu với hệ sinh thái `@dxtmisha/functional`.
+
+## Git
+
+[https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic](https://github.com/dxtmisha/dxt-ui/tree/main/packages/nitro-basic)

package/src/media/functional/nitro-basic/composables/useHeaders/useHeaders.en.mdx

@@ -0,0 +1,29 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/nitro-basic/Composables/useHeaders - Get Headers'/>
+
+# `useHeaders`
+
+A composable function that provides access to the API headers of the current request. It can return either the entire `Headers` object or the value of a specific header by its name.
+
+**Parameters:**
+- `name?: string` — Optional header name.
+
+**Returns:**
+- `Headers | undefined` — If no name is provided, returns the entire headers object.
+- `string | undefined` — If a name is provided, returns the value of that header.
+
+**Usage Example:**
+
+```typescript
+import { useHeaders } from '@dxtmisha/nitro-basic'
+
+// Get a specific header
+const contentType = useHeaders('Content-Type')
+
+// Get all headers
+const headers = useHeaders()
+if (headers) {
+  console.log(headers.get('Authorization'))
+}
+```

package/src/media/functional/nitro-basic/composables/useHeaders/useHeaders.ru.mdx

@@ -0,0 +1,29 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/nitro-basic/Composables/useHeaders - Получение заголовков'/>
+
+# `useHeaders`
+
+Композитная функция (composable), которая позволяет получить доступ к заголовкам API текущего запроса. Она может возвращать как весь объект `Headers`, так и значение конкретного заголовка по его имени.
+
+**Параметры:**
+- `name?: string` — Опциональное имя заголовка.
+
+**Возвращает:**
+- `Headers | undefined` — Если имя не передано, возвращает весь объект заголовков.
+- `string | undefined` — Если передано имя, возвращает значение этого заголовка.
+
+**Пример использования:**
+
+```typescript
+import { useHeaders } from '@dxtmisha/nitro-basic'
+
+// Получение конкретного заголовка
+const contentType = useHeaders('Content-Type')
+
+// Получение всех заголовков
+const headers = useHeaders()
+if (headers) {
+  console.log(headers.get('Authorization'))
+}
+```

package/src/media/functional/nitro-basic/composables/useHeaders/useHeaders.vi.mdx

@@ -0,0 +1,29 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/nitro-basic/Composables/useHeaders - Lấy Header'/>
+
+# `useHeaders`
+
+Một hàm composable cung cấp quyền truy cập vào các header API của yêu cầu hiện tại. Nó có thể trả về toàn bộ đối tượng `Headers` hoặc giá trị của một header cụ thể theo tên của nó.
+
+**Tham số:**
+- `name?: string` — Tên header (tùy chọn).
+
+**Trả về:**
+- `Headers | undefined` — Nếu không cung cấp tên, trả về toàn bộ đối tượng headers.
+- `string | undefined` — Nếu cung cấp tên, trả về giá trị của header đó.
+
+**Ví dụ sử dụng:**
+
+```typescript
+import { useHeaders } from '@dxtmisha/nitro-basic'
+
+// Lấy một header cụ thể
+const contentType = useHeaders('Content-Type')
+
+// Lấy tất cả các header
+const headers = useHeaders()
+if (headers) {
+  console.log(headers.get('Authorization'))
+}
+```

package/src/media/functional/nitro-basic/functions/getRequestOrigin/getRequestOrigin.en.mdx

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/nitro-basic/Functions/getRequestOrigin - Get Request Origin'/>
+
+# `getRequestOrigin`
+
+A utility function that extracts the origin (protocol and domain) from a [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request) object. This is useful for getting the base URL of the current request without paths or query parameters.
+
+**Parameters:**
+- `request: Request` — A standard Web API Request object.
+
+**Returns:**
+`string` — The origin string (e.g., `https://example.com`).
+
+```typescript
+import { getRequestOrigin } from '@dxtmisha/nitro-basic'
+
+// Example with a Request object
+const request = new Request('https://dxtmisha.com/docs/api?query=1')
+const origin = getRequestOrigin(request)
+
+// Result: "https://dxtmisha.com"
+console.log(origin)
+```

package/src/media/functional/nitro-basic/functions/getRequestOrigin/getRequestOrigin.ru.mdx

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/nitro-basic/Functions/getRequestOrigin - Получение источника запроса'/>
+
+# `getRequestOrigin`
+
+Утилитарная функция, которая извлекает источник (протокол и домен) из объекта [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request). Это удобно для получения базового URL текущего запроса без путей и параметров.
+
+**Параметры:**
+- `request: Request` — Объект стандартного Web API запроса.
+
+**Возвращает:**
+`string` — Строка источника (например, `https://example.com`).
+
+```typescript
+import { getRequestOrigin } from '@dxtmisha/nitro-basic'
+
+// Пример с объектом Request
+const request = new Request('https://dxtmisha.com/docs/api?query=1')
+const origin = getRequestOrigin(request)
+
+// Результат: "https://dxtmisha.com"
+console.log(origin)
+```

package/src/media/functional/nitro-basic/functions/getRequestOrigin/getRequestOrigin.vi.mdx

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/nitro-basic/Functions/getRequestOrigin - Lấy nguồn gốc của yêu cầu'/>
+
+# `getRequestOrigin`
+
+Một hàm tiện ích giúp trích xuất nguồn (giao thức và tên miền) từ đối tượng [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request). Điều này rất hữu ích để lấy URL cơ sở của yêu cầu hiện tại mà không có đường dẫn hoặc tham số truy vấn.
+
+**Tham số:**
+- `request: Request` — Đối tượng Request chuẩn Web API.
+
+**Trả về:**
+`string` — Chuỗi nguồn (ví dụ: `https://example.com`).
+
+```typescript
+import { getRequestOrigin } from '@dxtmisha/nitro-basic'
+
+// Ví dụ với đối tượng Request
+const request = new Request('https://dxtmisha.com/docs/api?query=1')
+const origin = getRequestOrigin(request)
+
+// Kết quả: "https://dxtmisha.com"
+console.log(origin)
+```

package/src/media/functional/nitro-basic/functions/getRequestUrl/getRequestUrl.en.mdx

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/nitro-basic/Functions/getRequestUrl - Get Request Pathname'/>
+
+# `getRequestUrl`
+
+A utility function that extracts the pathname from a [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request) object. This allows you to get only the resource path, excluding the protocol, domain, and query parameters.
+
+**Parameters:**
+- `request: Request` — A standard Web API Request object.
+
+**Returns:**
+`string` — The pathname string (e.g., `/api/users`).
+
+```typescript
+import { getRequestUrl } from '@dxtmisha/nitro-basic'
+
+// Example with a Request object
+const request = new Request('https://dxtmisha.com/docs/api?query=1')
+const urlPath = getRequestUrl(request)
+
+// Result: "/docs/api"
+console.log(urlPath)
+```

package/src/media/functional/nitro-basic/functions/getRequestUrl/getRequestUrl.ru.mdx

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/nitro-basic/Functions/getRequestUrl - Получение пути запроса'/>
+
+# `getRequestUrl`
+
+Утилитарная функция, которая извлекает путь (pathname) из объекта [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request). Это позволяет получить только путь к ресурсу, исключая протокол, домен и параметры запроса.
+
+**Параметры:**
+- `request: Request` — Объект стандартного Web API запроса.
+
+**Возвращает:**
+`string` — Строка пути (например, `/api/users`).
+
+```typescript
+import { getRequestUrl } from '@dxtmisha/nitro-basic'
+
+// Пример с объектом Request
+const request = new Request('https://dxtmisha.com/docs/api?query=1')
+const urlPath = getRequestUrl(request)
+
+// Результат: "/docs/api"
+console.log(urlPath)
+```

package/src/media/functional/nitro-basic/functions/getRequestUrl/getRequestUrl.vi.mdx

@@ -0,0 +1,24 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/nitro-basic/Functions/getRequestUrl - Lấy đường dẫn yêu cầu'/>
+
+# `getRequestUrl`
+
+Một hàm tiện ích giúp trích xuất đường dẫn (pathname) từ đối tượng [Request](https://developer.mozilla.org/en-US/docs/Web/API/Request). Điều này cho phép bạn chỉ lấy đường dẫn tài nguyên, loại trừ giao thức, tên miền và các tham số truy vấn.
+
+**Tham số:**
+- `request: Request` — Đối tượng Request chuẩn Web API.
+
+**Trả về:**
+`string` — Chuỗi đường dẫn (ví dụ: `/api/users`).
+
+```typescript
+import { getRequestUrl } from '@dxtmisha/nitro-basic'
+
+// Ví dụ với đối tượng Request
+const request = new Request('https://dxtmisha.com/docs/api?query=1')
+const urlPath = getRequestUrl(request)
+
+// Kết quả: "/docs/api"
+console.log(urlPath)
+```

package/src/media/functional/nitro-basic/functions/initApi/initApi.en.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/nitro-basic/Functions/initApi - API Client Initialization'/>
+
+# `initApi`
+
+A utility function that initializes the API client for the current request on the server. It sets the base origin extracted from the request object to ensure that absolute URLs are correctly formed when making API requests during server-side rendering (SSR).
+
+**Parameters:**
+- `request: Request` — The incoming server HTTP request object.
+
+**Usage Example:**
+
+```typescript
+import { initApi } from '@dxtmisha/nitro-basic'
+
+export default defineEventHandler((event) => {
+  const request = toWebRequest(event)
+  initApi(request)
+  
+  // Now the Api client is configured with the correct origin
+})
+```

package/src/media/functional/nitro-basic/functions/initApi/initApi.ru.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/nitro-basic/Functions/initApi - Инициализация API клиента'/>
+
+# `initApi`
+
+Утилитарная функция, которая инициализирует API-клиент для текущего запроса на сервере. Она устанавливает базовый источник (origin), извлеченный из объекта запроса, чтобы гарантировать правильное формирование абсолютных URL-адресов при выполнении API-запросов во время серверного рендеринга (SSR).
+
+**Параметры:**
+- `request: Request` — Объект входящего HTTP-запроса сервера.
+
+**Пример использования:**
+
+```typescript
+import { initApi } from '@dxtmisha/nitro-basic'
+
+export default defineEventHandler((event) => {
+  const request = toWebRequest(event)
+  initApi(request)
+  
+  // Теперь Api клиент настроен на правильный origin
+})
+```

package/src/media/functional/nitro-basic/functions/initApi/initApi.vi.mdx

@@ -0,0 +1,23 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/nitro-basic/Functions/initApi - Khởi tạo API client'/>
+
+# `initApi`
+
+Một hàm tiện ích giúp khởi tạo API client cho yêu cầu hiện tại trên server. Nó thiết lập origin cơ sở được trích xuất từ đối tượng yêu cầu để đảm bảo rằng các URL tuyệt đối được hình thành chính xác khi thực hiện các yêu cầu API trong quá trình render phía server (SSR).
+
+**Tham số:**
+- `request: Request` — Đối tượng yêu cầu HTTP server đến.
+
+**Ví dụ sử dụng:**
+
+```typescript
+import { initApi } from '@dxtmisha/nitro-basic'
+
+export default defineEventHandler((event) => {
+  const request = toWebRequest(event)
+  initApi(request)
+  
+  // Bây giờ Api client đã được cấu hình với origin chính xác
+})
+```

package/src/media/functional/nitro-basic/functions/initClientRouter/initClientRouter.en.mdx

@@ -0,0 +1,21 @@
+import { Meta } from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/nitro-basic/Functions/initClientRouter - Wait for Router Ready'/>
+
+# `initClientRouter`
+
+An asynchronous function that waits for the initialization and full readiness of the Vue router. This ensures that all asynchronous components and initial navigation hooks are resolved before the application continues execution (e.g., before hydration on the client or rendering on the server).
+
+**Parameters:**
+- `router: Router | undefined` — The Vue Router instance.
+
+**Returns:**
+`Promise<void>`
+
+```typescript
+import { initClientRouter } from '@dxtmisha/nitro-basic'
+import { createRouter } from './router'
+
+const router = createRouter()
+await initClientRouter(router)
+```