@intlayer/docs 9.4.0-canary.0 → 9.4.1

package/docs/vi/intlayer_with_vite+lit.md

@@ -109,6 +109,8 @@ Không chỉ là giải pháp i18n, Intlayer còn cung cấp **[trình chỉnh s
 
 ---
 
+Xem [Application Template](https://github.com/aymericzip/intlayer-vite-lit-template) trên GitHub.
+
 ## Hướng dẫn từng bước để thiết lập Intlayer trong ứng dụng Vite và Lit
 
 <Steps>
@@ -478,6 +480,8 @@ export class MyElement extends LitElement {
 
 > Lưu ý rằng để sử dụng `intlayerProxy` trong môi trường production, bạn cần chuyển `vite-intlayer` từ `devDependencies` sang `dependencies`.
 
+> Kể từ Intlayer v9, `intlayerProxy()` được đóng gói trực tiếp vào plugin `intlayer()` và được bật theo mặc định thông qua tùy chọn `routing.enableProxy` (`true` theo mặc định). Đăng ký nó riêng biệt như được hiển thị dưới đây bây giờ là tùy chọn — nó được giữ lại để tương thích ngược và cho các setup cần kiểm soát thứ tự plugin. Đặt `routing.enableProxy: false` để từ chối. Xem [ghi chú phát hành v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/vi/intlayer_with_vite+preact.md

@@ -173,10 +173,6 @@ bun add vite-intlayer --dev
 
   Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md), biên dịch và [lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md).
 
-- **preact-intlayer**
-
-  Gói tích hợp Intlayer với ứng dụng Preact. Nó cung cấp các context provider và hook cho việc quốc tế hóa trong Preact.
-
 - **vite-intlayer**
 
   Bao gồm plugin Vite để tích hợp Intlayer với [Vite bundler](https://vite.dev/guide/why.html#why-bundle-for-production), cũng như middleware để phát hiện ngôn ngữ ưu tiên của người dùng, quản lý cookie và xử lý chuyển hướng URL.
@@ -519,6 +515,24 @@ const App: FunctionalComponent = () => (
 export default App;
 ```
 
+```typescript {3,7} fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+import preact from "@preact/preset-vite";
+
+// https://vitejs.dev/config/
+export default defineConfig({
+  plugins: [
+    preact(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
+});
+```
+
 </Step>
 
 <Step number={8} title="Thay đổi URL khi ngôn ngữ thay đổi" isOptional={true}>
@@ -595,6 +609,10 @@ export default LocaleSwitcher;
 >
 > > - [Hook `useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/react-intlayer/useLocale.md) (API tương tự cho `preact-intlayer`)> - [Hook `getLocaleName`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getLocaleName.md)> - [Hook `getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getLocalizedUrl.md)> - [Hook `getHTMLTextDir`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/intlayer/getHTMLTextDir.md)> - [Thuộc tính `hreflang`](https://developers.google.com/search/docs/specialty/international/localized-versions?hl=fr)> - [Thuộc tính `lang`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)> - [Thuộc tính `dir`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/dir)> - [Thuộc tính `aria-current`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current)> - [Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API)
 
+Dưới đây là **Bước 9** được cập nhật với các giải thích bổ sung và các ví dụ mã được tinh chỉnh:
+
+---
+
 </Step>
 
 <Step number={9} title="Chuyển đổi thuộc tính ngôn ngữ và hướng của HTML" isOptional={true}>
@@ -664,6 +682,12 @@ const App: FunctionalComponent = () => (
 export default App;
 ```
 
+Bằng cách áp dụng những thay đổi này, ứng dụng của bạn sẽ:
+
+- Đảm bảo thuộc tính **language** (`lang`) phản ánh chính xác locale hiện tại, điều này rất quan trọng cho SEO và hành vi của trình duyệt.
+- Điều chỉnh **text direction** (`dir`) theo locale, nâng cao khả năng đọc và sử dụng cho các ngôn ngữ có thứ tự đọc khác nhau.
+- Cung cấp trải nghiệm **accessible** tốt hơn, vì các công nghệ hỗ trợ phụ thuộc vào các thuộc tính này để hoạt động tối ưu.
+
 </Step>
 
 <Step number={10} title="Tạo thành phần liên kết cục bộ" isOptional={true}>

package/docs/vi/intlayer_with_vite+react.md

@@ -168,9 +168,7 @@ bun add intlayer react-intlayer
 bun add vite-intlayer --dev
 ```
 
-- **intlayer**
-
-  Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md).
+Gói cốt lõi cung cấp các công cụ quốc tế hóa cho quản lý cấu hình, dịch thuật, [khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dictionary/content_file.md), biên dịch lại, và [các lệnh CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md).
 
 - **react-intlayer**
   Gói tích hợp Intlayer với ứng dụng React. Nó cung cấp các context provider và hook cho việc quốc tế hóa trong React.
@@ -511,6 +509,8 @@ Song song đó, bạn cũng có thể sử dụng `intlayerProxy` để thêm ro
 
 > Lưu ý rằng để sử dụng `intlayerProxy` trong môi trường production, bạn cần chuyển gói `vite-intlayer` từ `devDependencies` sang `dependencies`.
 
+> Kể từ Intlayer v9, `intlayerProxy()` được đóng gói trực tiếp vào plugin `intlayer()` và được bật mặc định thông qua tùy chọn `routing.enableProxy` (`true` theo mặc định). Đăng ký nó riêng biệt như được hiển thị dưới đây hiện đã tùy chọn — nó được giữ lại để tương thích ngược và cho các thiết lập cần kiểm soát thứ tự plugin. Đặt `routing.enableProxy: false` để từ chối. Xem [ghi chú phát hành v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
@@ -765,6 +765,8 @@ Link.displayName = "Link";
 Bằng cách tích hợp thành phần `Link` này trong toàn bộ ứng dụng của bạn, bạn duy trì trải nghiệm người dùng nhất quán và nhận biết ngôn ngữ đồng thời tận dụng được lợi ích từ SEO và khả năng sử dụng được cải thiện.
 </Step>
 
+</Step>
+
 <Step number={1} title="Trích xuất nội dung các thành phần của bạn" isOptional={true}>
 
 Nếu bạn có một cơ sở mã hiện có, việc chuyển đổi hàng nghìn tệp có thể tốn nhiều thời gian.

package/docs/vi/intlayer_with_vite+react_compiler.md

@@ -232,6 +232,8 @@ export default defineConfig({
 
 > Plugin Vite `intlayerCompiler()` được sử dụng để trích xuất nội dung từ component và ghi các tệp `.content`.
 
+> Kể từ Intlayer v9, trình compiler được đóng gói trực tiếp vào plugin `intlayer()` và kích hoạt tự động khi `compiler.enabled` được đặt với đường dẫn `compiler.output`. Đăng ký `intlayerCompiler()` riêng biệt như hình dưới đây hiện là tùy chọn — nó sẽ tự loại bỏ nếu cũng được thêm vào. Xem [ghi chú phát hành v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/releases/v9.md).
+
 </Step>
 
 <Step number={4} title="Biên dịch mã của bạn">

package/docs/vi/intlayer_with_vite+solid.md

@@ -46,6 +46,17 @@ author: aymericzip
   loading="lazy"
 />
 
+  </Tab>
+  <Tab label="Demo" value="demo">
+
+<iframe
+  src="https://intlayer-vite-solid.vercel.app"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Intlayer Vite + Solid Template"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
   </Tab>
 </Tabs>
 
@@ -53,10 +64,6 @@ author: aymericzip
 
 <TOC/>
 
-> Gói này đang trong quá trình phát triển. Xem [vấn đề](https://github.com/aymericzip/intlayer/issues/117) để biết thêm thông tin. Thể hiện sự quan tâm của bạn đến Intlayer cho Solid bằng cách thích vấn đề này
-
-<!-- Xem [Mẫu Ứng dụng](https://github.com/aymericzip/intlayer-solid-template) trên GitHub. -->
-
 ## Tại sao Intlayer thay thế các lựa chọn thay thế?
 
 So với các giải pháp chính như `@solid-primitives/i18n` hoặc `i18next`, Intlayer là giải pháp đi kèm với các tính năng tối ưu hóa tích hợp như:
@@ -242,8 +249,6 @@ export default appContent;
 
 > Các khai báo nội dung của bạn có thể được định nghĩa ở bất kỳ đâu trong ứng dụng của bạn miễn là chúng được đưa vào thư mục `contentDir` (mặc định là `./src`). Và phải phù hợp với phần mở rộng file khai báo nội dung (mặc định là `.content.{json,ts,tsx,js,jsx,mjs,cjs,md,mdx,yaml,yml}`).
 
-> Để biết thêm chi tiết, hãy tham khảo [tài liệu khai báo nội dung](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/content_file.md).
-
 </Step>
 
 <Step number={5} title="Sử dụng Intlayer trong Mã của Bạn">
@@ -491,29 +496,10 @@ export const Link: ParentComponent<AnchorProps> = (props) => {
 };
 ```
 
-</Step>
-
 <Step number={11} title="Render Markdown" isOptional={true}>
 
 Intlayer hỗ trợ render nội dung Markdown trực tiếp trong ứng dụng Solid của bạn bằng cách sử dụng trình phân tích cú pháp nội bộ riêng. Theo mặc định, Markdown được xử lý như văn bản thuần túy. Để render nó dưới dạng HTML phong phú, hãy bọc ứng dụng của bạn bằng `MarkdownProvider`.
 
-```tsx fileName="src/index.tsx"
-import { render } from "solid-js/web";
-import { MarkdownProvider } from "solid-intlayer/markdown";
-import App from "./App";
-
-const root = document.getElementById("root");
-
-render(
-  () => (
-    <MarkdownProvider>
-      <App />
-    </MarkdownProvider>
-  ),
-  root!
-);
-```
-
 Sau đó bạn có thể sử dụng nó trong các thành phần của mình:
 
 ```tsx
@@ -743,5 +729,3 @@ Nên bỏ qua các tệp được tạo bởi Intlayer. Điều này cho phép b
 ### Tiến xa hơn
 
 Để tiến xa hơn, bạn có thể triển khai [trình soạn thảo trực quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_visual_editor.md) hoặc tách nội dung của bạn ra bên ngoài bằng cách sử dụng [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md).
-
----

package/docs/vi/intlayer_with_vite+svelte.md

@@ -297,6 +297,8 @@ export default appContent;
 > Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
 ```
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md), cũng như [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md), để biến đổi hàng nghìn component chỉ trong một giây.
+
 </Step>
 
 <Step number={6} title="Thay đổi ngôn ngữ của nội dung" isOptional={true}>
@@ -455,6 +457,8 @@ Song song với đó, bạn cũng có thể sử dụng `intlayerProxy` để th
 
 > Lưu ý rằng để sử dụng `intlayerProxy` trong môi trường production, bạn cần chuyển gói `vite-intlayer` từ `devDependencies` sang `dependencies`.
 
+> Kể từ Intlayer v9, `intlayerProxy()` được gộp trực tiếp vào plugin `intlayer()` và được bật theo mặc định thông qua option `routing.enableProxy` (`true` theo mặc định). Đăng ký nó riêng biệt như được hiển thị bên dưới hiện là tùy chọn — nó được giữ lại để tương thích ngược và cho các thiết lập cần kiểm soát thứ tự plugin. Đặt `routing.enableProxy: false` để chọn không tham gia. Xem [ghi chú phát hành v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
@@ -513,6 +517,29 @@ const changeLocale = (event: Event) => {
 
 </Step>
 
+<Step number={9} title="Các Liên Kết Quốc Tế Hóa" isOptional={true}>
+
+Để tối ưu SEO, nên thêm tiền tố locale vào các routes của bạn (ví dụ: `/about`, `/fr/about`).
+
+```svelte fileName="src/lib/components/Link.svelte"
+<script lang="ts">
+  import { getLocalizedUrl } from "intlayer";
+  import { useLocale } from "svelte-intlayer";
+
+  export let href = "";
+  const { locale } = useLocale();
+
+  // Trợ giúp để thêm tiền tố URL
+  $: localizedHref = getLocalizedUrl(href, $locale);
+</script>
+
+<a href={localizedHref}>
+  <slot />
+</a>
+```
+
+</Step>
+
 <Step number={1} title="Trích xuất nội dung các thành phần của bạn" isOptional={true}>
 
 Nếu bạn có một cơ sở mã hiện có, việc chuyển đổi hàng nghìn tệp có thể tốn nhiều thời gian.

package/docs/vi/intlayer_with_vite+vanilla.md

@@ -470,6 +470,8 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 > Lưu ý rằng để sử dụng `intlayerProxy` trong môi trường production, bạn cần chuyển `vite-intlayer` từ `devDependencies` sang `dependencies`.
 
+> Kể từ Intlayer v9, `intlayerProxy()` được đóng gói trực tiếp vào plugin `intlayer()` và được bật theo mặc định thông qua tùy chọn `routing.enableProxy` (`true` theo mặc định). Đăng ký nó riêng biệt như hiển thị dưới đây hiện đã là tùy chọn — nó được giữ lại để tương thích ngược và cho các thiết lập cần kiểm soát thứ tự plugin. Đặt `routing.enableProxy: false` để từ chối. Xem [ghi chú phát hành v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { intlayer } from "vite-intlayer";

package/docs/vi/intlayer_with_vite+vue.md

@@ -368,6 +368,13 @@ app.use(intlayer);
 app.mount("#app");
 ```
 
+> Bạn cũng có thể gọi `installIntlayer(app)` trực tiếp dưới dạng một hàm nếu bạn muốn:
+>
+> ```javascript
+> import { intlayer } from "vue-intlayer";
+> app.use(intlayer);
+> ```
+
 Truy cập các từ điển nội dung của bạn trong toàn bộ ứng dụng bằng cách tạo một thành phần Vue chính và sử dụng các composable `useIntlayer`:
 
 ```vue fileName="src/HelloWord.vue"
@@ -421,6 +428,8 @@ const countRef = ref(0);
 </template>
 ```
 
+> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md), cũng như [extract command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md), để biến đổi hàng nghìn thành phần trong một giây.
+
 #### Truy cập Nội dung trong Intlayer
 
 Intlayer cung cấp các API khác nhau để truy cập nội dung của bạn:
@@ -439,8 +448,6 @@ Intlayer cung cấp các API khác nhau để truy cập nội dung của bạn:
   - Sử dụng `const content = useIntlayer("myContent");` và `{{ content.myContent }}` / `<content.myContent />`.
   - Hoặc sử dụng `const { myContent } = useIntlayer("myContent");` và `{{ myContent}}` / `<myContent/>` để phân rã nội dung.
 
-> Nếu ứng dụng của bạn đã tồn tại, bạn có thể sử dụng [Intlayer Compiler](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/compiler.md) kết hợp với [lệnh extract](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/extract.md) để chuyển đổi hàng nghìn component chỉ trong một giây.
-
 </Step>
 
 <Step number={6} title="Thay đổi ngôn ngữ của nội dung" isOptional={true}>
@@ -630,6 +637,8 @@ Song song đó, bạn cũng có thể sử dụng `intlayerProxy` để thêm ro
 
 > Lưu ý rằng để sử dụng `intlayerProxy` trong môi trường production, bạn cần chuyển gói `vite-intlayer` từ `devDependencies` sang `dependencies`.
 
+> Kể từ Intlayer v9, `intlayerProxy()` được gộp trực tiếp vào plugin `intlayer()` và được bật theo mặc định thông qua tùy chọn `routing.enableProxy` (`true` theo mặc định). Đăng ký nó riêng biệt như được hiển thị dưới đây hiện là tùy chọn — nó được giữ lại để tương thích ngược và cho các thiết lập cần kiểm soát thứ tự plugin. Đặt `routing.enableProxy: false` để từ chối. Xem [ghi chú phát hành v9](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/releases/v9.md).
+
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
@@ -1131,3 +1140,5 @@ Tiện ích mở rộng này cung cấp:
 ### Tiến xa hơn
 
 Để tiến xa hơn, bạn có thể triển khai [trình soạn thảo trực quan](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_visual_editor.md) hoặc tách nội dung của bạn ra ngoài bằng cách sử dụng [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_CMS.md).
+
+---

package/docs/vi/packages/elysia-intlayer/exports.md

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Tài liệu gói elysia-intlayer
+description: Plugin Elysia cho Intlayer, cung cấp các hàm dịch và phát hiện locale.
+keywords:
+  - elysia-intlayer
+  - elysia
+  - plugin
+  - internationalization
+  - i18n
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - exports
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Hợp nhất tài liệu cho tất cả các export"
+author: aymericzip
+---
+
+# Gói elysia-intlayer
+
+Gói `elysia-intlayer` cung cấp một plugin cho các ứng dụng Elysia để xử lý internationalization. Nó phát hiện locale của người dùng và tiêm một đối tượng `intlayer` vào route context.
+
+## Cài đặt
+
+```bash packageManager="npm"
+npm install intlayer elysia-intlayer
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer elysia-intlayer
+```
+
+```bash packageManager="yarn"
+yarn add intlayer elysia-intlayer
+```
+
+```bash packageManager="bun"
+bun add intlayer elysia-intlayer
+```
+
+> `elysia` là một peer dependency (`>=1.0.0`). Elysia nhắm tới runtime **Bun**.
+
+## Các export
+
+### Plugin
+
+Nhập:
+
+```ts
+import { intlayer } from "elysia-intlayer";
+```
+
+| Hàm        | Mô tả                                                                                                                                                                                                                                                                                                    | Tài liệu liên quan                                                                                             |
+| ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `intlayer` | Plugin Elysia tích hợp Intlayer vào ứng dụng Elysia của bạn. Xử lý phát hiện locale từ storage (cookies, headers) rồi từ `Accept-Language`, tiêm một đối tượng `intlayer` phơi bày `locale`, `t`, `getIntlayer` và `getDictionary` vào route context, và thiết lập ngữ cảnh request `AsyncLocalStorage`. | [intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/elysia-intlayer/intlayer.md) |
+
+### Hàm
+
+Nhập:
+
+```ts
+import { t, getIntlayer, getDictionary } from "elysia-intlayer";
+```
+
+| Hàm             | Mô tả                                                                                                                                                                                                                                                | Tài liệu liên quan                                                                                     |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `t`             | Hàm dịch toàn cục lấy nội dung cho locale hiện tại trong Elysia. Sử dụng `AsyncLocalStorage` để truy cập ngữ cảnh request do plugin `intlayer` thiết lập, và quay về locale mặc định khi ở ngoài ngữ cảnh đó. Cũng có thể truy cập qua `intlayer.t`. | [translation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/dictionary/translation.md) |
+| `getIntlayer`   | Lấy một dictionary theo key từ khai báo được sinh ra và trả về nội dung của nó cho locale hiện tại. Phiên bản tối ưu của `getDictionary`. Sử dụng `AsyncLocalStorage` để truy cập ngữ cảnh request. Cũng có thể truy cập qua `intlayer.getIntlayer`. | -                                                                                                      |
+| `getDictionary` | Xử lý các đối tượng dictionary và trả về nội dung cho locale hiện tại. Xử lý các bản dịch `t()`, enumeration, markdown, HTML, v.v. Sử dụng `AsyncLocalStorage` để truy cập ngữ cảnh request. Cũng có thể truy cập qua `intlayer.getDictionary`.      | -                                                                                                      |
+
+### Kiểu
+
+Nhập:
+
+```ts
+import type { IntlayerContext, TranslateFunction } from "elysia-intlayer";
+```
+
+| Kiểu                | Mô tả                                                                                                                                                                    |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `IntlayerContext`   | Hình dạng của đối tượng `intlayer` được tiêm vào mọi route context: `locale`, `locale_storage`, `locale_detected`, `defaultLocale`, `t`, `getIntlayer`, `getDictionary`. |
+| `TranslateFunction` | Chữ ký của hàm dịch, chuyển một locale map thành nội dung khớp với locale của request hiện tại.                                                                          |
+
+## Sử dụng
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { getDictionary, getIntlayer, intlayer, t } from "elysia-intlayer";
+import dictionaryExample from "./index.content";
+
+const app = new Elysia()
+  // Tải plugin quốc tế hóa
+  .use(intlayer())
+  // Đọc locale và các helper từ context của route
+  .get("/", ({ intlayer }) => ({
+    locale: intlayer!.locale,
+    greeting: intlayer!.t({
+      vi: "Xin chào",
+      en: "Hello",
+      fr: "Bonjour",
+      es: "Hola",
+    }),
+    content: intlayer!.getIntlayer("index").exampleOfContent,
+  }))
+  // Hoặc dùng các helper standalone, gắn với request hiện tại
+  .get("/t_example", () =>
+    t({
+      vi: "Ví dụ về nội dung được trả về bằng tiếng Việt",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      es: "Ejemplo de contenido devuelto en español",
+    })
+  )
+  .get("/getIntlayer_example", () => getIntlayer("index").exampleOfContent)
+  .get(
+    "/getDictionary_example",
+    () => getDictionary(dictionaryExample).exampleOfContent
+  )
+  .listen(3000);
+
+console.log(
+  `🦊 Elysia is running at ${app.server?.hostname}:${app.server?.port}`
+);
+```
+
+> Plugin đăng ký context của nó thông qua một `derive` **global**, được Elysia định kiểu là `Partial<{ intlayer: IntlayerContext }>`. Giá trị luôn tồn tại lúc runtime với các route được đăng ký sau `.use(intlayer())`, vì vậy hãy dùng non-null assertion (`intlayer!.locale`) — hoặc optional chaining — để thỏa mãn TypeScript ở chế độ `strict`.
+
+## Tài liệu liên quan
+
+- [Elysia i18n - Hướng dẫn đầy đủ để dịch ứng dụng của bạn](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_elysia.md)
+- [Cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)

package/docs/vi/packages/elysia-intlayer/intlayer.md

@@ -0,0 +1,139 @@
+---
+createdAt: 2026-08-24
+updatedAt: 2026-08-24
+title: Tài liệu Plugin intlayer cho Elysia | elysia-intlayer
+description: Xem cách sử dụng plugin intlayer của gói elysia-intlayer
+keywords:
+  - intlayer
+  - elysia
+  - plugin
+  - Intlayer
+  - Quốc tế hóa
+  - Tài liệu
+slugs:
+  - doc
+  - packages
+  - elysia-intlayer
+  - intlayer
+history:
+  - version: 9.4.0
+    date: 2026-08-24
+    changes: "Khởi tạo tài liệu"
+author: aymericzip
+---
+
+# Tài liệu Plugin intlayer cho Elysia
+
+Plugin `intlayer` cho Elysia phát hiện locale của người dùng và tiêm một đối tượng `intlayer` vào route context. Nó cũng cho phép sử dụng các hàm dịch toàn cục trong ngữ cảnh của request.
+
+## Sử dụng
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", ({ intlayer }) =>
+  intlayer!.t({
+    vi: "Xin chào",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+> Plugin đăng ký context của nó thông qua một `derive` **global**, được Elysia định kiểu là `Partial<{ intlayer: IntlayerContext }>`. Giá trị luôn tồn tại lúc runtime với các route được đăng ký sau `.use(intlayer())`, vì vậy hãy dùng non-null assertion (`intlayer!.t`) — hoặc optional chaining — để thỏa mãn TypeScript ở chế độ `strict`.
+
+Các helper tương tự cũng có sẵn dưới dạng các export độc lập, nên bạn có thể gọi chúng mà không cần destructure route context:
+
+```ts fileName="src/index.ts"
+import { Elysia } from "elysia";
+import { intlayer, t } from "elysia-intlayer";
+
+const app = new Elysia().use(intlayer()).get("/", () =>
+  t({
+    vi: "Xin chào",
+    en: "Hello",
+    fr: "Bonjour",
+    es: "Hola",
+  })
+);
+```
+
+## Mô tả
+
+Plugin thực hiện các nhiệm vụ sau:
+
+1. **Phát hiện locale**: Nó đọc locale được client thiết lập một cách tường minh từ storage (cookie, header), sau đó quay về locale được thương lượng từ header `Accept-Language`.
+2. **Tiêm vào ngữ cảnh**: Nó thêm thuộc tính `intlayer` vào context route của Elysia (xem bảng Context của route bên dưới).
+3. **Quản lý ngữ cảnh**: Nó sử dụng `AsyncLocalStorage` để quản lý ngữ cảnh bất đồng bộ, cho phép các hàm Intlayer toàn cục (`t`, `getIntlayer`, `getDictionary`) truy cập locale cụ thể của request mà không cần truyền đối tượng ngữ cảnh.
+4. **Chuẩn bị dictionary**: Nó gọi `prepareIntlayer` khi plugin được tạo, nhờ vậy dictionary được build khi ứng dụng khởi động.
+
+### Context của route
+
+| Thuộc tính        | Kiểu                   | Mô tả                                                                             |
+| ----------------- | ---------------------- | --------------------------------------------------------------------------------- |
+| `locale`          | `Locale`               | Locale dùng cho request này, `locale_storage` được ưu tiên hơn `locale_detected`. |
+| `locale_storage`  | `Locale` (tùy chọn)    | Locale được client yêu cầu tường minh qua cookie hoặc header.                     |
+| `locale_detected` | `Locale`               | Locale được thương lượng từ các header của request.                               |
+| `defaultLocale`   | `Locale`               | Locale được cấu hình làm fallback trong `intlayer.config.ts`.                     |
+| `t`               | `TranslateFunction`    | Một hàm dịch.                                                                     |
+| `getIntlayer`     | `typeof getIntlayer`   | Hàm để lấy dictionary theo key.                                                   |
+| `getDictionary`   | `typeof getDictionary` | Hàm để xử lý các đối tượng dictionary.                                            |
+
+> Không giống các plugin Intlayer dựa trên Node, `elysia-intlayer` dựa vào `AsyncLocalStorage` thay vì `cls-hooked`, bởi vì `cls-hooked` phụ thuộc vào `async_hooks.createHook`, thứ mà Bun không triển khai.
+
+Ngữ cảnh của request được giải phóng ngay khi response được map, nên các helper độc lập không bao giờ phân giải dựa trên một request đã kết thúc. Khi được gọi bên ngoài một request do plugin xử lý, chúng quay về locale mặc định đã được cấu hình.
+
+## Thứ tự phân giải locale
+
+Theo mặc định, plugin phân giải locale theo thứ tự sau:
+
+1. Cookie `INTLAYER_LOCALE`.
+2. Header `x-intlayer-locale`.
+3. Thương lượng qua header `Accept-Language`.
+4. `defaultLocale` đã được cấu hình.
+
+```bash
+# Được thương lượng từ `Accept-Language`
+curl -H "Accept-Language: fr" http://localhost:3000/
+# Bonjour
+
+# Cookie được ưu tiên hơn `Accept-Language`
+curl -H "Accept-Language: fr" -H "Cookie: INTLAYER_LOCALE=es" http://localhost:3000/
+# Hola
+
+# Header được ưu tiên hơn `Accept-Language`
+curl -H "Accept-Language: fr" -H "x-intlayer-locale: es" http://localhost:3000/
+# Hola
+```
+
+## Cấu hình
+
+Plugin đọc tệp `intlayer.config.ts` của bạn. Bạn có thể tùy chỉnh cookie và header dùng cho việc phát hiện locale:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  routing: {
+    storage: [
+      { type: "header", name: "my-locale-header" },
+      { type: "cookie", name: "my-locale-cookie" },
+    ],
+  },
+};
+
+export default config;
+```
+
+> Để biết thêm thông tin về cấu hình, hãy truy cập [tài liệu cấu hình](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md).
+
+## Tài liệu liên quan
+
+- [Tài liệu gói elysia-intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/packages/elysia-intlayer/exports.md)
+- [Elysia i18n - Hướng dẫn đầy đủ để dịch ứng dụng của bạn](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_with_elysia.md)