@dxtmisha/wiki 0.56.0 → 0.57.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{defineProperty-149Ahniv.js → defineProperty-3CuEayIP.js} +4 -4
- package/dist/library.js +1 -1
- package/dist/storybook.js +1 -1
- package/package.json +1 -1
- package/src/media/functional/nitro-basic/about/about.en.mdx +52 -0
- package/src/media/functional/nitro-basic/about/about.ru.mdx +52 -0
- package/src/media/functional/nitro-basic/about/about.vi.mdx +52 -0
- package/src/media/functional/nitro-basic/composables/useHeaders/useHeaders.en.mdx +29 -0
- package/src/media/functional/nitro-basic/composables/useHeaders/useHeaders.ru.mdx +29 -0
- package/src/media/functional/nitro-basic/composables/useHeaders/useHeaders.vi.mdx +29 -0
- package/src/media/functional/nitro-basic/functions/getRequestOrigin/getRequestOrigin.en.mdx +24 -0
- package/src/media/functional/nitro-basic/functions/getRequestOrigin/getRequestOrigin.ru.mdx +24 -0
- package/src/media/functional/nitro-basic/functions/getRequestOrigin/getRequestOrigin.vi.mdx +24 -0
- package/src/media/functional/nitro-basic/functions/getRequestUrl/getRequestUrl.en.mdx +24 -0
- package/src/media/functional/nitro-basic/functions/getRequestUrl/getRequestUrl.ru.mdx +24 -0
- package/src/media/functional/nitro-basic/functions/getRequestUrl/getRequestUrl.vi.mdx +24 -0
- package/src/media/functional/nitro-basic/functions/initApi/initApi.en.mdx +23 -0
- package/src/media/functional/nitro-basic/functions/initApi/initApi.ru.mdx +23 -0
- package/src/media/functional/nitro-basic/functions/initApi/initApi.vi.mdx +23 -0
- package/src/media/functional/nitro-basic/functions/initClientRouter/initClientRouter.en.mdx +21 -0
- package/src/media/functional/nitro-basic/functions/initClientRouter/initClientRouter.ru.mdx +21 -0
- package/src/media/functional/nitro-basic/functions/initClientRouter/initClientRouter.vi.mdx +21 -0
- package/src/media/functional/nitro-basic/functions/initCookieStorage/initCookieStorage.en.mdx +18 -0
- package/src/media/functional/nitro-basic/functions/initCookieStorage/initCookieStorage.ru.mdx +18 -0
- package/src/media/functional/nitro-basic/functions/initCookieStorage/initCookieStorage.vi.mdx +18 -0
- package/src/media/functional/nitro-basic/functions/initHeaders/initHeaders.en.mdx +16 -0
- package/src/media/functional/nitro-basic/functions/initHeaders/initHeaders.ru.mdx +16 -0
- package/src/media/functional/nitro-basic/functions/initHeaders/initHeaders.vi.mdx +16 -0
- package/src/media/functional/nitro-basic/functions/initPluginApiCache/initPluginApiCache.en.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/initPluginApiCache/initPluginApiCache.ru.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/initPluginApiCache/initPluginApiCache.vi.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/initPluginBasic/initPluginBasic.en.mdx +34 -0
- package/src/media/functional/nitro-basic/functions/initPluginBasic/initPluginBasic.ru.mdx +34 -0
- package/src/media/functional/nitro-basic/functions/initPluginBasic/initPluginBasic.vi.mdx +34 -0
- package/src/media/functional/nitro-basic/functions/initScriptsJson/initScriptsJson.en.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/initScriptsJson/initScriptsJson.ru.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/initScriptsJson/initScriptsJson.vi.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/initServerRouter/initServerRouter.en.mdx +20 -0
- package/src/media/functional/nitro-basic/functions/initServerRouter/initServerRouter.ru.mdx +20 -0
- package/src/media/functional/nitro-basic/functions/initServerRouter/initServerRouter.vi.mdx +20 -0
- package/src/media/functional/nitro-basic/functions/initServerStorage/initServerStorage.en.mdx +16 -0
- package/src/media/functional/nitro-basic/functions/initServerStorage/initServerStorage.ru.mdx +16 -0
- package/src/media/functional/nitro-basic/functions/initServerStorage/initServerStorage.vi.mdx +16 -0
- package/src/media/functional/nitro-basic/functions/initSsrApp/initSsrApp.en.mdx +20 -0
- package/src/media/functional/nitro-basic/functions/initSsrApp/initSsrApp.ru.mdx +20 -0
- package/src/media/functional/nitro-basic/functions/initSsrApp/initSsrApp.vi.mdx +20 -0
- package/src/media/functional/nitro-basic/functions/uiBootstrapClient/uiBootstrapClient.en.mdx +14 -0
- package/src/media/functional/nitro-basic/functions/uiBootstrapClient/uiBootstrapClient.ru.mdx +14 -0
- package/src/media/functional/nitro-basic/functions/uiBootstrapClient/uiBootstrapClient.vi.mdx +14 -0
- package/src/media/functional/nitro-basic/functions/uiBootstrapServer/uiBootstrapServer.en.mdx +19 -0
- package/src/media/functional/nitro-basic/functions/uiBootstrapServer/uiBootstrapServer.ru.mdx +19 -0
- package/src/media/functional/nitro-basic/functions/uiBootstrapServer/uiBootstrapServer.vi.mdx +19 -0
- package/src/media/functional/nitro-basic/functions/uiCookieStorage/uiCookieStorage.en.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiCookieStorage/uiCookieStorage.ru.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiCookieStorage/uiCookieStorage.vi.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiCreateApp/uiCreateApp.en.mdx +43 -0
- package/src/media/functional/nitro-basic/functions/uiCreateApp/uiCreateApp.ru.mdx +43 -0
- package/src/media/functional/nitro-basic/functions/uiCreateApp/uiCreateApp.vi.mdx +43 -0
- package/src/media/functional/nitro-basic/functions/uiCreateClientApp/uiCreateClientApp.en.mdx +31 -0
- package/src/media/functional/nitro-basic/functions/uiCreateClientApp/uiCreateClientApp.ru.mdx +31 -0
- package/src/media/functional/nitro-basic/functions/uiCreateClientApp/uiCreateClientApp.vi.mdx +31 -0
- package/src/media/functional/nitro-basic/functions/uiCreateServerApp/uiCreateServerApp.en.mdx +34 -0
- package/src/media/functional/nitro-basic/functions/uiCreateServerApp/uiCreateServerApp.ru.mdx +34 -0
- package/src/media/functional/nitro-basic/functions/uiCreateServerApp/uiCreateServerApp.vi.mdx +34 -0
- package/src/media/functional/nitro-basic/functions/uiCreateSsrRouter/uiCreateSsrRouter.en.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/uiCreateSsrRouter/uiCreateSsrRouter.ru.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/uiCreateSsrRouter/uiCreateSsrRouter.vi.mdx +17 -0
- package/src/media/functional/nitro-basic/functions/uiId/uiId.en.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiId/uiId.ru.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiId/uiId.vi.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiServerStorage/uiServerStorage.en.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiServerStorage/uiServerStorage.ru.mdx +13 -0
- package/src/media/functional/nitro-basic/functions/uiServerStorage/uiServerStorage.vi.mdx +13 -0
- package/src/media/functional/nitro-basic/setup/setup.en.mdx +133 -0
- package/src/media/functional/nitro-basic/setup/setup.ru.mdx +133 -0
- package/src/media/functional/nitro-basic/setup/setup.vi.mdx +133 -0
- package/src/media/functional/nitro-basic/functions/getInject.en.mdx +0 -27
- package/src/media/functional/nitro-basic/functions/getInject.ru.mdx +0 -27
- package/src/media/functional/nitro-basic/functions/getInject.vi.mdx +0 -20
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initCookieStorage - Khởi tạo bộ lưu trữ Cookie'/>
|
|
4
|
+
|
|
5
|
+
# `initCookieStorage`
|
|
6
|
+
|
|
7
|
+
Hàm để khởi tạo bộ lưu trữ cookie trong ứng dụng Vue. Nó trích xuất chuỗi `Cookie` từ yêu cầu HTTP và cung cấp nó thông qua cơ chế `provide` bằng khóa `NITRO_APP_COOKIE`. Điều này cho phép các thành phần và composables truy cập cookie trong quá trình render phía server.
|
|
8
|
+
|
|
9
|
+
**Tham số:**
|
|
10
|
+
- `app: App<T>` — Thực thể ứng dụng Vue.
|
|
11
|
+
- `request: Request` — Đối tượng yêu cầu HTTP.
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { initCookieStorage } from '@dxtmisha/nitro-basic'
|
|
15
|
+
|
|
16
|
+
// Trong một handler server
|
|
17
|
+
initCookieStorage(app, request)
|
|
18
|
+
```
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/initHeaders - API Headers Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `initHeaders`
|
|
6
|
+
|
|
7
|
+
Initializes standard API headers and provides them to the Vue application via the `provide` mechanism with the `NITRO_API_HEADERS` key. By default, it sets the `Content-Type` header to `text/html;charset=UTF-8`.
|
|
8
|
+
|
|
9
|
+
**Parameters:**
|
|
10
|
+
- `app: App<T>` — The Vue application instance.
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initHeaders } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
initHeaders(app)
|
|
16
|
+
```
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/initHeaders - Инициализация заголовков API'/>
|
|
4
|
+
|
|
5
|
+
# `initHeaders`
|
|
6
|
+
|
|
7
|
+
Инициализирует стандартные заголовки API и предоставляет их приложению Vue через механизм `provide` с ключом `NITRO_API_HEADERS`. По умолчанию устанавливает заголовок `Content-Type` в значение `text/html;charset=UTF-8`.
|
|
8
|
+
|
|
9
|
+
**Параметры:**
|
|
10
|
+
- `app: App<T>` — Экземпляр приложения Vue.
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initHeaders } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
initHeaders(app)
|
|
16
|
+
```
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initHeaders - Khởi tạo Header API'/>
|
|
4
|
+
|
|
5
|
+
# `initHeaders`
|
|
6
|
+
|
|
7
|
+
Khởi tạo các header API tiêu chuẩn và cung cấp chúng cho ứng dụng Vue thông qua cơ chế `provide` với khóa `NITRO_API_HEADERS`. Theo mặc định, nó thiết lập header `Content-Type` thành `text/html;charset=UTF-8`.
|
|
8
|
+
|
|
9
|
+
**Tham số:**
|
|
10
|
+
- `app: App<T>` — Thực thể ứng dụng Vue.
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initHeaders } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
initHeaders(app)
|
|
16
|
+
```
|
package/src/media/functional/nitro-basic/functions/initPluginApiCache/initPluginApiCache.en.mdx
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/initPluginApiCache - API Cache Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `initPluginApiCache`
|
|
6
|
+
|
|
7
|
+
A function to configure and initialize the API caching system. It uses Nitro's built-in storage (`useStorage`) to save, retrieve, and remove cache items. It also includes error handling via `ErrorCenter`.
|
|
8
|
+
|
|
9
|
+
**Parameters:**
|
|
10
|
+
- `storageKey: string` (default `'Ui_ApiCache'`) — The key prefix for Nitro storage.
|
|
11
|
+
- `cacheStepAgeClearOld?: number` — The cache age threshold for automatically clearing outdated data.
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { initPluginApiCache } from '@dxtmisha/nitro-basic'
|
|
15
|
+
|
|
16
|
+
initPluginApiCache('my-custom-cache', 3600)
|
|
17
|
+
```
|
package/src/media/functional/nitro-basic/functions/initPluginApiCache/initPluginApiCache.ru.mdx
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/initPluginApiCache - Инициализация кэша API'/>
|
|
4
|
+
|
|
5
|
+
# `initPluginApiCache`
|
|
6
|
+
|
|
7
|
+
Функция для настройки и инициализации системы кэширования API. Она использует встроенное хранилище Nitro (`useStorage`) для сохранения, получения и удаления элементов кэша. Также включает обработку ошибок через `ErrorCenter`.
|
|
8
|
+
|
|
9
|
+
**Параметры:**
|
|
10
|
+
- `storageKey: string` (по умолчанию `'Ui_ApiCache'`) — Префикс ключа для хранилища Nitro.
|
|
11
|
+
- `cacheStepAgeClearOld?: number` — Порог возраста кэша для автоматической очистки устаревших данных.
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { initPluginApiCache } from '@dxtmisha/nitro-basic'
|
|
15
|
+
|
|
16
|
+
initPluginApiCache('my-custom-cache', 3600)
|
|
17
|
+
```
|
package/src/media/functional/nitro-basic/functions/initPluginApiCache/initPluginApiCache.vi.mdx
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initPluginApiCache - Khởi tạo bộ nhớ đệm API'/>
|
|
4
|
+
|
|
5
|
+
# `initPluginApiCache`
|
|
6
|
+
|
|
7
|
+
Một hàm để cấu hình và khởi tạo hệ thống lưu trữ đệm API. Nó sử dụng bộ lưu trữ tích hợp của Nitro (`useStorage`) để lưu, lấy và xóa các mục trong bộ nhớ đệm. Nó cũng bao gồm việc xử lý lỗi thông qua `ErrorCenter`.
|
|
8
|
+
|
|
9
|
+
**Tham số:**
|
|
10
|
+
- `storageKey: string` (mặc định `'Ui_ApiCache'`) — Tiền tố khóa cho bộ lưu trữ Nitro.
|
|
11
|
+
- `cacheStepAgeClearOld?: number` — Ngưỡng tuổi của bộ nhớ đệm để tự động xóa dữ liệu cũ.
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { initPluginApiCache } from '@dxtmisha/nitro-basic'
|
|
15
|
+
|
|
16
|
+
initPluginApiCache('my-custom-cache', 3600)
|
|
17
|
+
```
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/initPluginBasic - Basic Nitro Plugin Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `initPluginBasic`
|
|
6
|
+
|
|
7
|
+
An initialization function for basic capabilities in a Nitro application. Currently, it is primarily responsible for configuring the API cache using the provided configuration.
|
|
8
|
+
|
|
9
|
+
**Parameters:**
|
|
10
|
+
- `_ : NitroApp` — The Nitro application instance.
|
|
11
|
+
- `config: NitroAppBasicConfig` — The configuration object.
|
|
12
|
+
|
|
13
|
+
## Types
|
|
14
|
+
|
|
15
|
+
### NitroAppBasicConfig
|
|
16
|
+
|
|
17
|
+
- `api?: object` — API settings.
|
|
18
|
+
- `cacheStorageKey: string` — the key prefix to be used in Nitro storage for the cache (default `Ui_ApiCache`).
|
|
19
|
+
- `cacheStepAgeClearOld: number` — the cache age threshold after which old entries will be removed.
|
|
20
|
+
|
|
21
|
+
**Usage Example:**
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
import { initPluginBasic } from '@dxtmisha/nitro-basic'
|
|
25
|
+
|
|
26
|
+
export default defineNitroPlugin((nitroApp) => {
|
|
27
|
+
initPluginBasic(nitroApp, {
|
|
28
|
+
api: {
|
|
29
|
+
cacheStorageKey: 'my_app_cache',
|
|
30
|
+
cacheStepAgeClearOld: 3600000 // 1 hour
|
|
31
|
+
}
|
|
32
|
+
})
|
|
33
|
+
})
|
|
34
|
+
```
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/initPluginBasic - Инициализация базового плагина Nitro'/>
|
|
4
|
+
|
|
5
|
+
# `initPluginBasic`
|
|
6
|
+
|
|
7
|
+
Функция инициализации базовых возможностей для Nitro-приложения. В настоящее время она в основном отвечает за настройку кэша API, используя переданную конфигурацию.
|
|
8
|
+
|
|
9
|
+
**Параметры:**
|
|
10
|
+
- `_ : NitroApp` — Экземпляр приложения Nitro.
|
|
11
|
+
- `config: NitroAppBasicConfig` — Объект конфигурации.
|
|
12
|
+
|
|
13
|
+
## Типы
|
|
14
|
+
|
|
15
|
+
### NitroAppBasicConfig
|
|
16
|
+
|
|
17
|
+
- `api?: object` — Настройки API.
|
|
18
|
+
- `cacheStorageKey: string` — префикс ключа, который будет использоваться в хранилище Nitro для кэша (по умолчанию `Ui_ApiCache`).
|
|
19
|
+
- `cacheStepAgeClearOld: number` — порог возраста кэша, после которого старые записи будут удалены.
|
|
20
|
+
|
|
21
|
+
**Пример использования:**
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
import { initPluginBasic } from '@dxtmisha/nitro-basic'
|
|
25
|
+
|
|
26
|
+
export default defineNitroPlugin((nitroApp) => {
|
|
27
|
+
initPluginBasic(nitroApp, {
|
|
28
|
+
api: {
|
|
29
|
+
cacheStorageKey: 'my_app_cache',
|
|
30
|
+
cacheStepAgeClearOld: 3600000 // 1 час
|
|
31
|
+
}
|
|
32
|
+
})
|
|
33
|
+
})
|
|
34
|
+
```
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initPluginBasic - Khởi tạo Plugin Nitro cơ bản'/>
|
|
4
|
+
|
|
5
|
+
# `initPluginBasic`
|
|
6
|
+
|
|
7
|
+
Một hàm khởi tạo cho các khả năng cơ bản trong ứng dụng Nitro. Hiện tại, nó chịu trách nhiệm chính trong việc cấu hình bộ nhớ đệm API bằng cách sử dụng cấu hình được cung cấp.
|
|
8
|
+
|
|
9
|
+
**Tham số:**
|
|
10
|
+
- `_ : NitroApp` — Thực thể ứng dụng Nitro.
|
|
11
|
+
- `config: NitroAppBasicConfig` — Đối tượng cấu hình.
|
|
12
|
+
|
|
13
|
+
## Các kiểu
|
|
14
|
+
|
|
15
|
+
### NitroAppBasicConfig
|
|
16
|
+
|
|
17
|
+
- `api?: object` — Cài đặt API.
|
|
18
|
+
- `cacheStorageKey: string` — tiền tố khóa sẽ được sử dụng trong bộ lưu trữ Nitro cho bộ nhớ đệm (mặc định `Ui_ApiCache`).
|
|
19
|
+
- `cacheStepAgeClearOld: number` — ngưỡng tuổi của bộ nhớ đệm mà sau đó các mục cũ sẽ bị xóa.
|
|
20
|
+
|
|
21
|
+
**Ví dụ sử dụng:**
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
import { initPluginBasic } from '@dxtmisha/nitro-basic'
|
|
25
|
+
|
|
26
|
+
export default defineNitroPlugin((nitroApp) => {
|
|
27
|
+
initPluginBasic(nitroApp, {
|
|
28
|
+
api: {
|
|
29
|
+
cacheStorageKey: 'my_app_cache',
|
|
30
|
+
cacheStepAgeClearOld: 3600000 // 1 giờ
|
|
31
|
+
}
|
|
32
|
+
})
|
|
33
|
+
})
|
|
34
|
+
```
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/initScriptsJson - Hydration Scripts Generation'/>
|
|
4
|
+
|
|
5
|
+
# `initScriptsJson`
|
|
6
|
+
|
|
7
|
+
A function to generate the JSON scripts required for data hydration on the client side. It collects the current state from `ServerStorage` and `Api` hydration data, combining them into a single string of HTML scripts.
|
|
8
|
+
|
|
9
|
+
**Returns:**
|
|
10
|
+
`string` — A string containing JSON scripts (e.g., `<script type="application/json">...</script>`).
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initScriptsJson } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
const hydrationScripts = initScriptsJson()
|
|
16
|
+
// Insert hydrationScripts into your HTML template before the closing </body> tag
|
|
17
|
+
```
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/initScriptsJson - Генерация скриптов гидратации'/>
|
|
4
|
+
|
|
5
|
+
# `initScriptsJson`
|
|
6
|
+
|
|
7
|
+
Функция для генерации JSON-скриптов, необходимых для гидратации данных на стороне клиента. Она собирает текущее состояние из `ServerStorage` и данные гидратации `Api`, объединяя их в одну строку HTML-скриптов.
|
|
8
|
+
|
|
9
|
+
**Возвращает:**
|
|
10
|
+
`string` — Строка со скриптами JSON (например, `<script type="application/json">...</script>`).
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initScriptsJson } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
const hydrationScripts = initScriptsJson()
|
|
16
|
+
// Вставьте hydrationScripts в ваш HTML шаблон перед закрывающим тегом </body>
|
|
17
|
+
```
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initScriptsJson - Tạo kịch bản Hydrat hóa'/>
|
|
4
|
+
|
|
5
|
+
# `initScriptsJson`
|
|
6
|
+
|
|
7
|
+
Một hàm để tạo các kịch bản JSON cần thiết cho việc hydrat hóa dữ liệu ở phía client. Nó thu thập trạng thái hiện tại từ `ServerStorage` và dữ liệu hydrat hóa của `Api`, kết hợp chúng thành một chuỗi duy nhất của các script HTML.
|
|
8
|
+
|
|
9
|
+
**Trả về:**
|
|
10
|
+
`string` — Một chuỗi chứa các script JSON (ví dụ: `<script type="application/json">...</script>`).
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initScriptsJson } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
const hydrationScripts = initScriptsJson()
|
|
16
|
+
// Chèn hydrationScripts vào template HTML của bạn trước thẻ đóng </body>
|
|
17
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/initServerRouter - Server Router Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `initServerRouter`
|
|
6
|
+
|
|
7
|
+
An asynchronous function to initialize the Vue router during server-side rendering. It pushes the router to the current request URL and waits for it to be ready.
|
|
8
|
+
|
|
9
|
+
**Parameters:**
|
|
10
|
+
- `request: Request` — The HTTP request object.
|
|
11
|
+
- `router: Router | undefined` — The Vue Router instance.
|
|
12
|
+
|
|
13
|
+
**Returns:**
|
|
14
|
+
`Promise<void>`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
import { initServerRouter } from '@dxtmisha/nitro-basic'
|
|
18
|
+
|
|
19
|
+
await initServerRouter(request, router)
|
|
20
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/initServerRouter - Инициализация роутера на сервере'/>
|
|
4
|
+
|
|
5
|
+
# `initServerRouter`
|
|
6
|
+
|
|
7
|
+
Асинхронная функция для инициализации маршрутизатора Vue во время серверного рендеринга. Она переключает роутер на текущий URL запроса и ожидает его готовности.
|
|
8
|
+
|
|
9
|
+
**Параметры:**
|
|
10
|
+
- `request: Request` — Объект HTTP-запроса.
|
|
11
|
+
- `router: Router | undefined` — Экземпляр Vue Router.
|
|
12
|
+
|
|
13
|
+
**Возвращает:**
|
|
14
|
+
`Promise<void>`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
import { initServerRouter } from '@dxtmisha/nitro-basic'
|
|
18
|
+
|
|
19
|
+
await initServerRouter(request, router)
|
|
20
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initServerRouter - Khởi tạo Router trên Server'/>
|
|
4
|
+
|
|
5
|
+
# `initServerRouter`
|
|
6
|
+
|
|
7
|
+
Một hàm bất đối xứng để khởi tạo Vue router trong quá trình render phía server. Nó đẩy router đến URL yêu cầu hiện tại và đợi cho đến khi nó sẵn sàng.
|
|
8
|
+
|
|
9
|
+
**Tham số:**
|
|
10
|
+
- `request: Request` — Đối tượng yêu cầu HTTP.
|
|
11
|
+
- `router: Router | undefined` — Thực thể Vue Router.
|
|
12
|
+
|
|
13
|
+
**Trả về:**
|
|
14
|
+
`Promise<void>`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
import { initServerRouter } from '@dxtmisha/nitro-basic'
|
|
18
|
+
|
|
19
|
+
await initServerRouter(request, router)
|
|
20
|
+
```
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/initServerStorage - Server Storage Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `initServerStorage`
|
|
6
|
+
|
|
7
|
+
A function to initialize and inject server storage into a Vue application. It provides an empty state object via the `NITRO_APP_STORAGE` key, which can then be used to store data throughout the SSR cycle.
|
|
8
|
+
|
|
9
|
+
**Parameters:**
|
|
10
|
+
- `app: App<T>` — The Vue application instance.
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initServerStorage } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
initServerStorage(app)
|
|
16
|
+
```
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/initServerStorage - Инициализация серверного хранилища'/>
|
|
4
|
+
|
|
5
|
+
# `initServerStorage`
|
|
6
|
+
|
|
7
|
+
Функция для инициализации и внедрения серверного хранилища в приложение Vue. Она предоставляет пустой объект состояния через ключ `NITRO_APP_STORAGE`, который затем может использоваться для хранения данных на протяжении всего цикла SSR.
|
|
8
|
+
|
|
9
|
+
**Параметры:**
|
|
10
|
+
- `app: App<T>` — Экземпляр приложения Vue.
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initServerStorage } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
initServerStorage(app)
|
|
16
|
+
```
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initServerStorage - Khởi tạo bộ lưu trữ Server'/>
|
|
4
|
+
|
|
5
|
+
# `initServerStorage`
|
|
6
|
+
|
|
7
|
+
Một hàm để khởi tạo và cung cấp bộ lưu trữ server vào ứng dụng Vue. Nó cung cấp một đối tượng trạng thái trống thông qua khóa `NITRO_APP_STORAGE`, đối tượng này sau đó có thể được sử dụng để lưu trữ dữ liệu trong suốt chu kỳ SSR.
|
|
8
|
+
|
|
9
|
+
**Tham số:**
|
|
10
|
+
- `app: App<T>` — Thực thể ứng dụng Vue.
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
import { initServerStorage } from '@dxtmisha/nitro-basic'
|
|
14
|
+
|
|
15
|
+
initServerStorage(app)
|
|
16
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/initSsrApp - SSR App Rendering'/>
|
|
4
|
+
|
|
5
|
+
# `initSsrApp`
|
|
6
|
+
|
|
7
|
+
An asynchronous function that renders a Vue application to an HTML string and extracts additional context data (e.g., teleports). This is a core step in generating a server response.
|
|
8
|
+
|
|
9
|
+
**Parameters:**
|
|
10
|
+
- `app: App<T>` — The Vue application instance.
|
|
11
|
+
- `context: SSRContext` (default `{}`) — The server rendering context.
|
|
12
|
+
|
|
13
|
+
**Returns:**
|
|
14
|
+
`Promise<{ appHtml, teleportsHtml, context }>` — An object containing the application HTML, teleports HTML, and the updated context.
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
import { initSsrApp } from '@dxtmisha/nitro-basic'
|
|
18
|
+
|
|
19
|
+
const { appHtml, teleportsHtml } = await initSsrApp(app)
|
|
20
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/initSsrApp - Рендеринг SSR приложения'/>
|
|
4
|
+
|
|
5
|
+
# `initSsrApp`
|
|
6
|
+
|
|
7
|
+
Асинхронная функция, которая рендерит приложение Vue в HTML-строку и извлекает дополнительные данные контекста (например, телепорты). Это основной шаг при формировании ответа на сервере.
|
|
8
|
+
|
|
9
|
+
**Параметры:**
|
|
10
|
+
- `app: App<T>` — Экземпляр приложения Vue.
|
|
11
|
+
- `context: SSRContext` (по умолчанию `{}`) — Контекст рендеринга на сервере.
|
|
12
|
+
|
|
13
|
+
**Возвращает:**
|
|
14
|
+
`Promise<{ appHtml, teleportsHtml, context }>` — Объект, содержащий HTML приложения, HTML телепортов и обновленный контекст.
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
import { initSsrApp } from '@dxtmisha/nitro-basic'
|
|
18
|
+
|
|
19
|
+
const { appHtml, teleportsHtml } = await initSsrApp(app)
|
|
20
|
+
```
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/initSsrApp - Render ứng dụng SSR'/>
|
|
4
|
+
|
|
5
|
+
# `initSsrApp`
|
|
6
|
+
|
|
7
|
+
Một hàm bất đối xứng giúp render ứng dụng Vue thành một chuỗi HTML và trích xuất thêm dữ liệu ngữ cảnh (ví dụ: teleports). Đây là bước cốt lõi trong việc tạo phản hồi từ server.
|
|
8
|
+
|
|
9
|
+
**Tham số:**
|
|
10
|
+
- `app: App<T>` — Thực thể ứng dụng Vue.
|
|
11
|
+
- `context: SSRContext` (mặc định `{}`) — Ngữ cảnh render server.
|
|
12
|
+
|
|
13
|
+
**Trả về:**
|
|
14
|
+
`Promise<{ appHtml, teleportsHtml, context }>` — Một đối tượng chứa HTML của ứng dụng, HTML của teleports và ngữ cảnh đã được cập nhật.
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
import { initSsrApp } from '@dxtmisha/nitro-basic'
|
|
18
|
+
|
|
19
|
+
const { appHtml, teleportsHtml } = await initSsrApp(app)
|
|
20
|
+
```
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/uiBootstrapClient - Client ID Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `uiBootstrapClient`
|
|
6
|
+
|
|
7
|
+
Initializes the global unique identifier generator for elements on the client side. This function calls `uiId()` to ensure that ID generation is consistent with the Vue `useId` mechanism.
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { uiBootstrapClient } from '@dxtmisha/nitro-basic'
|
|
11
|
+
|
|
12
|
+
// Called during client bootstrap
|
|
13
|
+
uiBootstrapClient()
|
|
14
|
+
```
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/uiBootstrapClient - Клиентская инициализация ID'/>
|
|
4
|
+
|
|
5
|
+
# `uiBootstrapClient`
|
|
6
|
+
|
|
7
|
+
Инициализирует глобальный генератор уникальных идентификаторов для элементов на стороне клиента. Эта функция вызывает `uiId()`, чтобы гарантировать, что генерация идентификаторов будет согласована с механизмом Vue `useId`.
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { uiBootstrapClient } from '@dxtmisha/nitro-basic'
|
|
11
|
+
|
|
12
|
+
// Вызывается при запуске клиента
|
|
13
|
+
uiBootstrapClient()
|
|
14
|
+
```
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/uiBootstrapClient - Khởi tạo ID phía Client'/>
|
|
4
|
+
|
|
5
|
+
# `uiBootstrapClient`
|
|
6
|
+
|
|
7
|
+
Khởi tạo trình tạo định danh duy nhất toàn cục cho các thành phần ở phía client. Hàm này gọi `uiId()` để đảm bảo rằng việc tạo ID sẽ nhất quán với cơ chế `useId` của Vue.
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { uiBootstrapClient } from '@dxtmisha/nitro-basic'
|
|
11
|
+
|
|
12
|
+
// Được gọi trong quá trình khởi động client
|
|
13
|
+
uiBootstrapClient()
|
|
14
|
+
```
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/uiBootstrapServer - Server Component Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `uiBootstrapServer`
|
|
6
|
+
|
|
7
|
+
Orchestrates the global initialization of core components in a server environment. It prepares the server for handling requests by configuring cookie storage, server storage, and the unique identifier generator.
|
|
8
|
+
|
|
9
|
+
This function sequentially calls:
|
|
10
|
+
1. `uiCookieStorage()`
|
|
11
|
+
2. `uiServerStorage()`
|
|
12
|
+
3. `uiId()`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
import { uiBootstrapServer } from '@dxtmisha/nitro-basic'
|
|
16
|
+
|
|
17
|
+
// Called during server bootstrap
|
|
18
|
+
uiBootstrapServer()
|
|
19
|
+
```
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/uiBootstrapServer - Серверная инициализация компонентов'/>
|
|
4
|
+
|
|
5
|
+
# `uiBootstrapServer`
|
|
6
|
+
|
|
7
|
+
Координирует глобальную инициализацию базовых компонентов в серверной среде. Она подготавливает сервер к обработке запросов, настраивая хранилище cookie, серверное хранилище и генератор уникальных идентификаторов.
|
|
8
|
+
|
|
9
|
+
Эта функция последовательно вызывает:
|
|
10
|
+
1. `uiCookieStorage()`
|
|
11
|
+
2. `uiServerStorage()`
|
|
12
|
+
3. `uiId()`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
import { uiBootstrapServer } from '@dxtmisha/nitro-basic'
|
|
16
|
+
|
|
17
|
+
// Вызывается при запуске сервера
|
|
18
|
+
uiBootstrapServer()
|
|
19
|
+
```
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/uiBootstrapServer - Khởi tạo thành phần phía Server'/>
|
|
4
|
+
|
|
5
|
+
# `uiBootstrapServer`
|
|
6
|
+
|
|
7
|
+
Điều phối việc khởi tạo toàn cục các thành phần cốt lõi trong môi trường server. Nó chuẩn bị cho server xử lý các yêu cầu bằng cách cấu hình bộ lưu trữ cookie, bộ lưu trữ server và trình tạo định danh duy nhất.
|
|
8
|
+
|
|
9
|
+
Hàm này gọi tuần tự:
|
|
10
|
+
1. `uiCookieStorage()`
|
|
11
|
+
2. `uiServerStorage()`
|
|
12
|
+
3. `uiId()`
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
import { uiBootstrapServer } from '@dxtmisha/nitro-basic'
|
|
16
|
+
|
|
17
|
+
// Được gọi trong quá trình khởi động server
|
|
18
|
+
uiBootstrapServer()
|
|
19
|
+
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/en/nitro-basic/Functions/uiCookieStorage - CookieStorage Initialization'/>
|
|
4
|
+
|
|
5
|
+
# `uiCookieStorage`
|
|
6
|
+
|
|
7
|
+
Configures the global `CookieStorage` object by linking it to the Nitro application context. It sets up listeners to retrieve cookies from the current request and write them to the response headers (`Set-Cookie`) using the `useHeaders` composable.
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { uiCookieStorage } from '@dxtmisha/nitro-basic'
|
|
11
|
+
|
|
12
|
+
uiCookieStorage()
|
|
13
|
+
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/ru/nitro-basic/Functions/uiCookieStorage - Инициализация CookieStorage'/>
|
|
4
|
+
|
|
5
|
+
# `uiCookieStorage`
|
|
6
|
+
|
|
7
|
+
Настраивает глобальный объект `CookieStorage`, связывая его с контекстом приложения Nitro. Она устанавливает слушатели для получения cookie из текущего запроса и записи их в заголовки ответа (`Set-Cookie`) с помощью композитной функции `useHeaders`.
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { uiCookieStorage } from '@dxtmisha/nitro-basic'
|
|
11
|
+
|
|
12
|
+
uiCookieStorage()
|
|
13
|
+
```
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Meta } from '@storybook/addon-docs/blocks'
|
|
2
|
+
|
|
3
|
+
<Meta title='@dxtmisha/vi/nitro-basic/Functions/uiCookieStorage - Khởi tạo CookieStorage'/>
|
|
4
|
+
|
|
5
|
+
# `uiCookieStorage`
|
|
6
|
+
|
|
7
|
+
Cấu hình đối tượng `CookieStorage` toàn cục bằng cách liên kết nó với ngữ cảnh ứng dụng Nitro. Nó thiết lập các listener để lấy cookie từ yêu cầu hiện tại và ghi chúng vào các header phản hồi (`Set-Cookie`) bằng cách sử dụng composable `useHeaders`.
|
|
8
|
+
|
|
9
|
+
```typescript
|
|
10
|
+
import { uiCookieStorage } from '@dxtmisha/nitro-basic'
|
|
11
|
+
|
|
12
|
+
uiCookieStorage()
|
|
13
|
+
```
|