@intlayer/docs 9.4.0 → 9.4.2

package/docs/zh/migration_from_i18next_to_intlayer.md

@@ -27,7 +27,6 @@ author: aymericzip
 ## 为什么从 i18next 迁移到 Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Bundle 大小">
 
 与其将庞大的 JSON 文件加载到页面中，不如仅加载必要的内容。Intlayer 帮助**将 bundle 和页面大小减少高达 50%**。
@@ -65,7 +64,6 @@ Intlayer 也是 i18n 生态系统中**开发最活跃的**解决方案——问
 不仅仅是一个 i18n 解决方案，Intlayer 提供**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和一个**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助您**实时**管理多语言内容，使与翻译人员、文案编写者和其他团队成员的协作无缝衔接。内容可以本地和/或远程存储。
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/zh/migration_from_next-i18next_to_intlayer.md

@@ -30,7 +30,6 @@ author: aymericzip
 ## 为什么从 next-i18next 迁移到 Intlayer?
 
 <AccordionGroup>
-
 <Accordion header="Bundle 大小">
 
 与其将大量 JSON 文件加载到页面中，不如只加载必要的内容。Intlayer 可帮助**将 bundle 和页面大小减少最多 50%**。
@@ -68,7 +67,6 @@ Intlayer 也是 i18n 生态系统中**开发最活跃**的解决方案 — 问
 Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管[可视编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助你**实时**管理多语言内容，使与翻译人员、文案和其他团队成员的协作无缝进行。内容可以存储在本地和/或远程。
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/zh/migration_from_next-intl_to_intlayer.md

@@ -28,7 +28,6 @@ author: aymericzip
 ## 为什么从 next-intl 迁移到 Intlayer？
 
 <AccordionGroup>
-
 <Accordion header="Bundle 大小">
 
 与其将大量 JSON 文件加载到页面中，不如只加载必要的内容。Intlayer 帮助**将 bundle 和页面大小减少高达 50%**。
@@ -66,7 +65,6 @@ Intlayer 也是 i18n 生态中**开发最活跃的**解决方案 — 问题修
 Intlayer 不仅仅是一个 i18n 解决方案，它提供了一个**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和一个**[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助您**实时**管理多语言内容，使与翻译人员、文案和其他团队成员的协作无缝进行。内容可以本地和/或远程存储。
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/zh/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -29,7 +29,6 @@ author: aymericzip
 ## 为什么从 @nuxtjs/i18n 迁移到 Intlayer？
 
 <AccordionGroup>
-
 <Accordion header="Bundle 大小">
 
 不再需要将庞大的 JSON 文件加载到页面中，只加载必要的内容。Intlayer 帮助您**将 bundle 和页面大小减少高达 50%**。
@@ -67,7 +66,6 @@ Intlayer 也是 i18n 生态系统中**开发最活跃的**解决方案 — 问
 Intlayer 不仅仅是一个 i18n 解决方案，它还提供**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)**，帮助您**实时**管理多语言内容，使与翻译人员、文案人员和其他团队成员的协作无缝衔接。内容可以存储在本地和/或远程。
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/zh/migration_from_react-i18next_to_intlayer.md

@@ -29,7 +29,6 @@ author: aymericzip
 ## 为什么从 react-i18next / i18next 迁移到 Intlayer？
 
 <AccordionGroup>
-
 <Accordion header="Bundle 大小">
 
 与其将大量 JSON 文件加载到你的页面中，不如只加载必要的内容。Intlayer 帮助你**将 bundle 和页面大小减少多达 50%**。
@@ -67,7 +66,6 @@ Intlayer 也是 i18n 生态中**最活跃开发**的方案——问题修复速
 Intlayer 不仅是一个 i18n 方案，它还提供**自托管的[可视化编辑器](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)**和**[完整的 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)**，帮助你**实时**管理多语言内容，使与翻译人员、文案编写者和其他团队成员的协作无缝衔接。内容可以存储在本地和/或远程。
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/zh/migration_from_vue-i18n_to_intlayer.md

@@ -28,7 +28,6 @@ author: aymericzip
 ## 为什么要从 vue-i18n 迁移到 Intlayer？
 
 <AccordionGroup>
-
 <Accordion header="Bundle 体积">
 
 无需将庞大的 JSON 文件加载到页面中，只加载必要的内容。Intlayer 可帮助您**将 bundle 和页面尺寸减少多达 50%**。
@@ -66,7 +65,6 @@ Intlayer 也是 i18n 生态中**开发最活跃的**解决方案 —— 问题
 不仅仅是一个 i18n 解决方案，Intlayer 提供了一个**自托管的 [visual editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_visual_editor.md)** 和一个**[完整 CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/intlayer_CMS.md)** 来帮助您**实时**管理多语言内容，使与翻译、文案和其他团队成员的协作无缝。内容可以本地存储和/或远程存储。
 
 </Accordion>
-
 </AccordionGroup>
 
 ---

package/docs/zh/packages/vite-intlayer/intlayerMinify.md

@@ -71,7 +71,7 @@ export default defineConfig({
 
 当 `intlayerPrune` 分析了代码库并填充了 `pruneContext.dictionaryKeyToFieldRenameMap` 时，`intlayerMinify` 也会将内容字段名称重命名为简短别名。例如：
 
-```json
+```jsonc
 // 混淆前
 { "key": "myDict", "content": { "title": "Hello", "description": "World" } }
 

package/docs/zh/releases/v6.md

@@ -177,7 +177,7 @@ CI 示例可在 [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/do
 
 ---
 
-I'm ready to audit the translation. I can see that:
+更新了 MCP 服务器以支持新功能。
 
 - 自动填充
 - 测试缺失翻译

package/docs/zh-TW/introduction.md

@@ -95,7 +95,6 @@ export const MyComponent: FC = () => {
 與 `next-intl` 或 `i18next` 等主流解決方案相比，Intlayer 是一個自帶多項整合最佳化方案的工具，例如：
 
 <AccordionGroup>
-
 <Accordion header="打包體積 (Bundle Size)">
 
 您無需在頁面中載入龐大的 JSON 檔案，而是只載入所需的內容。Intlayer 可以幫助 **將您的打包檔和頁面大小減小高達 50%**。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/docs",
-  "version": "9.4.0",
+  "version": "9.4.2",
   "private": false,
   "description": "Intlayer documentation",
   "keywords": [
@@ -73,14 +73,14 @@
     "watch": "webpack --config ./webpack.config.ts --watch"
   },
   "dependencies": {
-    "@intlayer/config": "9.4.0-canary.0",
-    "@intlayer/core": "9.4.0-canary.0",
-    "@intlayer/types": "9.4.0"
+    "@intlayer/config": "9.4.2",
+    "@intlayer/core": "9.4.2",
+    "@intlayer/types": "9.4.2"
   },
   "devDependencies": {
-    "@intlayer/api": "9.4.0",
-    "@intlayer/cli": "9.4.0",
-    "@types/node": "26.3.0",
+    "@intlayer/api": "9.4.2",
+    "@intlayer/cli": "9.4.2",
+    "@types/node": "26.4.1",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",

package/src/common.ts

@@ -190,6 +190,40 @@ export const getFileMetadataRecord = async <
   return (await record) as Record<keyof F, FileMetadata>;
 };
 
+/**
+ * Flattens front-matter slugs into the URL segments they produce.
+ *
+ * `relativeUrl` is built by joining the slugs with `/`, so a slug holding a
+ * slash — `"@intlayer/babel"` — yields more URL segments than the array holds
+ * entries. A requested path, split on `/`, could then never be matched against
+ * the raw array, and the page resolved to nothing.
+ *
+ * @param slugs - Front-matter slugs, or the segments of a requested path.
+ * @returns One entry per URL segment, empty segments dropped.
+ */
+const toUrlSegments = (slugs: string[]): string[] =>
+  slugs.flatMap((slug) => slug.split('/')).filter(Boolean);
+
+/**
+ * Tells whether a file answers a requested slug path.
+ *
+ * @param fileMetadata - Metadata of the candidate file.
+ * @param requestedSegments - URL segments asked for, already flattened.
+ * @param strict - Rejects files owning segments beyond the requested ones.
+ * @returns `true` when the file matches the request.
+ */
+const matchesRequestedSegments = (
+  fileMetadata: FileMetadata,
+  requestedSegments: string[],
+  strict: boolean
+): boolean => {
+  const fileSegments = toUrlSegments(fileMetadata.slugs ?? []);
+
+  if (strict && fileSegments.length !== requestedSegments.length) return false;
+
+  return requestedSegments.every((segment) => fileSegments.includes(segment));
+};
+
 export const getFileMetadataBySlug = async <
   F extends Record<string, Record<LocalesValues, Promise<string>>>,
 >(
@@ -198,23 +232,19 @@ export const getFileMetadataBySlug = async <
   locale: LocalesValues = defaultLocale as LocalesValues,
   strict = false
 ) => {
-  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];
+  const requestedSegments = toUrlSegments(
+    Array.isArray(slugs) ? slugs : [slugs]
+  );
   const filesMetadata = await getFileMetadataRecord(
     files,
     defaultLocale as LocalesValues
   );
 
-  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(
+  const fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(
     (fileMetadata) =>
-      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))
+      matchesRequestedSegments(fileMetadata, requestedSegments, strict)
   );
 
-  if (strict) {
-    fileMetadataArray = fileMetadataArray.filter(
-      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length
-    );
-  }
-
   if (locale !== defaultLocale) {
     const localizedFileMetadata = await Promise.all(
       fileMetadataArray.map(
@@ -237,22 +267,19 @@ export const getFileBySlug = async <
   locale: LocalesValues = defaultLocale as LocalesValues,
   strict = false
 ) => {
-  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];
+  const requestedSegments = toUrlSegments(
+    Array.isArray(slugs) ? slugs : [slugs]
+  );
   const filesMetadata = await getFileMetadataRecord(
     files,
     defaultLocale as LocalesValues
   );
 
-  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>
-    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))
+  const fileMetadataArray = Object.values(filesMetadata).filter(
+    (fileMetadata) =>
+      matchesRequestedSegments(fileMetadata, requestedSegments, strict)
   );
 
-  if (strict) {
-    fileMetadataArray = fileMetadataArray.filter(
-      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length
-    );
-  }
-
   const fileList = await Promise.all(
     fileMetadataArray.map(async (fileMetadata) => {
       const file = await getFile(files, fileMetadata.docKey, locale);

package/src/generated/blog.entry.ts

@@ -105,6 +105,26 @@ export const blogEntry = {
     vi: readLocale('compiler_vs_declarative_i18n.md', 'vi'),
     uk: readLocale('compiler_vs_declarative_i18n.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './blog/en/hreflang_guide_multilingual_seo.md': {
+    en: readLocale('hreflang_guide_multilingual_seo.md', 'en'),
+    es: readLocale('hreflang_guide_multilingual_seo.md', 'es'),
+    ru: readLocale('hreflang_guide_multilingual_seo.md', 'ru'),
+    ja: readLocale('hreflang_guide_multilingual_seo.md', 'ja'),
+    fr: readLocale('hreflang_guide_multilingual_seo.md', 'fr'),
+    ko: readLocale('hreflang_guide_multilingual_seo.md', 'ko'),
+    zh: readLocale('hreflang_guide_multilingual_seo.md', 'zh'),
+    de: readLocale('hreflang_guide_multilingual_seo.md', 'de'),
+    ar: readLocale('hreflang_guide_multilingual_seo.md', 'ar'),
+    it: readLocale('hreflang_guide_multilingual_seo.md', 'it'),
+    'en-GB': readLocale('hreflang_guide_multilingual_seo.md', 'en-GB'),
+    pt: readLocale('hreflang_guide_multilingual_seo.md', 'pt'),
+    hi: readLocale('hreflang_guide_multilingual_seo.md', 'hi'),
+    tr: readLocale('hreflang_guide_multilingual_seo.md', 'tr'),
+    pl: readLocale('hreflang_guide_multilingual_seo.md', 'pl'),
+    id: readLocale('hreflang_guide_multilingual_seo.md', 'id'),
+    vi: readLocale('hreflang_guide_multilingual_seo.md', 'vi'),
+    uk: readLocale('hreflang_guide_multilingual_seo.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './blog/en/i18n_meaning.md': {
     en: readLocale('i18n_meaning.md', 'en'),
     es: readLocale('i18n_meaning.md', 'es'),

package/src/generated/docs.entry.ts

@@ -1945,6 +1945,26 @@ export const docsEntry = {
     vi: readLocale('intlayer_with_hono.md', 'vi'),
     uk: readLocale('intlayer_with_hono.md', 'uk'),
   } as unknown as Record<LocalesValues, Promise<string>>,
+  './docs/en/intlayer_with_htmx.md': {
+    en: readLocale('intlayer_with_htmx.md', 'en'),
+    es: readLocale('intlayer_with_htmx.md', 'es'),
+    ru: readLocale('intlayer_with_htmx.md', 'ru'),
+    ja: readLocale('intlayer_with_htmx.md', 'ja'),
+    fr: readLocale('intlayer_with_htmx.md', 'fr'),
+    ko: readLocale('intlayer_with_htmx.md', 'ko'),
+    zh: readLocale('intlayer_with_htmx.md', 'zh'),
+    de: readLocale('intlayer_with_htmx.md', 'de'),
+    ar: readLocale('intlayer_with_htmx.md', 'ar'),
+    it: readLocale('intlayer_with_htmx.md', 'it'),
+    'en-GB': readLocale('intlayer_with_htmx.md', 'en-GB'),
+    pt: readLocale('intlayer_with_htmx.md', 'pt'),
+    hi: readLocale('intlayer_with_htmx.md', 'hi'),
+    tr: readLocale('intlayer_with_htmx.md', 'tr'),
+    pl: readLocale('intlayer_with_htmx.md', 'pl'),
+    id: readLocale('intlayer_with_htmx.md', 'id'),
+    vi: readLocale('intlayer_with_htmx.md', 'vi'),
+    uk: readLocale('intlayer_with_htmx.md', 'uk'),
+  } as unknown as Record<LocalesValues, Promise<string>>,
   './docs/en/intlayer_with_lynx+react.md': {
     en: readLocale('intlayer_with_lynx+react.md', 'en'),
     es: readLocale('intlayer_with_lynx+react.md', 'es'),