@intlayer/docs 8.12.4 → 9.0.0-canary.10

package/docs/zh/releases/v8.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-22
-updatedAt: 2026-01-26
+updatedAt: 2026-06-14
 title: Intlayer v8 新功能 - 有什么新变化？
 description: 了解 Intlayer v8 的新特性。在开发者体验、内容验证和字典管理方面带来重大改进。
 keywords:
@@ -17,6 +17,7 @@ slugs:
   - doc
   - releases
   - v8
+author: aymericzip
 ---
 
 # Intlayer v8 新功能 - 有什么新变化？
@@ -408,6 +409,16 @@ Intlayer v8 对富内容的处理方式进行了重大改进，引入了 **HTML
 
 ---
 
+## YAML & Markdown 内容文件 (v8.10.0)
+
+您现在可以直接使用 `.content.md` 和 `.content.yaml` 文件扩展名声明内容。这非常适合长篇内容、博客、文档和隐私政策。
+
+这些文件可以从可视化编辑器完全编辑，为非技术团队成员提供了简化的工作流程。
+
+有关更多详细信息，请参阅 [YAML 内容文件文档](https://intlayer.org/doc/concept/content#yaml-content-file) 和 [Markdown 内容文件文档](https://intlayer.org/doc/concept/content/markdown)。
+
+---
+
 ## 自定义 URL 重写
 
 Intlayer v8 引入对 **自定义 URL 重写** 的支持，允许你定义与标准 `/locale/path` 结构不同的特定语言路径。此功能可显著提升本地 SEO，并为非英文用户提供更自然的使用体验。
@@ -752,6 +763,62 @@ export default {
   </Tab>
 </Tabs>
 
+## Unicode CLDR 复数规则 (v8.8.0)
+
+基于 Unicode CLDR 项目定义的复数规则，引入了一个新的 `plural` 节点助手，改进了对复杂语言的支持。
+
+```typescript fileName="src/openings.content.ts"
+import { plural, t, type Dictionary } from "intlayer";
+
+const openingsContent = {
+  key: "total_openings",
+  content: {
+    totalOpenings: t({
+      zh: plural({
+        one: "{{count}} 个职位",
+        other: "{{count}} 个职位",
+      }),
+      en: plural({
+        one: "{{count}} opening",
+        other: "{{count}} openings",
+      }),
+      fr: plural({
+        one: "{{count}} offre",
+        other: "{{count}} offres",
+      }),
+    }),
+  },
+} satisfies Dictionary;
+
+export default openingsContent;
+```
+
+然后，你可以在你的框架组件中动态传递计数：
+
+```tsx
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const OpeningsComponent: FC<{ count: number }> = ({ count }) => {
+  const { totalOpenings } = useIntlayer("total_openings");
+
+  return (
+    <div>
+      {/* 英文:                                  */}
+      {/*  count=0  → "0 openings"   (other)           */}
+      {/*  count=1  → "1 opening"    (one)             */}
+      {/*  count=2  → "2 openings"   (other)           */}
+      {/*  count=21 → "21 openings"  (other)           */}
+      <p>{totalOpenings(count)}</p>
+    </div>
+  );
+};
+```
+
+更多信息，请参见 [复数化文档](https://intlayer.org/doc/concept/content/plural)。
+
+---
+
 ## 内容 Schema 验证
 
 Intlayer v8 为字典引入了 schema 验证。你现在可以在配置中使用 Zod 定义可重用的验证 schema，并将其应用到你的内容文件中。这可以确保你的内容始终遵循预期的结构，并在构建时 (build time)捕获错误。
@@ -796,6 +863,34 @@ export default aboutPageMetaContent;
 
 ---
 
+## TypeScript: IntlayerNode Primitive Accessors
+
+`IntlayerNode` 类型已更新，允许直接在内容节点上调用原始 JavaScript 方法。这使得可以直接与本地化内容交互，就像它是一个标准字符串、数字、布尔值或数组原始类型一样。
+
+支持 React、Preact、Solid、Svelte、Vue 和 Angular。
+
+### String 示例
+
+```typescript
+content.placeholder; // 返回 IntlayerNode<string>
+content.placeholder.value; // 返回 string
+content.placeholder.toString(); // 返回 string
+content.placeholder.toLowerCase(); // 返回 string
+String(content.placeholder); // 返回 string
+content.placeholder.toUpperCase(); // 返回大写字符串
+content.placeholder.replace("a", "b"); // 返回修改后的字符串
+```
+
+### Array Example
+
+```typescript
+content.myArrayOfString             // 返回 IntlayerNode<Array<string>>
+content.myArrayOfString.find(...)   // 返回元素
+content.myArrayOfString.join(', ')  // 返回连接的字符串
+```
+
+---
+
 ### 增强的自动内容检测
 
 在 v8 中，Intlayer 能智能检测内容字符串中的 Markdown 语法、HTML 标签和变量插入。这意味着通常可以省略像 `md()`、`html()` 或 `insert()` 这样的辅助函数。
@@ -1001,6 +1096,17 @@ Intlayer 的 VSCode 扩展在 v8 中迎来重大更新，以简化你的国际
 
 ---
 
+## 工具：C++ Watcher & OXC-based LSP (v8.12.0)
+
+Intlayer v8.12.0 为开发者体验带来了重大改进：
+
+- **Parcel Watcher**：内容监听器已从 `chokidar` 迁移到 `@parcel/watcher`，利用原生 C++ 文件监听来提供更快的更新和显著降低的内存消耗。
+- **新的语言服务器协议 (LSP)**：一个全新的 LSP 现已推出。采用基于 OXC 的解析构建，它帮助您的 IDE 和 AI 代理无缝链接 `useIntlayer('my-key')` 调用与其对应的 `.content` 文件，反之亦然。
+
+有关详细信息，请参阅 [LSP 文档](https://intlayer.org/doc/lsp)。
+
+---
+
 ## 编译器优化
 
 Intlayer v8 为 Markdown 和 HTML 编译器引入了新的缓存层。这确保在相同配置下相同的内容字符串只被解析一次，从而显著降低在重新渲染或在多个地方使用相同内容时的开销。
@@ -1056,6 +1162,48 @@ Intlayer v8 为 Markdown 和 HTML 编译器引入了新的缓存层。这确保
 
 ---
 
+## 实验性构建优化：代码缩小和清理 (v8.7.0)
+
+Intlayer v8.7.0 在你的 `intlayer.config.ts` 中引入了新的实验性构建功能，旨在优化你的生产包：
+
+- **字典缩小化**：缩小字典文件以减小大小。
+- **未使用密钥清理**：扫描并从字典中移除未使用的翻译密钥，将活跃密钥重命名为短字符（例如 `"products" -> "a"`、`"pricing" -> "b"`）。这可将包大小减少多达 5%。
+- **禁用 TypeScript 检查**：通过在编译步骤中禁用 TypeScript 类型检查来加快构建速度。
+
+```typescript fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    importMode: "dynamic",
+  },
+  build: {
+    /**
+     * 缩小字典以减少包大小。
+     */
+    minify: true,
+
+    /**
+     * 清理字典中的未使用密钥
+     */
+    purge: true,
+
+    /**
+     * 指示构建是否应检查 TypeScript 类型
+     */
+    checkTypes: false,
+  },
+};
+
+export default config;
+```
+
+---
+
 ## 灵活性：统一导入模式
 
 `live` 布尔属性已被弃用，改用更为全面的 `importMode` 属性。这样可以明确定义 dictionaries 应如何加载：静态、动态，或通过实时同步。
@@ -1203,6 +1351,49 @@ export default {
 
 ---
 
+## Angular 支持：Vite Bundler (v8.11.0)
+
+对于 Angular 用户，Intlayer 现在通过新的自定义 esbuild 插件原生支持 Vite bundler，加快了开发和构建时间。
+
+有关配置详情，请参阅 [Angular 环境文档](https://intlayer.org/doc/environment/angular)。
+
+---
+
+## 网站地图生成 (v8.6.0)
+
+Intlayer 现在根据您的语言环境和路由模式自动生成网站地图。这对于 TanStack Router 等路由架构中的 SEO 优化特别有用：
+
+```typescript fileName="src/routes/sitemap.xml.ts"
+import { createFileRoute } from "@tanstack/react-router";
+import { generateSitemap } from "intlayer";
+
+const SITE_URL = (
+  import.meta.env.VITE_SITE_URL ?? "http://localhost:3000"
+).replace(/\/$/, "");
+
+export const Route = createFileRoute("/sitemap.xml")({
+  server: {
+    handlers: {
+      GET: async () => {
+        const sitemap = generateSitemap(
+          [
+            { path: "/", changefreq: "daily", priority: 1.0 },
+            { path: "/about", changefreq: "monthly", priority: 0.8 },
+          ],
+          { siteUrl: SITE_URL }
+        );
+
+        return new Response(sitemap, {
+          headers: { "Content-Type": "application/xml" },
+        });
+      },
+    },
+  },
+});
+```
+
+---
+
 ## 从 v7 的迁移说明
 
 ### 配置更改

package/docs/zh/releases/v9.md

@@ -0,0 +1,312 @@
+---
+createdAt: 2026-06-14
+updatedAt: 2026-06-26
+title: New Intlayer v9 - What's new?
+description: Discover what's new in Intlayer v9. Introducing drop-in compatibility packages for popular i18n libraries and support for Collections and Variants.
+keywords:
+  - Intlayer
+  - Compatibility
+  - Migration
+  - Collections
+  - Variants
+  - i18next
+  - next-intl
+  - vue-i18n
+slugs:
+  - doc
+  - releases
+  - v9
+author: aymericzip
+---
+
+# New Intlayer v9 - What's new?
+
+Welcome to Intlayer v9! This major release marks a huge milestone in simplifying the migration path to Intlayer with **Compat Adapter Packages** for major i18n libraries (`react-i18next`, `next-intl`, `vue-i18n`, etc.) and adds support for rich content structures: **Collections** and **Variants**.
+
+## Table of contents
+
+<TOC levels={[2]} maxDepth={1} />
+
+---
+
+## Compat Adapter Packages
+
+Migrating to Intlayer from popular i18n libraries is now easier than ever. We have created five compat packages that expose the **exact same public APIs** as standard i18n libraries but delegate all translation work to Intlayer at runtime.
+
+### Expose Same Public API with Strict Typing
+
+By replacing imports, you get all the benefits of Intlayer (including compile-time type safety against your actual dictionaries) with minimal code changes:
+
+- `@intlayer/i18next`
+- `@intlayer/react-i18next`
+- `@intlayer/next-intl`
+- `@intlayer/react-intl`
+- `@intlayer/next-i18next`
+- `@intlayer/vue-i18n`
+- `@intlayer/lingui`
+
+For example, simply change:
+
+```ts
+import { useTranslation } from "react-i18next";
+```
+
+to:
+
+```ts
+import { useTranslation } from "@intlayer/react-i18next";
+```
+
+Your keys will now be **strictly typed** against your Intlayer dictionaries, offering full dot-path auto-completion in your IDE!
+
+### Bundler Alias Plugins (Vite, Next.js, Turbopack)
+
+To allow migrating without rewriting all your import statements manually, each compat adapter package includes a **custom bundler plugin** (Vite or Next.js) under the `/plugin` subpath.
+
+These plugins automatically rewrite existing imports (e.g. `react-i18next` or `next-intl`) to their `@intlayer/*` equivalents at build time.
+
+#### Next.js (Webpack / Turbopack) Example
+
+Instead of `withIntlayer`, wrap your Next.js configuration with the compat plugin:
+
+```ts fileName="next.config.ts"
+import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
+import type { NextConfig } from "next";
+
+const withIntlayer = createNextI18nPlugin();
+const nextConfig: NextConfig = {};
+
+export default withIntlayer(nextConfig);
+```
+
+#### Vite (React, Vue, Solid, Svelte) Example
+
+```ts fileName="vite.config.ts"
+import vueI18nVitePlugin from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vueI18nVitePlugin()],
+});
+```
+
+---
+
+## Mutualized Runtime Resolver
+
+All compat adapters now route translation resolution through a single, highly optimized runtime parser: `@intlayer/core/messageFormat`.
+
+- **Interpolate Message**: Resolves standard `{{var}}` (whitespace & dot-paths), ICU formatted args (`{v, number, percent}` etc.), and bare `{var}` templates.
+- **Message Node Resolver**: Resolves nested nodes: `insert()`, `plural()` (CLDR plural rules), `enu()` (enumeration), `gender()`, HTML tags, arrays, and callable function nodes.
+- **Tokenized Tag Parser**: Supports inline XML/HTML tags and numbered tags (e.g., `<1>children</1>`) to power rich-text rendering out of the box.
+
+---
+
+## Feature Spec: Collections & Variants
+
+Intlayer v9 expands beyond static key-value objects, allowing dictionaries to declare dynamic layout structures that are fully typed end-to-end.
+
+### 1. Collections
+
+Define a CMS-managed list of ordered items (e.g. FAQs, products, or blog lists):
+
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
+} satisfies Dictionary;
+```
+
+#### Usage:
+
+```ts
+// Fetch all items as an array
+const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
+
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
+```
+
+### 2. Variants
+
+Deliver A/B tests, seasonal headers, feature flags, or custom landing pages:
+
+#### String variants (e.g. A/B testing)
+
+```ts fileName="hero.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "hero-banner",
+  variant: "default",
+  content: {
+    control: t({ en: "Welcome", fr: "Bienvenue" }),
+    black_friday: t({ en: "Shop now", fr: "Acheter maintenant" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Usage:
+
+```ts
+const banner = useIntlayer("hero-banner", { variant: "black_friday" });
+```
+
+#### Object variants (e.g. Dynamic Records)
+
+```ts fileName="product.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "product-copy",
+  variant: {
+    id: "prod_123",
+    category: "books",
+  },
+  content: {
+    title: t({ en: "Clean Code", fr: "Code Propre" }),
+  },
+} satisfies Dictionary;
+```
+
+#### Usage:
+
+```ts
+// Fetches only the requested item dynamically (requires Suspense)
+const product = useIntlayer("product-copy", {
+  variant: { id: "prod_123", category: "books" },
+});
+```
+
+---
+
+## Dynamic Loading & Bundle Size Optimizations
+
+To keep bundles extremely small, Intlayer v9 supports dynamic lazy loading.
+
+In your configuration, set `importMode` to `'dynamic'` or `'fetch'`:
+
+```ts fileName="intlayer.config.ts"
+export default {
+  dictionary: {
+    importMode: "dynamic", // "static" | "dynamic" | "fetch"
+  },
+};
+```
+
+At build time, `@intlayer/swc` and `@intlayer/babel` scan your files and replace `useIntlayer` / `getIntlayer` calls with tree-shakeable wrappers (`useDictionary` / `useDictionaryDynamic`). Only the content required for the selected collection item, variant, or locale is loaded, preventing your production bundle from containing unused translations.
+
+---
+
+## Vite Plugin: 捆绑编译器和代理
+
+`intlayer()` Vite 插件现在直接捆绑了**编译器**和**区域设置路由代理**，因此大多数项目只需在 `vite.config.ts` 中使用单个插件：
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+- **Compiler**: 当 `compiler.enabled` 被设置为 `true` 且配置了 `compiler.output` 路径时，自动激活。您不再需要单独注册 `intlayerCompiler()`。
+- **Proxy**: 根据新的 `routing.enableProxy` 选项自动激活（默认为 `true`）。它在开发、预览和生产 SSR 中连接区域设置检测 / 重定向 / 重写中间件。您不再需要单独注册 `intlayerProxy()`。
+
+### `routing.enableProxy` 选项
+
+新的 `routing.enableProxy` 选项控制是否启用区域语言路由代理。默认值为 `true`。当您想自己处理区域语言路由时，可以禁用它：
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  routing: {
+    enableProxy: false, // 默认值: true
+  },
+};
+
+export default config;
+```
+
+独立的 `intlayerCompiler()` 和 `intlayerProxy()` 插件仍然可用于高级设置。将它们与 `intlayer()` 一起注册是安全的 — 每个插件会自动去重并且仅运行一次。
+
+---
+
+## 默认禁用编译器
+
+从 Intlayer v9 开始，**编译器默认被禁用**（`compiler.enabled` 现在默认为 `false`）。要启用对 `.content.ts` 文件的构建时提取，请在配置中设置 `compiler.enabled: true`：
+
+```ts fileName="intlayer.config.ts"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  compiler: {
+    enabled: true, // 默认值：false —— 自 v9 起启用编译器所必需
+    output: ({ fileName }) => `./${fileName}.content.ts`,
+  },
+};
+
+export default config;
+```
+
+当编译器被禁用时，Intlayer 会跳过构建时提取步骤，并依赖您已声明的字典。仅当您希望打包器插件（`@intlayer/swc`、`@intlayer/babel` 或 `intlayer()` Vite 插件）自动提取内容时才启用它。
+
+---
+
+## React Native：单包导入
+
+在 React Native 或 Expo 应用中，您不再需要同时管理 `react-intlayer` 和 `react-native-intlayer`。`react-native-intlayer` 包现在**重新导出了完整的 `react-intlayer` API**（hooks、工具函数以及 `/format`、`/html` 和 `/markdown` 子路径），并且其 `IntlayerProvider` 会自动应用 React Native 的 polyfills。
+
+从单一的 `react-native-intlayer` 包中导入所有内容：
+
+```tsx
+import {
+  IntlayerProvider,
+  useIntlayer,
+  useLocale,
+} from "react-native-intlayer";
+```
+
+```bash
+npm install intlayer react-native-intlayer
+```
+
+> 从 `react-intlayer` 导入仍然有效，但现在推荐使用 `react-native-intlayer` 作为 React Native 的单一入口点 —— 它的 provider 提供了面向 web 的 `react-intlayer` provider 所不包含的 polyfills。
+
+---
+
+## Migration notes from v8
+
+If you are upgrading from v8, note that the v9 does not include breaking changes. But here are the key changes:
+
+- **默认禁用编译器**：`compiler.enabled` 现在默认为 `false`。如果您依赖对 `.content.ts` 文件的构建时提取，请在 `intlayer.config.ts` 中设置 `compiler.enabled: true`。
+- **Locales & Dialects**: If using external i18n dependencies, add their respective compat adapter plugins in your configuration or bundler setup to automatically rewrite imports.
+- **Custom Selectors**: When calling `useIntlayer`, the second parameter is now reserved for an option object containing `{ locale, item, variant }`. If you previously passed a locale string directly, you can still do so, but using the options object is recommended for advanced selections.
+
+---
+
+## Useful links
+
+- [Compat Adapter Packages Guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/compat/index.md)
+- [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/dynamic_dictionaries/index.md)
+- [Configuration Reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/configuration.md)

package/docs/zh/roadmap.md

@@ -20,6 +20,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "初始化历史记录"
+author: aymericzip
 ---
 
 # Intlayer：功能概览与路线图
@@ -28,6 +29,12 @@ Intlayer 是一个内容管理和国际化解决方案，旨在简化您在应
 
 ---
 
+## 目录
+
+<TOC/>
+
+---
+
 ## 当前功能
 
 ### 1. 内容声明

package/docs/zh/testing.md

@@ -17,6 +17,7 @@ history:
   - version: 6.0.0
     date: 2025-09-20
     changes: "引入测试功能"
+author: aymericzip
 ---
 
 # 测试您的内容

package/docs/zh/vs_code_extension.md

@@ -28,6 +28,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "初始化历史"
+author: aymericzip
 ---
 
 # 官方 VS Code 扩展
@@ -118,13 +119,6 @@ Intlayer 建议将您的 AI API 密钥，以及 Intlayer 客户端 ID 和密钥
 - **非破坏性**：不会覆盖已有的 `process.env` 值。
 - **作用域**：文件从配置的基础目录解析（默认为工作区根目录）。
 
-#### 选择活动环境
-
-- **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先级列表中第一个可用的文件，并显示类似“已从 `.env.<env>.local` 加载环境”的通知。
-- **设置**：进入 `设置 → 扩展 → Intlayer`，并设置：
-  - **环境**：用于解析 `.env.<env>*` 文件的环境名称。
-  - （可选）**环境文件**：显式指定一个 `.env` 文件路径。提供后，该路径优先于推断的列表。
-
 #### Monorepos 和自定义目录
 
 - **命令面板**：打开命令面板并运行 `Intlayer: Select Environment`，然后选择环境（例如，`development`、`staging`、`production`）。扩展将尝试加载上述优先列表中的第一个可用文件，并显示类似“已从 `.env.<env>.local` 加载环境”的通知。

package/docs/zh-TW/bundle_optimization.md

@@ -22,6 +22,7 @@ history:
   - version: 8.7.0
     date: 2026-04-08
     changes: "向建置設定中新增了 `minify` 和 `purge` 選項"
+author: aymericzip
 ---
 
 # 最佳化 i18n 打包體積與效能
@@ -396,11 +397,11 @@ export default config;
 
 ### 建置選項
 
-| 屬性           | 類型                   | 預設值      | 詳細說明                                                                                                                                     |
-| :------------- | :--------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`optimize`** | `boolean \| undefined` | `undefined` | 用於開啟 import 語句的重寫。`undefined` = 僅在打包成生產環境模式時生效。當設定為 `false` 的時候，同樣會導致 purge 以及 minify 均一併被關閉。 |
-| **`minify`**   | `boolean`              | `false`     | 用於對已編譯好的 JSON 檔案裡的內容鍵名改寫成短的單字母名稱。同理也會一併將原始碼裡相關存取屬性同樣改名。僅當 `optimize` 為 `false` 時無效。  |
-| **`purge`**    | `boolean`              | `false`     | 用於移除無論如何也不會被呼叫的且靜態的原始檔的內容欄位，從 JSON 輸出中去除掉。僅當 `optimize` 為 `false` 時無效。                            |
+| 屬性           | 類型                  | 預設值      | 詳細說明                                                                                                                                     |
+| :------------- | :-------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`optimize`** | `boolean / undefined` | `undefined` | 用於開啟 import 語句的重寫。`undefined` = 僅在打包成生產環境模式時生效。當設定為 `false` 的時候，同樣會導致 purge 以及 minify 均一併被關閉。 |
+| **`minify`**   | `boolean`             | `false`     | 用於對已編譯好的 JSON 檔案裡的內容鍵名改寫成短的單字母名稱。同理也會一併將原始碼裡相關存取屬性同樣改名。僅當 `optimize` 為 `false` 時無效。  |
+| **`purge`**    | `boolean`             | `false`     | 用於移除無論如何也不會被呼叫的且靜態的原始檔的內容欄位，從 JSON 輸出中去除掉。僅當 `optimize` 為 `false` 時無效。                            |
 
 ### 壓縮 / Minification (重新命名欄位鍵值)
 

package/docs/zh-TW/interest_of_intlayer.md

@@ -25,6 +25,7 @@ history:
   - version: 5.5.10
     date: 2025-06-29
     changes: "初始化歷史記錄"
+author: aymericzip
 ---
 
 # 為什麼你應該考慮使用 Intlayer？