@intlayer/ai 7.3.0-canary.0

package/README.md

@@ -0,0 +1,275 @@
+<p align="center">
+  <a href="https://intlayer.org" rel="">
+    <img src="https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/cover.png" width="60%" alt="Intlayer Logo" />
+  </a>
+</p>
+
+<h1 align="center">
+  <strong> Intlayer : an Open-source, per-component i18n toolkit with AI-powered translation & CMS.</strong>
+</h1>
+
+<br />
+
+<p align="center">
+  <a href="https://intlayer.org/doc/concept/content" rel="">Docs</a> •
+  <a href="https://intlayer.org/doc/environment/nextjs" rel="">Next.js</a> •
+  <a href="https://intlayer.org/doc/environment/vite-and-react" rel="">React + Vite</a> •
+  <a href="https://intlayer.org/doc/concept/cms" rel="">CMS</a> •
+  <a href="https://discord.gg/7uxamYVeCk" rel="noopener noreferrer nofollow">Discord</a>
+</p>
+<p align="center" style="margin-top:15px;">
+  <a href="https://www.npmjs.com/package/intlayer" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/npm/v/intlayer?style=for-the-badge&labelColor=FFFFFF&color=000000&logoColor=FFFFFF" alt="npm version" height="24"/></a>
+  <a href="https://github.com/aymericzip/intlayer/stargazers" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logo=github&logoColor=FFD700" alt="GitHub Stars" height="24"/></a>
+  <a href="https://www.npmjs.org/package/intlayer" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/npm/dm/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000&cacheSeconds=86400" alt="monthly downloads" height="24"/></a>
+  <a href="https://github.com/aymericzip/intlayer/blob/main/LICENSE" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/github/license/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000&cacheSeconds=86400" alt="license"/></a>
+  <a href="https://github.com/aymericzip/intlayer/commits/main" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000&cacheSeconds=86400" alt="last commit"/>
+  </a>
+</p>
+
+![Watch the video](https://github.com/aymericzip/intlayer/blob/main/docs/assets/demo_video.gif)
+
+<a href="https://intlayer.org/doc/concept/content" rel="">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## What is Intlayer?
+
+Most i18n libraries are either too complex, too rigid, or not built for modern frameworks.
+
+Intlayer is a **modern i18n solution** for web and mobile apps.  
+It’s framework-agnostic, **AI-powered**, and includes a free **CMS & visual editor**.
+
+With **per-locale content files**, **TypeScript autocompletion**, **tree-shakable dictionaries**, and **CI/CD integration**, Intlayer makes internationalization **faster, cleaner, and smarter**.
+
+## Keys benefits of Intlayer:
+
+| Feature                                                                                                                                             | Description                                                                                                                                                                                                                                                                                                                                                                                    |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **Cross-Frameworks Support**<br><br>Intlayer is compatible with all major frameworks and libraries, including Next.js, React, Vite, Vue.js, Nuxt, Preact, Express, and more.                                                                                                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true" alt="Feature" width="700">       | **JavaScript-Powered Content Management**<br><br>Harness the flexibility of JavaScript to define and manage your content efficiently. <br><br> - [Content declaration](https://intlayer.org/doc/concept/content)                                                                                                                                                                               |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **Per-Locale Content Declaration File**<br><br>Speed up your development by declaring your content once, before auto generation.<br><br> - [Per-Locale Content Declaration File](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **Type-Safe Environment**<br><br>Leverage TypeScript to ensure your content definitions and code are error-free, while also benefiting from IDE autocompletion.<br><br> - [TypeScript configuration](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                 |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **Simplified Setup**<br><br>Get up and running quickly with minimal configuration. Adjust settings for internationalization, routing, AI, build, and content handling with ease. <br><br> - [Explore Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **Simplified Content Retrieval**<br><br>No need to call your `t` function for each piece of content. Retrieve all your content directly using a single hook.<br><br> - [React integration](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **Consistent Server Component Implementation**<br><br>Perfectly suited for Next.js server components, use the same implementation for both client and server components, no need to pass your `t` function across each server component. <br><br> - [Server Components](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                       |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **Organized Codebase**<br><br>Keep your codebase more organized: 1 component = 1 dictionary in the same folder. Translations close to their respective components, enhance maintainability and clarity. <br><br> - [How Intlayer works](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Feature" width="700">                         | **Enhanced Routing**<br><br>Full support of app routing, adapting seamlessly to complex application structures, for Next.js, React, Vite, Vue.js, etc.<br><br> - [Explore Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                    |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Markdown Support**<br><br>Import and interpret, locale files and remote Markdown for multilingual content like privacy policies, documentation, etc. Interpret and make Markdown metadata accessible in your code.<br><br> - [Content files](https://intlayer.org/doc/concept/content/file)                                                                                                  |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **Free Visual Editor & CMS**<br><br>A free visual editor and CMS are available for content writers, removing the need for a localization platform. Keep your content synchronized using Git, or externalize it totally or partially with the CMS.<br><br> - [Intlayer Editor](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)             |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **Tree-shakable Content**<br><br>Tree-shakable content, reducing the size of the final bundle. Loads content per component, excluding any unused content from your bundle. Supports lazy loading to enhance app loading efficiency. <br><br> - [App build optimization](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **Static Rendering**<br><br>Doesn't block Static Rendering. <br><br> - [Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                      |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **AI-Powered Translation**<br><br>Transform your website into 231 languages with just one click using Intlayer's advanced AI-powered translation tools using your own AI provider / API key. <br><br> - [CI/CD integration](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [Auto fill](https://intlayer.org/doc/concept/auto-fill) |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **MCP Server Integration**<br><br>Provides an MCP (Model Context Protocol) server for IDE automation, enabling seamless content management and i18n workflows directly within your development environment. <br><br> - [MCP Server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)                                                                               |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **VSCode Extension**<br><br>Intlayer provides a VSCode extension to help you manage your content and translations, building your dictionaries, translating your content, and more. <br><br> - [VSCode Extension](https://intlayer.org/doc/vs-code-extension)                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **Interoperability**<br><br>Allow interoperability with react-i18next, next-i18next, next-intl, and react-intl. <br><br> - [Intlayer and react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer and next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer and next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next)           |
+
+---
+
+## 📦 Installation
+
+Start your journey with Intlayer today and experience a smoother, more powerful approach to internationalization.
+
+<a href="https://intlayer.org/doc/concept/content" rel="">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+```bash
+npm install intlayer react-intlayer
+```
+
+⚡ Quick Start (Next.js)
+
+```ts
+// intlayer.config.ts
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```ts
+// app/home.content.ts
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  key: "home",
+  content: {
+    title: t({
+      en: "Home",
+      fr: "Accueil",
+      es: "Inicio",
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+```tsx
+// app/page.tsx
+import { useIntlayer } from "react-intlayer";
+
+const HomePage = () => {
+  const { title } = useIntlayer("home");
+
+  return <h1>{title}</h1>;
+};
+```
+
+<a href="https://intlayer.org/doc/environment/nextjs"> Get the full guide → </a>
+
+## 🎥 Live tutorial on YouTube
+
+[![How to Internationalize your application using Intlayer](https://i.ytimg.com/vi/e_PPG7PTqGU/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDtyJ4uYotEjl12nZ_gZKZ_kjEgOQ)](https://youtu.be/e_PPG7PTqGU?si=GyU_KpVhr61razRw)
+
+<a href="https://intlayer.org/doc/concept/content" rel="">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## Table of Contents
+
+Explore our comprehensive documentation to get started with Intlayer and learn how to integrate it into your projects.
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">📘 Get Started</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/why" rel=''>Why Intlayer?</a></li>
+  <li><a href="https://intlayer.org/doc" rel=''>Introduction</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">⚙️ Concept</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/concept/how-works-intlayer" rel=''>How Intlayer Works</a></li>
+  <li><a href="https://intlayer.org/doc/concept/configuration" rel=''>Configuration</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cli" rel=''>Intlayer CLI</a></li>
+  <li><a href="https://intlayer.org/doc/concept/editor" rel=''>Intlayer Editor</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cms" rel=''>Intlayer CMS</a></li>
+  <li><a href="https://intlayer.org/doc/concept/content" rel=''>Dictionary</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/concept/content/per-locale-file" rel=''>Per-Locale Content Declaration File</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/translation" rel=''>Translation</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/enumeration" rel=''>Enumeration</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/condition" rel=''>Condition</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/nesting" rel=''>Nesting</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/markdown" rel=''>Markdown</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/function-fetching" rel=''>Function Fetching</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/insertion" rel=''>Insertion</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/file" rel=''>File</a></li>
+    </ul>
+  </li>
+</ul>
+</details>
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">🌐 Environment</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/environment/nextjs" rel=''>Intlayer with Next.js 16</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/15" rel=''>Next.js 15</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/14" rel=''>Next.js 14 (App Router)</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-Page-Router" rel=''>Next.js Page Router</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/create-react-app" rel=''>React CRA</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React</a>
+     <ul>
+      <li><a href="https://intlayer.org/doc/environment/vite-and-react/react-router-v7" rel=''>React-router-v7</a></li>
+      <li><a href="https://intlayer.org/doc/environment/vite-and-react/tanstack-start" rel=''>Tanstack start</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/react-native-and-expo" rel=''>React Native</a></li>
+  <li><a href="https://intlayer.org/doc/environment/lynx-and-react" rel=''>Lynx + React</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-svelte" rel=''>Vite + Svelte</a></li>
+  <li><a href="https://intlayer.org/doc/environment/sveltekit" rel=''>SvelteKit</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-preact" rel=''>Vite + Preact</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-nuxt" rel=''>Vite + Nuxt</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
+  <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
+  <li><a href="https://intlayer.org/doc/environment/nest" rel=''>NestJS</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">📰 Blog</summary>
+<ul>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/blog/en/what_is_internationalization.md" rel=''>What is i18n</a></li>
+  <li><a href="https://intlayer.org/blog/SEO-and-i18n" rel=''>i18n and SEO</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-i18next" rel=''>Intlayer and i18next</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-react-i18next" rel=''>Intlayer and react-intl</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-intl" rel=''>Intlayer and next-intl</a></li>
+</ul>
+</details>
+
+## 🌐 Readme in other languages
+
+<p align="center">
+  <a href="https://github.com/aymericzip/intlayer/blob/main/readme.md">English</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/readme.md">简体中文</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/readme.md">Русский</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/readme.md">日本語</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/readme.md">Français</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/readme.md">한국어</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/readme.md">Español</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/readme.md">Deutsch</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/readme.md">العربية</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/readme.md">Italiano</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/readme.md">English (UK)</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/readme.md">Português</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/readme.md">हिन्दी</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/readme.md">Türkçe</a>
+</p>
+
+## 🤝 Community
+
+Intlayer is built with and for the community and we’d love your input!
+
+- Have a suggestion? [Open an issue](https://github.com/aymericzip/intlayer/issues)
+- Found a bug or improvement? [Submit a PR](https://github.com/aymericzip/intlayer/pulls)
+- Need help or want to connect? [Join our Discord](https://discord.gg/7uxamYVeCk)
+
+You can also follow us on :
+
+  <div>
+    <br/>
+    <p align="center">
+      <a href="https://discord.gg/528mBV4N" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/discord-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white"
+         alt="Intlayer Discord" height="30"/></a>
+      <a href="https://www.linkedin.com/company/intlayerorg" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/linkedin-%231DA1F2.svg?style=for-the-badge&logo=linkedin&logoColor=white"
+         alt="Intlayer LinkedIn" height="30"/></a>
+      <a href="https://www.instagram.com/intlayer/" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/instagram-%23E4405F.svg?style=for-the-badge&logo=Instagram&logoColor=white"
+         alt="Intlayer Instagram" height="30"/></a>
+      <a href="https://x.com/Intlayer183096" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/x-1DA1F2.svg?style=for-the-badge&logo=x&logoColor=white"
+         alt="Intlayer X" height="30"/></a>
+      <a href="https://www.youtube.com/@intlayer" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/youtube-FF0000.svg?style=for-the-badge&logo=youtube&logoColor=white"
+         alt="Intlayer YouTube" height="30"/></a>
+      <a href="https://www.tiktok.com/@intlayer" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/tiktok-000000.svg?style=for-the-badge&logo=tiktok&logoColor=white"
+         alt="Intlayer TikTok" height="30"/></a>
+      <br>
+    </p>
+</div>
+
+### Contribution
+
+For more detailed guidelines on contributing to this project, please refer to the [`CONTRIBUTING.md`](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md) file. It contains essential information on our development process, commit message conventions, and release procedures. Your contributions are valuable to us, and we appreciate your efforts in making this project better!
+
+### Thank You for the Support
+
+If you like Intlayer, give us a ⭐ on GitHub. It helps others discover the project! [See why GitHub Stars matter](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md#why-github-stars-matter-).
+
+[![Star History Chart](https://api.star-history.com/svg?repos=aymericzip/intlayer&type=Date)](https://star-history.com/#aymericzip/intlayer&Date)

package/dist/assets/auditDictionaryMetadata/PROMPT.md

@@ -0,0 +1,73 @@
+Your role is to describe a content declaration.
+
+1. **Terminology:**
+
+- **Dictionary:** A content declaration is a is a file (.ts, .js or .json) that contains the multilingual declaration related to a specific content. A content declaration file is usually related to a specific component, or page or section of a website.
+- **Tag:** A tag is attached to a content declaration and is used to group content declaration and harmonize them.
+
+2. **Audit Requirements:**
+   - **Do Not Alter Structure:** If the file structure is correct, do not modify it. Only add, update, or remove content declarations as necessary.
+   - **Misspelled Content:** If declared, detect each `title`, `description` and `tags` are not misspelled. If some content is misspelled, correct it.
+
+3. **Fields functions:**
+
+- **Title:** The title of the content declaration allows to easily identify it. It should be considered as a readable way to represent the `key` (example: `page-metadata` -> `Page metadata`). It should be a short and descriptive title that accurately reflects the dictionary.
+- **Description:** The description of the content declaration provides a brief summary of the content declaration. It should be a concise and informative description that explains the purpose and content of the dictionary.
+- **Tags:** The tags is an array of strings that represent the key of the tags associated with the content declaration.
+
+**Expected Response:**
+
+After completion, provide only the final title, description and tags fields in a JSON without any Markdown, code block formatting or any additional comments or explanations.
+
+Correct this fields if they are misspelled or do not match the expected content, and / or complete missing title / description / tags.
+
+**Example of expected response:**
+
+The following case is just an example of expected behavior:
+
+- Example of entry:
+
+```ts
+import { t, type Dictionary } from "intlayer";
+import { Metadata } from "next";
+
+const metadataContent = {
+  key: "pricing-metadata",
+  title: "",
+  description:
+    "here a description that doesn't make any sense and should be replaced",
+  content: {
+    title: t({
+      en: "Pricing | Intlayer",
+    }),
+    description: t({
+      en: "Discover our pricing plans and get access to premium features with Intlayer. Choose the plan that suits you best.",
+    }),
+    keywords: t<string[]>({
+      en: ["Pricing", "Subscription"],
+    }),
+  },
+} satisfies Dictionary<Metadata>;
+
+export default metadataContent;
+```
+
+- Example of response:
+
+```json
+{
+  "title": "Pricing page metadata",
+  "description": "Metadata related to the pricing page, includes title, description, keywords, metadata for SEO purpose. It will help search engines understand the content of the page.",
+  "tags": ["page metadata", "pricing page"]
+}
+```
+
+**Application Context**
+
+{{applicationContext}}
+
+**List of existing Tags:**
+
+Here the list of existing tags as a context to help you to pick related ones.
+
+{{tags}}

package/dist/assets/translateJSON/PROMPT.md

@@ -0,0 +1,45 @@
+You are an expert in internationalization, copy writing and content management. Your task is to audit the content declaration files in the project and identify any potential issues or inconsistencies. Provide a detailed report of any issues found, including the file path, line number, and a brief explanation of the issue.
+
+**Instructions:**
+
+2. **Audit Requirements:**
+   - **Consistency:** The dictionary format should be the same as the one provided in entry. You should not rename or translate the entry keys.
+   - **Missing Content:** Identify any missing translations and specify the expected content.
+   - **Misplaced Content:** Detect if any translations are placed under incorrect keys.
+   - **Type Compliance:** Verify that the content types match the declarations (e.g., strings, string arrays).
+
+3. **Modification Guidelines:**
+   - **Do Not Alter Structure:** If the file structure is correct, do not modify it. Only add, update, or remove content declarations as necessary.
+   - **Missing Content:** If one key is missing from the Preset Output Content, or if the Preset Output Content is empty, the output content should be completed by translating the Entry Content to Translate into the output locale.
+   - **Return Only Final File Content:** Provide the updated file content without any additional comments or explanations.
+   - **Manage Localizations:** If the output languages targeted is a variant contains similar languages, as `en` and `en-GB`, consider `en` as English US, and adapt it into `en-GB` as English UK.
+   - **Escape Special Characters:** If the translations contain special characters, escape them using the appropriate escape sequence.
+   - **Respect the tags and description instructions:** If the tags and description instructions are provided, ensure that the audited file adheres to them.
+   - **Consider the Preset Output Content** If Preset Output Content is provided, and coherent with the entry, you can consider reuse it to fill the output file content.
+   - **TypeNode field should not be translated** A value as `{ 'nodeType': 'XXX', ...}` should not be translated.
+
+**Application Context**
+
+{{applicationContext}}
+
+**Mode Instruction:**
+
+{{modeInstructions}}
+
+**Tags Instructions:**
+
+{{tagsInstructions}}
+
+**Dictionary Description:**
+
+{{dictionaryDescription}}
+
+**Preset Output Content:**
+
+- Target Language: {{outputLocale}}
+
+{{presetOutputContent}}
+
+**Expected Response:**
+
+After auditing, provide only the final content of the file as plain text without any Markdown or code block formatting. If no changes are needed, return the file content exactly as it is.

package/dist/cjs/_virtual/_utils_asset.cjs

@@ -0,0 +1,97 @@
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let node_url = require("node:url");
+
+//#region \0utils:asset
+const hereDirname = () => {
+	try {
+		return (0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
+	} catch {
+		return typeof __dirname !== "undefined" ? __dirname : process.cwd();
+	}
+};
+const findDistRoot = (startDir) => {
+	let dir = startDir;
+	for (let i = 0; i < 12; i++) {
+		if ((0, node_path.basename)(dir) === "dist") return dir;
+		const parent = (0, node_path.resolve)(dir, "..");
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+};
+const normalizeFrameFile = (file) => {
+	if (!file) return null;
+	try {
+		if (file.startsWith("file://")) return (0, node_url.fileURLToPath)(file);
+	} catch {}
+	return file;
+};
+/**
+* Returns the directory of the *caller* module that invoked readAsset.
+* Prefers non-virtual frames; falls back to the first real frame.
+*/
+const getCallerDir = () => {
+	const prev = Error.prepareStackTrace;
+	try {
+		Error.prepareStackTrace = (_, structured) => structured;
+		const err = /* @__PURE__ */ new Error();
+		Error.captureStackTrace(err, getCallerDir);
+		/** @type {import('node:vm').CallSite[]} */
+		const frames = err.stack || [];
+		const isVirtualPath = (p) => p.includes(`${node_path.sep}_virtual${node_path.sep}`) || p.includes("/_virtual/");
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (!file) continue;
+			if (file.includes("node:internal") || file.includes(`${node_path.sep}internal${node_path.sep}modules${node_path.sep}`)) continue;
+			if (!isVirtualPath(file)) return (0, node_path.dirname)(file);
+		}
+		for (const frame of frames) {
+			const file = normalizeFrameFile(typeof frame.getFileName === "function" ? frame.getFileName() : null);
+			if (file) return (0, node_path.dirname)(file);
+		}
+	} catch {} finally {
+		Error.prepareStackTrace = prev;
+	}
+	return hereDirname();
+};
+/**
+* Read an asset copied from src/** to dist/assets/**.
+* - './' or '../' is resolved relative to the *caller module's* emitted directory.
+* - otherwise, treat as src-relative.
+*
+* @param {string} relPath - e.g. './PROMPT.md' or 'utils/AI/askDocQuestion/embeddings/<fileKey>.json'
+* @param {BufferEncoding} [encoding='utf8']
+*/
+const readAsset = (relPath, encoding = "utf8") => {
+	const here = hereDirname();
+	const distRoot = findDistRoot(here) ?? (0, node_path.resolve)(here, "..", "..", "dist");
+	const assetsRoot = (0, node_path.join)(distRoot, "assets");
+	const tried = [];
+	/**
+	* Transform dist/(esm|cjs)/... and _virtual/ prefix to clean subpath (Windows-safe)
+	*/
+	const callerSubpath = (0, node_path.relative)(distRoot, getCallerDir()).split("\\").join("/").replace(/^(?:dist\/)?(?:esm|cjs)\//, "").replace(/^_virtual\//, "");
+	if (relPath.startsWith("./") || relPath.startsWith("../")) {
+		const fromCallerAbs = (0, node_path.resolve)(assetsRoot, callerSubpath, relPath);
+		tried.push(fromCallerAbs);
+		if ((0, node_fs.existsSync)(fromCallerAbs)) return (0, node_fs.readFileSync)(fromCallerAbs, encoding);
+	}
+	const directPath = (0, node_path.join)(assetsRoot, relPath);
+	tried.push(directPath);
+	if ((0, node_fs.existsSync)(directPath)) return (0, node_fs.readFileSync)(directPath, encoding);
+	if (callerSubpath) {
+		const nested = (0, node_path.join)(assetsRoot, callerSubpath, relPath);
+		tried.push(nested);
+		if ((0, node_fs.existsSync)(nested)) return (0, node_fs.readFileSync)(nested, encoding);
+	}
+	const msg = [
+		"readAsset: file not found.",
+		"Searched:",
+		...tried.map((p) => `- ${p}`)
+	].join("\n");
+	throw new Error(msg);
+};
+
+//#endregion
+exports.readAsset = readAsset;

package/dist/cjs/aiSdk.cjs

@@ -0,0 +1,93 @@
+let __ai_sdk_anthropic = require("@ai-sdk/anthropic");
+let __ai_sdk_deepseek = require("@ai-sdk/deepseek");
+let __ai_sdk_google = require("@ai-sdk/google");
+let __ai_sdk_mistral = require("@ai-sdk/mistral");
+let __ai_sdk_openai = require("@ai-sdk/openai");
+
+//#region src/aiSdk.ts
+/**
+* Supported AI SDK providers
+*/
+let AIProvider = /* @__PURE__ */ function(AIProvider$1) {
+	AIProvider$1["OPENAI"] = "openai";
+	AIProvider$1["ANTHROPIC"] = "anthropic";
+	AIProvider$1["MISTRAL"] = "mistral";
+	AIProvider$1["DEEPSEEK"] = "deepseek";
+	AIProvider$1["GEMINI"] = "gemini";
+	return AIProvider$1;
+}({});
+const getAPIKey = (accessType, aiOptions, isAuthenticated = false) => {
+	const defaultApiKey = process.env.OPENAI_API_KEY;
+	if (accessType.includes("public")) return aiOptions?.apiKey ?? defaultApiKey;
+	if (accessType.includes("apiKey") && aiOptions?.apiKey) return aiOptions?.apiKey;
+	if (accessType.includes("registered_user") && isAuthenticated) return aiOptions?.apiKey ?? defaultApiKey;
+	if (accessType.includes("premium_user") && isAuthenticated) return aiOptions?.apiKey ?? defaultApiKey;
+};
+const getModel = (provider, userApiKey, userModel, defaultModel = "gpt-5-mini") => {
+	if (userApiKey) {
+		if (provider && provider === AIProvider.OPENAI) return userModel ?? defaultModel;
+		switch (provider) {
+			case AIProvider.ANTHROPIC: return "claude-sonnet-4-5-20250929";
+			case AIProvider.MISTRAL: return "mistral-large-latest";
+			case AIProvider.DEEPSEEK: return "deepseek-coder";
+			case AIProvider.GEMINI: return "gemini-2.5-flash";
+			default: return defaultModel;
+		}
+	}
+	if (userModel || provider) throw new Error("The user should use his own API key to use a custom model");
+	return defaultModel;
+};
+const DEFAULT_PROVIDER = AIProvider.OPENAI;
+const DEFAULT_TEMPERATURE = 1;
+/**
+* Get AI model configuration based on the selected provider and options
+* This function handles the configuration for different AI providers
+*
+* @param options Configuration options including provider, API keys, models and temperature
+* @returns Configured AI model ready to use with generateText
+*/
+const getAIConfig = async (options, isAuthenticated = false) => {
+	const { userOptions, defaultOptions, accessType = ["registered_user"] } = options;
+	const aiOptions = {
+		provider: DEFAULT_PROVIDER,
+		temperature: DEFAULT_TEMPERATURE,
+		...defaultOptions,
+		...userOptions
+	};
+	const apiKey = getAPIKey(accessType, aiOptions, isAuthenticated);
+	if (!apiKey) throw new Error(`API key for ${aiOptions.provider} is missing`);
+	const selectedModel = getModel(aiOptions.provider, apiKey, aiOptions.model, defaultOptions?.model);
+	const protectedOptions = {
+		...aiOptions,
+		apiKey,
+		model: selectedModel
+	};
+	let languageModel;
+	switch (protectedOptions.provider) {
+		case AIProvider.OPENAI:
+			languageModel = (0, __ai_sdk_openai.createOpenAI)({ apiKey })(selectedModel);
+			break;
+		case AIProvider.ANTHROPIC:
+			languageModel = (0, __ai_sdk_anthropic.createAnthropic)({ apiKey })(selectedModel);
+			break;
+		case AIProvider.MISTRAL:
+			languageModel = (0, __ai_sdk_mistral.createMistral)({ apiKey })(selectedModel);
+			break;
+		case AIProvider.DEEPSEEK:
+			languageModel = (0, __ai_sdk_deepseek.createDeepSeek)({ apiKey })(selectedModel);
+			break;
+		case AIProvider.GEMINI:
+			languageModel = (0, __ai_sdk_google.createGoogleGenerativeAI)({ apiKey })(selectedModel);
+			break;
+		default: throw new Error(`Provider ${protectedOptions.provider} not supported`);
+	}
+	return {
+		model: languageModel,
+		temperature: protectedOptions.temperature
+	};
+};
+
+//#endregion
+exports.AIProvider = AIProvider;
+exports.getAIConfig = getAIConfig;
+//# sourceMappingURL=aiSdk.cjs.map

package/dist/cjs/aiSdk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSdk.cjs","names":["DEFAULT_PROVIDER: AIProvider","DEFAULT_TEMPERATURE: number","languageModel: AIConfig['model']"],"sources":["../../src/aiSdk.ts"],"sourcesContent":["import { type anthropic, createAnthropic } from '@ai-sdk/anthropic';\nimport { createDeepSeek, type deepseek } from '@ai-sdk/deepseek';\nimport { createGoogleGenerativeAI, type google } from '@ai-sdk/google';\nimport { createMistral, type mistral } from '@ai-sdk/mistral';\nimport { createOpenAI, type openai } from '@ai-sdk/openai';\nimport type {\n  AssistantModelMessage,\n  generateText,\n  SystemModelMessage,\n  ToolModelMessage,\n  UserModelMessage,\n} from 'ai';\n\ntype AnthropicModel = Parameters<typeof anthropic>[0];\ntype DeepSeekModel = Parameters<typeof deepseek>[0];\ntype MistralModel = Parameters<typeof mistral>[0];\ntype OpenAIModel = Parameters<typeof openai>[0];\ntype GoogleModel = Parameters<typeof google>[0];\n\nexport type Messages = (\n  | SystemModelMessage\n  | UserModelMessage\n  | AssistantModelMessage\n  | ToolModelMessage\n)[];\n\n/**\n * Supported AI models\n */\nexport type Model =\n  | AnthropicModel\n  | DeepSeekModel\n  | MistralModel\n  | OpenAIModel\n  | GoogleModel\n  | (string & {});\n\n/**\n * Supported AI SDK providers\n */\nexport enum AIProvider {\n  OPENAI = 'openai',\n  ANTHROPIC = 'anthropic',\n  MISTRAL = 'mistral',\n  DEEPSEEK = 'deepseek',\n  GEMINI = 'gemini',\n}\n\n/**\n * Common options for all AI providers\n */\nexport type AIOptions = {\n  provider?: AIProvider;\n  model?: Model;\n  temperature?: number;\n  apiKey?: string;\n  applicationContext?: string;\n};\n\n// Define the structure of messages used in chat completions\nexport type ChatCompletionRequestMessage = {\n  role: 'system' | 'user' | 'assistant'; // The role of the message sender\n  content: string; // The text content of the message\n  timestamp?: Date; // The timestamp of the message\n};\n\ntype AccessType = 'apiKey' | 'registered_user' | 'premium_user' | 'public';\n\nconst getAPIKey = (\n  accessType: AccessType[],\n  aiOptions?: AIOptions,\n  isAuthenticated: boolean = false\n) => {\n  const defaultApiKey = process.env.OPENAI_API_KEY;\n\n  if (accessType.includes('public')) {\n    return aiOptions?.apiKey ?? defaultApiKey;\n  }\n\n  if (accessType.includes('apiKey') && aiOptions?.apiKey) {\n    return aiOptions?.apiKey;\n  }\n\n  if (accessType.includes('registered_user') && isAuthenticated) {\n    return aiOptions?.apiKey ?? defaultApiKey;\n  }\n\n  // TODO: Implement premium user access\n  if (accessType.includes('premium_user') && isAuthenticated) {\n    return aiOptions?.apiKey ?? defaultApiKey;\n  }\n\n  return undefined;\n};\n\nconst getModel = (\n  provider: AIProvider,\n  userApiKey: string,\n  userModel?: Model,\n  defaultModel: Model = 'gpt-5-mini'\n): Model => {\n  // If the user uses their own API key, allow custom model selection\n  if (userApiKey) {\n    if (provider && provider === AIProvider.OPENAI) {\n      return userModel ?? defaultModel;\n    }\n\n    switch (provider) {\n      case AIProvider.ANTHROPIC:\n        return 'claude-sonnet-4-5-20250929';\n      case AIProvider.MISTRAL:\n        return 'mistral-large-latest';\n      case AIProvider.DEEPSEEK:\n        return 'deepseek-coder';\n      case AIProvider.GEMINI:\n        return 'gemini-2.5-flash';\n      default:\n        return defaultModel;\n    }\n  }\n\n  // Guard: Prevent custom model usage without a user API key\n  if (userModel || provider) {\n    throw new Error(\n      'The user should use his own API key to use a custom model'\n    );\n  }\n\n  return defaultModel;\n};\n\nexport type AIConfig = Omit<Parameters<typeof generateText>[0], 'prompt'>;\n\nconst DEFAULT_PROVIDER: AIProvider = AIProvider.OPENAI as AIProvider;\nconst DEFAULT_TEMPERATURE: number = 1; // ChatGPT 5 accept only temperature 1\n\nexport type AIConfigOptions = {\n  userOptions?: AIOptions;\n  defaultOptions?: AIOptions;\n  accessType?: AccessType[];\n};\n\n/**\n * Get AI model configuration based on the selected provider and options\n * This function handles the configuration for different AI providers\n *\n * @param options Configuration options including provider, API keys, models and temperature\n * @returns Configured AI model ready to use with generateText\n */\nexport const getAIConfig = async (\n  options: AIConfigOptions,\n  isAuthenticated: boolean = false\n): Promise<AIConfig> => {\n  const {\n    userOptions,\n    defaultOptions,\n    accessType = ['registered_user'],\n  } = options;\n\n  const aiOptions = {\n    provider: DEFAULT_PROVIDER,\n    temperature: DEFAULT_TEMPERATURE,\n    ...defaultOptions,\n    ...userOptions,\n  } satisfies AIOptions;\n\n  const apiKey = getAPIKey(accessType, aiOptions, isAuthenticated);\n\n  // Check if API key is provided\n  if (!apiKey) {\n    throw new Error(`API key for ${aiOptions.provider} is missing`);\n  }\n\n  const selectedModel = getModel(\n    aiOptions.provider,\n    apiKey,\n    aiOptions.model,\n    defaultOptions?.model\n  );\n\n  const protectedOptions = {\n    ...aiOptions,\n    apiKey,\n    model: selectedModel,\n  } satisfies AIOptions;\n\n  let languageModel: AIConfig['model'];\n\n  switch (protectedOptions.provider) {\n    case AIProvider.OPENAI: {\n      languageModel = createOpenAI({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.ANTHROPIC: {\n      languageModel = createAnthropic({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.MISTRAL: {\n      languageModel = createMistral({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.DEEPSEEK: {\n      languageModel = createDeepSeek({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    case AIProvider.GEMINI: {\n      languageModel = createGoogleGenerativeAI({\n        apiKey,\n      })(selectedModel);\n      break;\n    }\n\n    default: {\n      throw new Error(`Provider ${protectedOptions.provider} not supported`);\n    }\n  }\n\n  return {\n    model: languageModel,\n    temperature: protectedOptions.temperature,\n  };\n};\n"],"mappings":";;;;;;;;;;AAwCA,IAAY,oDAAL;AACL;AACA;AACA;AACA;AACA;;;AAuBF,MAAM,aACJ,YACA,WACA,kBAA2B,UACxB;CACH,MAAM,gBAAgB,QAAQ,IAAI;AAElC,KAAI,WAAW,SAAS,SAAS,CAC/B,QAAO,WAAW,UAAU;AAG9B,KAAI,WAAW,SAAS,SAAS,IAAI,WAAW,OAC9C,QAAO,WAAW;AAGpB,KAAI,WAAW,SAAS,kBAAkB,IAAI,gBAC5C,QAAO,WAAW,UAAU;AAI9B,KAAI,WAAW,SAAS,eAAe,IAAI,gBACzC,QAAO,WAAW,UAAU;;AAMhC,MAAM,YACJ,UACA,YACA,WACA,eAAsB,iBACZ;AAEV,KAAI,YAAY;AACd,MAAI,YAAY,aAAa,WAAW,OACtC,QAAO,aAAa;AAGtB,UAAQ,UAAR;GACE,KAAK,WAAW,UACd,QAAO;GACT,KAAK,WAAW,QACd,QAAO;GACT,KAAK,WAAW,SACd,QAAO;GACT,KAAK,WAAW,OACd,QAAO;GACT,QACE,QAAO;;;AAKb,KAAI,aAAa,SACf,OAAM,IAAI,MACR,4DACD;AAGH,QAAO;;AAKT,MAAMA,mBAA+B,WAAW;AAChD,MAAMC,sBAA8B;;;;;;;;AAepC,MAAa,cAAc,OACzB,SACA,kBAA2B,UACL;CACtB,MAAM,EACJ,aACA,gBACA,aAAa,CAAC,kBAAkB,KAC9B;CAEJ,MAAM,YAAY;EAChB,UAAU;EACV,aAAa;EACb,GAAG;EACH,GAAG;EACJ;CAED,MAAM,SAAS,UAAU,YAAY,WAAW,gBAAgB;AAGhE,KAAI,CAAC,OACH,OAAM,IAAI,MAAM,eAAe,UAAU,SAAS,aAAa;CAGjE,MAAM,gBAAgB,SACpB,UAAU,UACV,QACA,UAAU,OACV,gBAAgB,MACjB;CAED,MAAM,mBAAmB;EACvB,GAAG;EACH;EACA,OAAO;EACR;CAED,IAAIC;AAEJ,SAAQ,iBAAiB,UAAzB;EACE,KAAK,WAAW;AACd,qDAA6B,EAC3B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,2DAAgC,EAC9B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,uDAA8B,EAC5B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,yDAA+B,EAC7B,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,KAAK,WAAW;AACd,iEAAyC,EACvC,QACD,CAAC,CAAC,cAAc;AACjB;EAGF,QACE,OAAM,IAAI,MAAM,YAAY,iBAAiB,SAAS,gBAAgB;;AAI1E,QAAO;EACL,OAAO;EACP,aAAa,iBAAiB;EAC/B"}