@intlayer/docs 9.0.0-canary.9 → 9.0.1

package/blog/tr/intlayer_with_next-i18next.md

@@ -63,19 +63,19 @@ Bu rehber, Intlayer'ın üstün içerik beyan sistemi avantajlarından yararlan
 Tercih ettiğiniz paket yöneticisini kullanarak gerekli paketleri yükleyin:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_next-intl.md

@@ -65,19 +65,19 @@ Bu rehber, Intlayer'ın üstün içerik beyan sistemi avantajlarından yararlan
 Gerekli paketleri yükleyin:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_react-i18next.md

@@ -64,19 +64,19 @@ Bu rehber, Intlayer'ın üstün içerik beyan sistemi kullanılırken react-i18n
 Gerekli paketleri yükleyin:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_react-intl.md

@@ -63,19 +63,19 @@ Bu rehber, react-intl ile uyumluluğu korurken Intlayer'ın üstün içerik beya
 Gerekli paketleri yükleyin:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/intlayer_with_vue-i18n.md

@@ -64,19 +64,19 @@ Bu rehber, Intlayer'ın üstün içerik beyan sistemi avantajlarından yararlan
 Tercih ettiğiniz paket yöneticisini kullanarak gerekli paketleri yükleyin:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` bayrağı isteğe bağlıdır. Bir yapay zeka aracısıysanız `intlayer-cli init` kullanın.

package/blog/tr/nextjs-multilingual-seo-comparison.md

@@ -345,6 +345,12 @@ export default robots;
 
 ---
 
+## Intlayer SEO Scanner ile web sitenizi denetleyin
+
+Çok dilli uygulamanızın mükemmel şekilde optimize edildiğinden emin olmak için [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner) kullanmanızı öneririz. Çok dilli web sitesi kontrolü için özel bir araçtır; tüm yerelleştirilmiş sayfalarınızda eksik hreflang etiketlerini, bozuk bağlantıları ve diğer SEO sorunlarını belirlemenize yardımcı olur.
+
+---
+
 ## Sonuç
 
 Next.js'te i18n'i doğru yapmak sadece metni çevirmekle ilgili değildir, aynı zamanda arama motorlarının ve kullanıcıların içeriğinizin hangi sürümünü sunacağını tam olarak bilmelerini sağlamaktır.

package/blog/uk/internationalization_and_SEO.md

@@ -265,6 +265,12 @@ const LocaleSwitcher: FC = () => {
 
 ---
 
+## Перевірте свій веб-сайт за допомогою Intlayer SEO Scanner
+
+Щоб переконатися, що ваш багатомовний додаток ідеально оптимізовано, ми рекомендуємо використовувати [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). Це спеціалізований інструмент для перевірки багатомовних веб-сайтів, який допомагає виявити відсутні теги hreflang, непрацюючі посилання та інші проблеми SEO на всіх ваших локалізованих сторінках.
+
+---
+
 ## Підсумок
 
 Створення багатомовного вебсайту, це не лише переклад тексту. Йдеться про ефективну структуру URL-адрес, використання тегів `hreflang`, щоб допомогти пошуковим системам показувати правильну версію, і забезпечення відмінного користувацького досвіду з локалізованими візуалами, селекторами мови та послідовною навігацією. Дотримання цих найкращих практик підготує вас до успіху на світових ринках, підвищить задоволеність користувачів і, зрештою, покращить SEO-показники в різних регіонах.

package/blog/uk/intlayer_with_i18next.md

@@ -85,19 +85,19 @@ Intlayer пропонує широкий набір розширених фун
 Встановіть необхідні пакети:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.

package/blog/uk/intlayer_with_next-i18next.md

@@ -76,19 +76,19 @@ Intlayer пропонує широкий набір **розширених мо
 Встановіть необхідні пакети, використовуючи ваш улюблений пакетний менеджер:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.

package/blog/uk/intlayer_with_next-intl.md

@@ -75,19 +75,19 @@ Intlayer пропонує широкий набір **розширених мо
 Встановіть необхідні пакети:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.

package/blog/uk/intlayer_with_react-i18next.md

@@ -76,19 +76,19 @@ Intlayer пропонує широкий набір **просунутих фу
 Встановіть необхідні пакети:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.

package/blog/uk/intlayer_with_react-intl.md

@@ -74,19 +74,19 @@ Intlayer пропонує багатий набір **розширених фу
 Встановіть необхідні пакети:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.

package/blog/uk/intlayer_with_vue-i18n.md

@@ -76,19 +76,19 @@ Intlayer пропонує широкий набір **розширених мо
 Встановіть необхідні пакети, використовуючи бажаний пакетний менеджер:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > прапорець `--interactive` не є обов'язковим. Використовуйте `intlayer-cli init`, якщо ви є ШІ-агентом.

package/blog/uk/nextjs-multilingual-seo-comparison.md

@@ -343,6 +343,12 @@ export default robots;
 
 ---
 
+## Перевірте свій веб-сайт за допомогою Intlayer SEO Scanner
+
+Щоб переконатися, що ваш багатомовний додаток ідеально оптимізовано, ми рекомендуємо використовувати [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). Це спеціалізований інструмент для перевірки багатомовних веб-сайтів, який допомагає виявити відсутні теги hreflang, непрацюючі посилання та інші проблеми SEO на всіх ваших локалізованих сторінках.
+
+---
+
 ## Висновок
 
 Правильна реалізація i18n у Next.js, це не просто переклад тексту, а забезпечення того, щоб пошукові системи та користувачі точно знали, яку версію вашого контенту показувати.

package/blog/vi/internationalization_and_SEO.md

@@ -264,6 +264,12 @@ const LocaleSwitcher: FC = () => {
 
 ---
 
+## Kiểm tra trang web của bạn bằng Intlayer SEO Scanner
+
+Để đảm bảo ứng dụng đa ngôn ngữ của bạn được tối ưu hóa hoàn hảo, chúng tôi khuyên bạn nên sử dụng [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). Đây là một công cụ chuyên dụng để kiểm tra trang web đa ngôn ngữ, giúp bạn xác định các thẻ hreflang bị thiếu, liên kết bị hỏng và các vấn đề SEO khác trên tất cả các trang được bản địa hóa của bạn.
+
+---
+
 ## Kết Luận
 
 Việc làm cho trang web của bạn đa ngôn ngữ không chỉ đơn thuần là dịch văn bản. Nó còn liên quan đến việc cấu trúc URL một cách hiệu quả, sử dụng thẻ `hreflang` để giúp các công cụ tìm kiếm phục vụ phiên bản đúng, và cung cấp trải nghiệm người dùng xuất sắc với hình ảnh địa phương hóa, bộ chọn ngôn ngữ, và điều hướng nhất quán. Tuân theo những thực hành tốt nhất này sẽ giúp bạn thành công trên thị trường toàn cầu, tăng sự hài lòng của người dùng, và cuối cùng là mang lại kết quả SEO tốt hơn trên các khu vực khác nhau.

package/blog/vi/intlayer_with_i18next.md

@@ -70,19 +70,19 @@ Hướng dẫn này sẽ chỉ cho bạn cách tận dụng hệ thống khai b
 Cài đặt các gói cần thiết:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.

package/blog/vi/intlayer_with_next-i18next.md

@@ -63,19 +63,19 @@ Hướng dẫn này sẽ chỉ cho bạn cách tận dụng hệ thống khai b
 Cài đặt các gói cần thiết bằng trình quản lý gói bạn ưa thích:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.

package/blog/vi/intlayer_with_next-intl.md

@@ -65,19 +65,19 @@ Hướng dẫn này sẽ chỉ cho bạn cách tận dụng hệ thống khai b
 Cài đặt các gói cần thiết:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.

package/blog/vi/intlayer_with_react-i18next.md

@@ -64,19 +64,19 @@ Hướng dẫn này sẽ chỉ cho bạn cách tận dụng hệ thống khai b
 Cài đặt các gói cần thiết:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.

package/blog/vi/intlayer_with_react-intl.md

@@ -62,19 +62,19 @@ Hướng dẫn này sẽ chỉ cho bạn cách tận dụng hệ thống khai b
 Cài đặt các gói cần thiết:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.

package/blog/vi/intlayer_with_vue-i18n.md

@@ -64,19 +64,19 @@ Hướng dẫn này sẽ chỉ cho bạn cách tận dụng hệ thống khai b
 Cài đặt các gói cần thiết bằng trình quản lý gói bạn ưa thích:
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.

package/blog/vi/nextjs-multilingual-seo-comparison.md

@@ -345,6 +345,12 @@ export default robots;
 
 ---
 
+## Kiểm tra trang web của bạn bằng Intlayer SEO Scanner
+
+Để đảm bảo ứng dụng đa ngôn ngữ của bạn được tối ưu hóa hoàn hảo, chúng tôi khuyên bạn nên sử dụng [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner). Đây là một công cụ chuyên dụng để kiểm tra trang web đa ngôn ngữ, giúp bạn xác định các thẻ hreflang bị thiếu, liên kết bị hỏng và các vấn đề SEO khác trên tất cả các trang được bản địa hóa của bạn.
+
+---
+
 ## Kết luận
 
 Việc làm i18n đúng trong Next.js không chỉ là dịch văn bản, mà còn là đảm bảo các công cụ tìm kiếm và người dùng biết chính xác phiên bản nội dung nào cần được phục vụ.

package/blog/zh/internationalization_and_SEO.md

@@ -286,6 +286,12 @@ const LocaleSwitcher: FC = () => {
 
 ---
 
+## 使用 Intlayer SEO Scanner 审核您的网站
+
+为了确保您的多语言应用程序得到完美优化，我们建议使用 [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner)。这是一款专门用于多语言网站检查的工具，可帮助您识别所有本地化页面中缺失的 hreflang 标签、断开的链接以及其他 SEO 问题。
+
+---
+
 ## 总结
 
 让您的网站支持多语言不仅仅涉及翻译文本。它还关乎有效地构建 URL，使用 `hreflang` 标签帮助搜索引擎提供正确的版本，并提供卓越的用户体验, 包括本地化视觉内容、语言选择器和一致的导航。遵循这些最佳实践将使您在全球市场取得成功，提升用户满意度，并最终在各个地区改善 SEO 结果。

package/blog/zh/nextjs-multilingual-seo-comparison.md

@@ -347,6 +347,12 @@ export default robots;
 
 ---
 
+## 使用 Intlayer SEO Scanner 审核您的网站
+
+为了确保您的多语言应用程序得到完美优化，我们建议使用 [Intlayer SEO Scanner](https://intlayer.org/i18n-seo-scanner)。这是一款专门用于多语言网站检查的工具，可帮助您识别所有本地化页面中缺失的 hreflang 标签、断开的链接以及其他 SEO 问题。
+
+---
+
 ## 结论
 
 在 Next.js 中正确处理国际化（i18n）不仅仅是翻译文本，更是确保搜索引擎和用户能够准确识别并访问您内容的正确版本。

package/dist/cjs/authors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"authors.cjs","names":["authorsData"],"sources":["../../src/authors.ts"],"sourcesContent":["import authorsData from '../authors.json' with { type: 'json' };\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\nexport type AuthorProfile = {\n  /** Full display name */\n  name: string;\n  /** Schema.org Person @id URI (optional) */\n  id?: string;\n  /** Professional title */\n  title?: string;\n  /** Canonical URL for this person */\n  url?: string;\n  /** Profile image URL */\n  image?: string;\n  /** List of equivalent profile URLs (LinkedIn, Twitter/X, GitHub…) */\n  socialMedias?: string[];\n  /** Areas of expertise */\n  knowsAbout?: string[];\n  /** GitHub username/handle */\n  github?: string;\n};\n\nexport type Authors = Record<string, AuthorProfile>;\n\n// ─── Loader (lazy singleton) ──────────────────────────────────────────────────\n\nconst loadAuthors = (): Authors => authorsData as Authors;\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Resolve a full author profile by GitHub handle.\n * Returns `undefined` if the handle is not found in `authors.json`.\n */\nexport const getAuthor = (github: string): AuthorProfile | undefined => {\n  const profile = loadAuthors()[github];\n  if (!profile) return undefined;\n  return {\n    ...profile,\n    github,\n  };\n};\n\nexport { loadAuthors as getAuthors };\n\n/**\n * Build a Schema.org Person node suitable for JSON-LD.\n * Undefined fields are omitted automatically by JSON.stringify.\n */\nexport const buildAuthorJsonLd = (\n  profile?: AuthorProfile,\n  fallbackName = 'Aymeric Pineau',\n  fallbackUrl?: string\n) => ({\n  '@type': 'Person' as const,\n  '@id': profile?.id,\n  name: profile?.name ?? fallbackName,\n  url: profile?.url ?? fallbackUrl,\n  jobTitle: profile?.title,\n  image: profile?.image,\n  sameAs: profile?.socialMedias?.length ? profile.socialMedias : undefined,\n  knowsAbout: profile?.knowsAbout?.length ? profile.knowsAbout : undefined,\n});\n"],"mappings":";;;;AA2BA,MAAM,oBAA6BA;;;;;AAQnC,MAAa,aAAa,WAA8C;CACtE,MAAM,UAAU,aAAa,CAAC;AAC9B,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO;EACL,GAAG;EACH;EACD;;;;;;AASH,MAAa,qBACX,SACA,eAAe,kBACf,iBACI;CACJ,SAAS;CACT,OAAO,SAAS;CAChB,MAAM,SAAS,QAAQ;CACvB,KAAK,SAAS,OAAO;CACrB,UAAU,SAAS;CACnB,OAAO,SAAS;CAChB,QAAQ,SAAS,cAAc,SAAS,QAAQ,eAAe;CAC/D,YAAY,SAAS,YAAY,SAAS,QAAQ,aAAa;CAChE"}
+{"version":3,"file":"authors.cjs","names":["authorsData"],"sources":["../../src/authors.ts"],"sourcesContent":["import authorsData from '../authors.json' with { type: 'json' };\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\nexport type AuthorProfile = {\n  /** Full display name */\n  name: string;\n  /** Schema.org Person @id URI (optional) */\n  id?: string;\n  /** Professional title */\n  title?: string;\n  /** Canonical URL for this person */\n  url?: string;\n  /** Profile image URL */\n  image?: string;\n  /** List of equivalent profile URLs (LinkedIn, Twitter/X, GitHub…) */\n  socialMedias?: string[];\n  /** Areas of expertise */\n  knowsAbout?: string[];\n  /** GitHub username/handle */\n  github?: string;\n};\n\nexport type Authors = Record<string, AuthorProfile>;\n\n// ─── Loader (lazy singleton) ──────────────────────────────────────────────────\n\nconst loadAuthors = (): Authors => authorsData as Authors;\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\n/**\n * Resolve a full author profile by GitHub handle.\n * Returns `undefined` if the handle is not found in `authors.json`.\n */\nexport const getAuthor = (github: string): AuthorProfile | undefined => {\n  const profile = loadAuthors()[github];\n  if (!profile) return undefined;\n  return {\n    ...profile,\n    github,\n  };\n};\n\nexport { loadAuthors as getAuthors };\n\n/**\n * Build a Schema.org Person node suitable for JSON-LD.\n * Undefined fields are omitted automatically by JSON.stringify.\n */\nexport const buildAuthorJsonLd = (\n  profile?: AuthorProfile,\n  fallbackName = 'Aymeric Pineau',\n  fallbackUrl?: string\n) => ({\n  '@type': 'Person' as const,\n  '@id': profile?.id,\n  name: profile?.name ?? fallbackName,\n  url: profile?.url ?? fallbackUrl,\n  jobTitle: profile?.title,\n  image: profile?.image,\n  sameAs: profile?.socialMedias?.length ? profile.socialMedias : undefined,\n  knowsAbout: profile?.knowsAbout?.length ? profile.knowsAbout : undefined,\n});\n"],"mappings":";;;;AA2BA,MAAM,oBAA6BA;;;;;AAQnC,MAAa,aAAa,WAA8C;CACtE,MAAM,UAAU,YAAY,CAAC,CAAC;CAC9B,IAAI,CAAC,SAAS,OAAO;CACrB,OAAO;EACL,GAAG;EACH;CACF;AACF;;;;;AAQA,MAAa,qBACX,SACA,eAAe,kBACf,iBACI;CACJ,SAAS;CACT,OAAO,SAAS;CAChB,MAAM,SAAS,QAAQ;CACvB,KAAK,SAAS,OAAO;CACrB,UAAU,SAAS;CACnB,OAAO,SAAS;CAChB,QAAQ,SAAS,cAAc,SAAS,QAAQ,eAAe;CAC/D,YAAY,SAAS,YAAY,SAAS,QAAQ,aAAa;AACjE"}

package/dist/cjs/blog.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"blog.cjs","names":["getKeys","blogEntry","defaultLocale","getFiles","getFile","getFileMetadataRecord","getFileMetadata","getFileMetadataBySlug","getFileBySlug"],"sources":["../../src/blog.ts"],"sourcesContent":["import type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport {\n  defaultLocale,\n  type FileMetadata,\n  getFile,\n  getFileBySlug,\n  getFileMetadata,\n  getFileMetadataBySlug,\n  getFileMetadataRecord,\n  getFiles,\n  getKeys,\n} from './common';\nimport { blogEntry } from './generated/blog.entry';\n\nexport type BlogKey = keyof typeof blogEntry;\nexport type Blogs = Record<BlogKey, Record<LocalesValues, Promise<string>>>;\nexport type BlogMetadata = FileMetadata;\n\nexport const getBlogsKeys = (): (keyof typeof blogEntry)[] =>\n  getKeys(blogEntry);\n\nexport const getBlogs = async <L extends LocalesValues = DeclaredLocales>(\n  locale: L = defaultLocale as L\n): Promise<Record<BlogKey, string>> => await getFiles(blogEntry, locale);\n\nexport const getBlog = async <L extends LocalesValues = DeclaredLocales>(\n  docName: BlogKey,\n  locale: L = defaultLocale as L\n): Promise<string> => await getFile(blogEntry, docName, locale);\n\nexport const getBlogMetadataRecord = async <\n  L extends LocalesValues = DeclaredLocales,\n>(\n  locale: L = defaultLocale as L\n): Promise<Record<BlogKey, FileMetadata>> =>\n  await getFileMetadataRecord(blogEntry, locale);\n\nexport const getBlogMetadata = async <\n  D extends BlogKey,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  docName: D,\n  locale: L = defaultLocale as L\n): Promise<FileMetadata> => await getFileMetadata(blogEntry, docName, locale);\n\nexport const getBlogMetadataBySlug = async <\n  L extends LocalesValues = DeclaredLocales,\n>(\n  slugs: string | string[],\n  locale: L = defaultLocale as L,\n  strict = false\n): Promise<FileMetadata[]> =>\n  await getFileMetadataBySlug(blogEntry, slugs, locale, strict);\n\nexport const getBlogBySlug = async <L extends LocalesValues = DeclaredLocales>(\n  slugs: string | string[],\n  locale: L = defaultLocale as L,\n  strict = false\n): Promise<string[]> => await getFileBySlug(blogEntry, slugs, locale, strict);\n"],"mappings":";;;;;AAqBA,MAAa,qBACXA,uBAAQC,uCAAU;AAEpB,MAAa,WAAW,OACtB,SAAYC,iCACyB,MAAMC,wBAASF,wCAAW,OAAO;AAExE,MAAa,UAAU,OACrB,SACA,SAAYC,iCACQ,MAAME,uBAAQH,wCAAW,SAAS,OAAO;AAE/D,MAAa,wBAAwB,OAGnC,SAAYC,iCAEZ,MAAMG,qCAAsBJ,wCAAW,OAAO;AAEhD,MAAa,kBAAkB,OAI7B,SACA,SAAYC,iCACc,MAAMI,+BAAgBL,wCAAW,SAAS,OAAO;AAE7E,MAAa,wBAAwB,OAGnC,OACA,SAAYC,8BACZ,SAAS,UAET,MAAMK,qCAAsBN,wCAAW,OAAO,QAAQ,OAAO;AAE/D,MAAa,gBAAgB,OAC3B,OACA,SAAYC,8BACZ,SAAS,UACa,MAAMM,6BAAcP,wCAAW,OAAO,QAAQ,OAAO"}
+{"version":3,"file":"blog.cjs","names":["getKeys","blogEntry","defaultLocale","getFiles","getFile","getFileMetadataRecord","getFileMetadata","getFileMetadataBySlug","getFileBySlug"],"sources":["../../src/blog.ts"],"sourcesContent":["import type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport {\n  defaultLocale,\n  type FileMetadata,\n  getFile,\n  getFileBySlug,\n  getFileMetadata,\n  getFileMetadataBySlug,\n  getFileMetadataRecord,\n  getFiles,\n  getKeys,\n} from './common';\nimport { blogEntry } from './generated/blog.entry';\n\nexport type BlogKey = keyof typeof blogEntry;\nexport type Blogs = Record<BlogKey, Record<LocalesValues, Promise<string>>>;\nexport type BlogMetadata = FileMetadata;\n\nexport const getBlogsKeys = (): (keyof typeof blogEntry)[] =>\n  getKeys(blogEntry);\n\nexport const getBlogs = async <L extends LocalesValues = DeclaredLocales>(\n  locale: L = defaultLocale as L\n): Promise<Record<BlogKey, string>> => await getFiles(blogEntry, locale);\n\nexport const getBlog = async <L extends LocalesValues = DeclaredLocales>(\n  docName: BlogKey,\n  locale: L = defaultLocale as L\n): Promise<string> => await getFile(blogEntry, docName, locale);\n\nexport const getBlogMetadataRecord = async <\n  L extends LocalesValues = DeclaredLocales,\n>(\n  locale: L = defaultLocale as L\n): Promise<Record<BlogKey, FileMetadata>> =>\n  await getFileMetadataRecord(blogEntry, locale);\n\nexport const getBlogMetadata = async <\n  D extends BlogKey,\n  L extends LocalesValues = DeclaredLocales,\n>(\n  docName: D,\n  locale: L = defaultLocale as L\n): Promise<FileMetadata> => await getFileMetadata(blogEntry, docName, locale);\n\nexport const getBlogMetadataBySlug = async <\n  L extends LocalesValues = DeclaredLocales,\n>(\n  slugs: string | string[],\n  locale: L = defaultLocale as L,\n  strict = false\n): Promise<FileMetadata[]> =>\n  await getFileMetadataBySlug(blogEntry, slugs, locale, strict);\n\nexport const getBlogBySlug = async <L extends LocalesValues = DeclaredLocales>(\n  slugs: string | string[],\n  locale: L = defaultLocale as L,\n  strict = false\n): Promise<string[]> => await getFileBySlug(blogEntry, slugs, locale, strict);\n"],"mappings":";;;;;AAqBA,MAAa,qBACXA,uBAAQC,sCAAS;AAEnB,MAAa,WAAW,OACtB,SAAYC,iCACyB,MAAMC,wBAASF,wCAAW,MAAM;AAEvE,MAAa,UAAU,OACrB,SACA,SAAYC,iCACQ,MAAME,uBAAQH,wCAAW,SAAS,MAAM;AAE9D,MAAa,wBAAwB,OAGnC,SAAYC,iCAEZ,MAAMG,qCAAsBJ,wCAAW,MAAM;AAE/C,MAAa,kBAAkB,OAI7B,SACA,SAAYC,iCACc,MAAMI,+BAAgBL,wCAAW,SAAS,MAAM;AAE5E,MAAa,wBAAwB,OAGnC,OACA,SAAYC,8BACZ,SAAS,UAET,MAAMK,qCAAsBN,wCAAW,OAAO,QAAQ,MAAM;AAE9D,MAAa,gBAAgB,OAC3B,OACA,SAAYC,8BACZ,SAAS,UACa,MAAMM,6BAAcP,wCAAW,OAAO,QAAQ,MAAM"}

package/dist/cjs/common.cjs

@@ -45,7 +45,8 @@ const formatMetadata = (docKey, file, locale = defaultLocale) => {
 	};
 };
 const getFileMetadata = async (files, docKey, locale = defaultLocale) => {
-	return formatMetadata(docKey, await getFile(files, docKey, locale), locale);
+	const file = await getFile(files, docKey, locale);
+	return formatMetadata(docKey, file, locale);
 };
 const getFileMetadataRecord = async (files, locale = defaultLocale) => {
 	const filesEntries = (await Promise.allSettled(Object.entries(files).map(async ([key]) => {

package/dist/cjs/common.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"common.cjs","names":["Locales"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl } from '@intlayer/core/localization';\nimport { getMarkdownMetadata } from '@intlayer/core/transpiler';\nimport * as Locales from '@intlayer/types/locales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey]?.[defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  applicationShowcase?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n\n  const slugs = (metadata.slugs ?? []).map(String);\n  const keywords = (metadata.keywords ?? []).map(String);\n\n  const relativeUrl = join('/', ...slugs);\n\n  const slicedDocKey = docKey.slice(1);\n\n  // Normalise author: accept both a plain string handle (new format)\n  // and a legacy object `{ github: '...' }` — always reduce to a plain string.\n  const rawAuthor = metadata.author as\n    | string\n    | { name?: string; github?: string }\n    | undefined;\n  const author: string | undefined =\n    typeof rawAuthor === 'string'\n      ? rawAuthor || undefined\n      : rawAuthor?.github || undefined;\n\n  return {\n    ...metadata,\n    docKey,\n    slugs,\n    keywords,\n    author,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const results = await Promise.allSettled(\n    Object.entries(files).map(async ([key]) => {\n      const metadata = await getFileMetadata(files, key as keyof F, locale);\n      return [key, metadata] as [string, FileMetadata];\n    })\n  );\n  const filesEntries = results\n    .filter(\n      (r): r is PromiseFulfilledResult<[string, FileMetadata]> =>\n        r.status === 'fulfilled'\n    )\n    .map((r) => r.value);\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult as Record<keyof F, FileMetadata>;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":"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"}
+{"version":3,"file":"common.cjs","names":["Locales"],"sources":["../../src/common.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { getLocalizedUrl } from '@intlayer/core/localization';\nimport { getMarkdownMetadata } from '@intlayer/core/transpiler';\nimport * as Locales from '@intlayer/types/locales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport const defaultLocale = Locales.ENGLISH;\n\nexport const GITHUB_URL_PREFIX =\n  'https://github.com/aymericzip/intlayer/blob/main/docs';\nexport const URL_PREFIX = 'https://intlayer.org/';\n\nexport const getKeys = <T extends Record<string, any>>(obj: T): (keyof T)[] =>\n  Object.keys(obj) as (keyof T)[];\n\nexport const getFiles = async <\n  F extends Record<`./${string}`, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  lang: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<string, string>> => {\n  const filesEntries = await Promise.all(\n    Object.entries(files)\n      .map(([key, value]) => [key, value[lang as LocalesValues]])\n      .map(async ([key, value]) => [key, await value])\n  );\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult;\n};\n\nexport const getFile = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<string> => {\n  const fileRecord = files[docKey];\n\n  if (!fileRecord) {\n    throw new Error(`File ${docKey as string} not found`);\n  }\n\n  const file = await files[docKey]?.[locale];\n\n  if (!file) {\n    const englishFile = await files[docKey]?.[defaultLocale as LocalesValues];\n\n    if (!englishFile) {\n      throw new Error(`File ${docKey as string} not found`);\n    }\n\n    return englishFile;\n  }\n\n  return file;\n};\n\nexport type FileMetadata = {\n  docKey: string;\n  url: string;\n  relativeUrl: string;\n  githubUrl: string;\n  title: string;\n  slugs: string[];\n  description: string;\n  keywords: string[];\n  updatedAt: string;\n  createdAt: string;\n  author?: string;\n  youtubeVideo?: string;\n  applicationTemplate?: string;\n  applicationShowcase?: string;\n  history?: {\n    version: string;\n    date: string;\n    changes: string;\n  }[];\n};\n\nexport const formatMetadata = (\n  docKey: string,\n  file: string,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): FileMetadata => {\n  const metadata = getMarkdownMetadata(file);\n\n  const slugs = (metadata.slugs ?? []).map(String);\n  const keywords = (metadata.keywords ?? []).map(String);\n\n  const relativeUrl = join('/', ...slugs);\n\n  const slicedDocKey = docKey.slice(1);\n\n  // Normalise author: accept both a plain string handle (new format)\n  // and a legacy object `{ github: '...' }` — always reduce to a plain string.\n  const rawAuthor = metadata.author as\n    | string\n    | { name?: string; github?: string }\n    | undefined;\n  const author: string | undefined =\n    typeof rawAuthor === 'string'\n      ? rawAuthor || undefined\n      : rawAuthor?.github || undefined;\n\n  return {\n    ...metadata,\n    docKey,\n    slugs,\n    keywords,\n    author,\n    githubUrl: `${GITHUB_URL_PREFIX}${slicedDocKey}`.replace(\n      '/en/',\n      `/${locale}/`\n    ),\n    relativeUrl: getLocalizedUrl(relativeUrl, locale),\n    url: getLocalizedUrl(join(URL_PREFIX, relativeUrl), locale),\n  } as FileMetadata;\n};\n\nexport const getFileMetadata = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n  R extends FileMetadata,\n>(\n  files: F,\n  docKey: keyof F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<R> => {\n  const file = await getFile(files, docKey, locale);\n\n  return formatMetadata(docKey as string, file, locale) as R;\n};\n\nexport const getFileMetadataRecord = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  locale: LocalesValues = defaultLocale as LocalesValues\n): Promise<Record<keyof F, FileMetadata>> => {\n  const results = await Promise.allSettled(\n    Object.entries(files).map(async ([key]) => {\n      const metadata = await getFileMetadata(files, key as keyof F, locale);\n      return [key, metadata] as [string, FileMetadata];\n    })\n  );\n  const filesEntries = results\n    .filter(\n      (r): r is PromiseFulfilledResult<[string, FileMetadata]> =>\n        r.status === 'fulfilled'\n    )\n    .map((r) => r.value);\n  const filesResult = Object.fromEntries(filesEntries);\n  return filesResult as Record<keyof F, FileMetadata>;\n};\n\nexport const getFileMetadataBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray: FileMetadata[] = Object.values(filesMetadata).filter(\n    (fileMetadata) =>\n      slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  if (locale !== defaultLocale) {\n    const localizedFileMetadata = await Promise.all(\n      fileMetadataArray.map(\n        async (fileMetadata) =>\n          await getFileMetadata(files, fileMetadata.docKey, locale)\n      )\n    );\n\n    return localizedFileMetadata;\n  }\n\n  return fileMetadataArray;\n};\n\nexport const getFileBySlug = async <\n  F extends Record<string, Record<LocalesValues, Promise<string>>>,\n>(\n  files: F,\n  slugs: string | string[],\n  locale: LocalesValues = defaultLocale as LocalesValues,\n  strict = false\n) => {\n  const slugsArray = Array.isArray(slugs) ? slugs : [slugs];\n  const filesMetadata = await getFileMetadataRecord(\n    files,\n    defaultLocale as LocalesValues\n  );\n\n  let fileMetadataArray = Object.values(filesMetadata).filter((fileMetadata) =>\n    slugsArray.every((slug) => fileMetadata.slugs?.includes(slug))\n  );\n\n  if (strict) {\n    fileMetadataArray = fileMetadataArray.filter(\n      (fileMetadata) => fileMetadata.slugs.length === slugsArray.length\n    );\n  }\n\n  const fileList = await Promise.all(\n    fileMetadataArray.map(async (fileMetadata) => {\n      const file = await getFile(files, fileMetadata.docKey, locale);\n      return file;\n    })\n  );\n\n  return fileList;\n};\n"],"mappings":"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"}