@intlayer/docs 9.0.0-canary.3 → 9.0.0-canary.5

package/docs/hi/interest_of_intlayer.md

@@ -30,6 +30,10 @@ author: aymericzip
 
 # आपको Intlayer पर विचार क्यों करना चाहिए?
 
+## Intlayer क्या है?
+
+**Intlayer** एक अंतर्राष्ट्रीकरण लाइब्रेरी है जो विशेष रूप से JavaScript डेवलपर्स के लिए डिज़ाइन की गई है। यह आपको अपने कोड में कहीं भी अपनी सामग्री घोषित करने की अनुमति देता है। यह बहुभाषी सामग्री की घोषणाओं को संरचित शब्दकोश में परिवर्तित करता है जो आसानी से आपके कोड में एकीकृत हो सकता है। TypeScript का उपयोग करते हुए, **Intlayer** आपके विकास को मजबूत और अधिक कुशल बनाता है।
+
 ## विकल्पों पर इन्टलेयर क्यों?
 
 `नेक्स्ट-इंटल` या `आई18नेक्स्ट` जैसे मुख्य समाधानों की तुलना में, इंटलेयर एक ऐसा समाधान है जो एकीकृत अनुकूलन के साथ आता है जैसे:
@@ -68,6 +72,196 @@ author: aymericzip
 
 ---
 
+## Intlayer क्यों बनाया गया?
+
+Intlayer को एक सामान्य समस्या को हल करने के लिए बनाया गया था जो सभी सामान्य i18n libraries को प्रभावित करती है जैसे `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl`, और `vue-i18n`।
+
+ये सभी समाधान आपकी content को list और manage करने के लिए एक centralized approach अपनाते हैं। उदाहरण के लिए:
+
+```bash
+.
+├── locales
+│   ├── en.json
+│   ├── es.json
+│   └── fr.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+या यहाँ namespaces का उपयोग करते हुए:
+
+```bash
+.
+├── locales
+│   ├── en
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   ├── fr
+│   │  ├── footer.json
+│   │  └── navbar.json
+│   └── es
+│      ├── footer.json
+│      └── navbar.json
+├── i18n.ts
+└── src
+    └── components
+        └── MyComponent
+            └── index.tsx
+```
+
+इस प्रकार की architecture development process को धीमा करती है और कई कारणों से codebase को maintain करना अधिक जटिल बनाती है:
+
+1. **किसी भी नए component के लिए, आपको:**
+   - `locales` फ़ोल्डर में नया resource/namespace बनाना चाहिए
+   - अपने page में नए namespace को import करना याद रखना चाहिए
+   - अपनी content का अनुवाद करना चाहिए (अक्सर AI providers से manually copy/paste द्वारा किया जाता है)
+
+2. **आपके components में किए गए किसी भी change के लिए, आपको:**
+   - संबंधित resource/namespace को search करना चाहिए (component से दूर)
+   - अपनी content का अनुवाद करना चाहिए
+   - सुनिश्चित करना चाहिए कि आपकी content किसी भी locale के लिए updated है
+   - verify करना चाहिए कि आपका namespace unusedkeys/values को include नहीं करता है
+   - सुनिश्चित करना चाहिए कि आपकी JSON files की structure सभी locales के लिए समान है
+
+इन समाधानों का उपयोग करने वाली professional projects पर, localization platforms का उपयोग अक्सर आपकी content के अनुवाद को manage करने में मदद के लिए किया जाता है। हालांकि, यह बड़ी projects के लिए तेजी से costly हो सकता है।
+
+इस समस्या को हल करने के लिए, Intlayer एक approach अपनाता है जो आपकी content को per-component scope करता है और अपनी content को आपके component के करीब रखता है, जैसे हम अक्सर CSS (`styled-components`), types, documentation (`storybook`), या unit tests (`jest`) के साथ करते हैं।
+
+```bash codeFormat="typescript"
+.
+└── components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.test.tsx
+        ├── index.stories.tsx
+        └── index.tsx
+```
+
+```bash codeFormat="commonjs"
+.
+└── components
+    └── MyComponent
+        ├── index.content.cjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
+```
+
+```bash codeFormat="esm"
+.
+└── components
+    └── MyComponent
+        ├── index.content.mjs
+        ├── index.test.mjs
+        ├── index.stories.mjs
+        └── index.tsx
+```
+
+```tsx fileName="./components/MyComponent/index.content.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { t, type Dictionary } from "intlayer";
+
+// component की content define करें
+const componentExampleContent = {
+  key: "component-example",
+  content: {
+    myTranslatedContent: t({
+      hi: "नमस्ते दुनिया",
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentExampleContent;
+```
+
+```tsx fileName="./components/MyComponent/index.tsx" codeFormat={["typescript", "esm"]}
+import { useIntlayer } from "react-intlayer";
+
+export const ComponentExample = () => {
+  const { myTranslatedContent } = useIntlayer("component-example");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+यह approach आपको निम्नलिखित की अनुमति देता है:
+
+1. **Development की speed को बढ़ाएं**
+   - `.content.{{ts|mjs|cjs|json}}` files को VSCode extension का उपयोग करके बनाया जा सकता है
+   - आपके IDE में Autocompletion AI tools (जैसे GitHub Copilot) आपकी content को declare करने में मदद कर सकते हैं, copy/paste को कम कर सकते हैं
+
+2. **अपने codebase को साफ़ करें**
+   - Complexity को कम करें
+   - Maintainability को बढ़ाएं
+
+3. **अपने components और उनकी संबंधित content को आसानी से duplicate करें (उदाहरण: login/register components, आदि)**
+   - अन्य components की content को प्रभावित करने के जोखिम को सीमित करके
+   - एक application से दूसरे में अपनी content को external dependencies के बिना copy/paste करके
+
+4. **अपने codebase को unused keys/values से अप्रयुक्त components के साथ प्रदूषित करने से बचें**
+   - यदि आप किसी component का उपयोग नहीं करते हैं, तो Intlayer इसकी संबंधित content को import नहीं करेगा
+   - यदि आप किसी component को delete करते हैं, तो आप आसानी से याद रखेंगे कि इसकी संबंधित content को हटा दें क्योंकि यह एक ही folder में present होगी
+
+5. **AI agents के लिए reasoning cost को कम करें अपनी multilingual content को declare करने के लिए**
+   - AI agent को यह जानने के लिए अपने पूरे codebase को scan नहीं करना पड़ेगा कि आपकी content को कहाँ implement करना है
+   - अनुवाद आसानी से आपके IDE में autocompletion AI tools (जैसे GitHub Copilot) द्वारा किए जा सकते हैं
+
+6. **Loading performance को optimize करें**
+   - यदि कोई component lazy-loaded है, तो इसकी संबंधित content एक ही समय में load होगी
+
+## Intlayer की अतिरिक्त विशेषताएं
+
+| विशेषता                                                                                                                   | विवरण                                                                                                                                                                                                                                                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **Cross-Frameworks Support**<br><br>Intlayer सभी प्रमुख frameworks और libraries के साथ संगत है, जिसमें Next.js, React, Vite, Vue.js, Nuxt, Preact, Express, और बहुत कुछ शामिल है।                                                                                                                                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **JavaScript-Powered Content Management**<br><br>अपनी content को कुशलतापूर्वक define और manage करने के लिए JavaScript की flexibility का लाभ उठाएं। <br><br> - [Content declaration](https://intlayer.org/doc/concept/content)                                                                                                                                                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **Compiler**<br><br>Intlayer Compiler स्वचालित रूप से components से content निकालता है और dictionary files generate करता है।<br><br> - [Compiler](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **Per-Locale Content Declaration File**<br><br>Auto generation से पहले एक बार अपनी content declare करके अपने development को तेज़ करें।<br><br> - [Per-Locale Content Declaration File](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                 |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **Type-Safe Environment**<br><br>अपनी content definitions और code को error-free रखने के लिए TypeScript का लाभ उठाएं, साथ ही IDE autocompletion का भी लाभ लें।<br><br> - [TypeScript configuration](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                             |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **Simplified Setup**<br><br>न्यूनतम configuration के साथ तेजी से शुरुआत करें। Internationalization, routing, AI, build, और content handling के लिए settings को आसानी से adjust करें। <br><br> - [Explore Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                               |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true)                   | **Simplified Content Retrieval**<br><br>प्रत्येक content के लिए अपने `t` function को call करने की आवश्यकता नहीं। एक single hook का उपयोग करके सीधे अपनी सभी content retrieve करें।<br><br> - [React integration](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                  |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true)                    | **Consistent Server Component Implementation**<br><br>Next.js server components के लिए perfectly suited, client और server दोनों components के लिए एक ही implementation का उपयोग करें, अपने `t` function को प्रत्येक server component में pass करने की आवश्यकता नहीं। <br><br> - [Server Components](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true)                           | **Organized Codebase**<br><br>अपने codebase को अधिक organized रखें: 1 component = 1 dictionary एक ही folder में। उनके respective components के करीब translations maintainability और clarity को बढ़ाते हैं। <br><br> - [How Intlayer works](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true)                         | **Enhanced Routing**<br><br>App routing का पूर्ण support, complex application structures को seamlessly adapt करता है, Next.js, React, Vite, Vue.js, आदि के लिए।<br><br> - [Explore Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true)                            | **Markdown Support**<br><br>Locale files और remote Markdown को import और interpret करें multilingual content जैसे privacy policies, documentation, आदि के लिए। Markdown metadata को interpret करें और अपने code में accessible बनाएं।<br><br> - [Content files](https://intlayer.org/doc/concept/content/file)                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true)                       | **Free Visual Editor & CMS**<br><br>एक free visual editor और CMS content writers के लिए उपलब्ध हैं, localization platform की आवश्यकता को हटाते हुए। अपनी content को Git का उपयोग करके synchronized रखें, या इसे totally या partially externalize करें CMS के साथ।<br><br> - [Intlayer Editor](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)       |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true)                              | **Tree-shakable Content**<br><br>Tree-shakable content, final bundle के size को reduce करता है। प्रत्येक component के लिए content load करता है, अपने bundle से किसी भी unused content को exclude करता है। Lazy loading को support करता है app loading efficiency को enhance करने के लिए। <br><br> - [App build optimization](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization) |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true)                    | **Static Rendering**<br><br>Static Rendering को block नहीं करता। <br><br> - [Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                           |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true)                      | **AI-Powered Translation**<br><br>Intlayer के advanced AI-powered translation tools का उपयोग करके अपनी website को 231 languages में transform करें, अपने 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)        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true)                                 | **MCP Server Integration**<br><br>एक MCP (Model Context Protocol) server provide करता है IDE automation के लिए, अपने development environment में directly seamless content management और i18n workflows को enable करता है। <br><br> - [MCP Server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/mcp_server.md)                                                                          |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true)                    | **VSCode Extension**<br><br>Intlayer एक VSCode extension provide करता है आपकी content और translations को manage करने में मदद करने के लिए, अपने dictionaries को build करना, अपनी content को translate करना, और बहुत कुछ। <br><br> - [VSCode Extension](https://intlayer.org/doc/vs-code-extension)                                                                                                        |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true)                    | **Interoperability**<br><br>react-i18next, next-i18next, next-intl, और react-intl के साथ interoperability allow करता है। <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)            |
+| Testing Missing Translations (CLI/CI)                                                                                     | ✅ CLI: npx intlayer content test (CI-friendly audit)                                                                                                                                                                                                                                                                                                                                                    |
+
+## Intlayer की अन्य समाधानों के साथ तुलना
+
+| Feature                                                  | `intlayer`                                                                                                                                                      | `react-i18next`                                                                                                        | `react-intl` (FormatJS)                                                                                                                        | `lingui`                                                                  | `next-intl`                                                                                                            | `next-i18next`                                                                                                         | `vue-i18n`                                                    |
+| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| **Components के पास अनुवाद**                             | ✅ हाँ, content प्रत्येक component के साथ collocated                                                                                                            | ❌ नहीं                                                                                                                | ❌ नहीं                                                                                                                                        | ❌ नहीं                                                                   | ❌ नहीं                                                                                                                | ❌ नहीं                                                                                                                | ✅ हाँ - `Single File Components` (SFCs) का उपयोग करके        |
+| **TypeScript एकीकरण**                                    | ✅ उन्नत, auto-generated सख्त types                                                                                                                             | ⚠️ बुनियादी; सुरक्षा के लिए अतिरिक्त config                                                                            | ✅ अच्छा, लेकिन कम सख्त                                                                                                                        | ⚠️ Typings, config की आवश्यकता                                            | ✅ अच्छा                                                                                                               | ⚠️ बुनियादी                                                                                                            | ✅ अच्छा (types उपलब्ध; key-safety को setup की आवश्यकता)      |
+| **लापता अनुवाद का पता लगाना**                            | ✅ TypeScript error हाइलाइट और build-time error/warning                                                                                                         | ⚠️ ज्यादातर runtime पर fallback strings                                                                                | ⚠️ Fallback strings                                                                                                                            | ⚠️ अतिरिक्त config की आवश्यकता                                            | ⚠️ Runtime fallback                                                                                                    | ⚠️ Runtime fallback                                                                                                    | ⚠️ Runtime fallback/warnings (configurable)                   |
+| **Rich Content (JSX/Markdown/components)**               | ✅ सीधे समर्थन                                                                                                                                                  | ⚠️ सीमित / interpolation केवल                                                                                          | ⚠️ ICU syntax, वास्तविक JSX नहीं                                                                                                               | ⚠️ सीमित                                                                  | ❌ Rich nodes के लिए डिज़ाइन नहीं किया गया                                                                             | ⚠️ सीमित                                                                                                               | ⚠️ सीमित (components via `<i18n-t>`, Markdown via plugins)    |
+| **AI-चालित अनुवाद**                                      | ✅ हाँ, कई AI providers को समर्थन करता है। अपनी API keys का उपयोग करके उपयोग किया जा सकता है। आपके application और content scope के context को ध्यान में रखता है | ❌ नहीं                                                                                                                | ❌ नहीं                                                                                                                                        | ❌ नहीं                                                                   | ❌ नहीं                                                                                                                | ❌ नहीं                                                                                                                | ❌ नहीं                                                       |
+| **Visual Editor**                                        | ✅ हाँ, local Visual Editor + optional CMS; codebase content को externalize कर सकते हैं; embeddable                                                             | ❌ नहीं / external localization platforms के माध्यम से उपलब्ध                                                          | ❌ नहीं / external localization platforms के माध्यम से उपलब्ध                                                                                  | ❌ नहीं / external localization platforms के माध्यम से उपलब्ध             | ❌ नहीं / external localization platforms के माध्यम से उपलब्ध                                                          | ❌ नहीं / external localization platforms के माध्यम से उपलब्ध                                                          | ❌ नहीं / external localization platforms के माध्यम से उपलब्ध |
+| **Localized Routing**                                    | ✅ हाँ, out of the box localized paths को समर्थन करता है (Next.js & Vite के साथ काम करता है)                                                                    | ⚠️ कोई built-in नहीं, plugins की आवश्यकता है (जैसे `next-i18next`) या custom router config                             | ❌ नहीं, केवल message formatting, routing manual होना चाहिए                                                                                    | ⚠️ कोई built-in नहीं, plugins या manual config की आवश्यकता है             | ✅ Built-in, App Router `[locale]` segment को समर्थन करता है                                                           | ✅ Built-in                                                                                                            | ✅ Built-in                                                   |
+| **Dynamic Route Generation**                             | ✅ हाँ                                                                                                                                                          | ⚠️ Plugin/ecosystem या manual setup                                                                                    | ❌ प्रदान नहीं किया गया                                                                                                                        | ⚠️ Plugin/manual                                                          | ✅ हाँ                                                                                                                 | ✅ हाँ                                                                                                                 | ❌ प्रदान नहीं किया गया (Nuxt i18n प्रदान करता है)            |
+| **Pluralization**                                        | ✅ Enumeration-based patterns                                                                                                                                   | ✅ Configurable (plugins जैसे i18next-icu)                                                                             | ✅ (ICU)                                                                                                                                       | ✅ (ICU/messageformat)                                                    | ✅ अच्छा                                                                                                               | ✅ अच्छा                                                                                                               | ✅ Built-in plural rules                                      |
+| **Formatting (dates, numbers, currencies)**              | ✅ Optimized formatters (Intl के तहत)                                                                                                                           | ⚠️ Plugins के माध्यम से या custom Intl usage                                                                           | ✅ ICU formatters                                                                                                                              | ✅ ICU/CLI helpers                                                        | ✅ अच्छा (Intl helpers)                                                                                                | ✅ अच्छा (Intl helpers)                                                                                                | ✅ Built-in date/number formatters (Intl)                     |
+| **Content Format**                                       | ✅ .tsx, .ts, .js, .json, .md, .txt, (.yaml WIP)                                                                                                                | ⚠️ .json                                                                                                               | ✅ .json, .js                                                                                                                                  | ⚠️ .po, .json                                                             | ✅ .json, .js, .ts                                                                                                     | ⚠️ .json                                                                                                               | ✅ .json, .js                                                 |
+| **ICU support**                                          | ⚠️ WIP                                                                                                                                                          | ⚠️ Plugin के माध्यम से (i18next-icu)                                                                                   | ✅ हाँ                                                                                                                                         | ✅ हाँ                                                                    | ✅ हाँ                                                                                                                 | ⚠️ Plugin के माध्यम से (`i18next-icu`)                                                                                 | ⚠️ Custom formatter/compiler के माध्यम से                     |
+| **SEO Helpers (hreflang, sitemap)**                      | ✅ Built-in tools: sitemap, robots.txt, metadata के लिए helpers                                                                                                 | ⚠️ Community plugins/manual                                                                                            | ❌ Core नहीं                                                                                                                                   | ❌ Core नहीं                                                              | ✅ अच्छा                                                                                                               | ✅ अच्छा                                                                                                               | ❌ Core नहीं (Nuxt i18n helpers प्रदान करता है)               |
+| **Ecosystem / Community**                                | ⚠️ छोटा लेकिन तेजी से बढ़ता हुआ और reactive                                                                                                                     | ✅ सबसे बड़ा और mature                                                                                                 | ✅ बड़ा                                                                                                                                        | ⚠️ छोटा                                                                   | ✅ Mid-size, Next.js-focused                                                                                           | ✅ Mid-size, Next.js-focused                                                                                           | ✅ Vue ecosystem में बड़ा                                     |
+| **Server-side Rendering & Server Components**            | ✅ हाँ, SSR / React Server Components के लिए streamlined                                                                                                        | ⚠️ Page level पर समर्थित लेकिन children server components के लिए component tree पर t-functions पास करने की आवश्यकता है | ⚠️ Page level पर अतिरिक्त set up के साथ समर्थित, लेकिन children server components के लिए component tree पर t-functions पास करने की आवश्यकता है | ✅ समर्थित, setup आवश्यक है                                               | ⚠️ Page level पर समर्थित लेकिन children server components के लिए component tree पर t-functions पास करने की आवश्यकता है | ⚠️ Page level पर समर्थित लेकिन children server components के लिए component tree पर t-functions पास करने की आवश्यकता है | ✅ Nuxt/Vue SSR के माध्यम से SSR (कोई RSC नहीं)               |
+| **Tree-shaking (केवल उपयोग किए गए content को लोड करें)** | ✅ हाँ, Babel/SWC plugins के माध्यम से build time पर per-component                                                                                              | ⚠️ आमतौर पर सभी को लोड करता है (namespaces/code-splitting के साथ सुधार किया जा सकता है)                                | ⚠️ आमतौर पर सभी को लोड करता है                                                                                                                 | ❌ डिफ़ॉल्ट नहीं                                                          | ⚠️ आंशिक                                                                                                               | ⚠️ आंशिक                                                                                                               | ⚠️ आंशिक (code-splitting/manual setup के साथ)                 |
+| **Lazy loading**                                         | ✅ हाँ, per-locale / per-dictionary                                                                                                                             | ✅ हाँ (जैसे, backends/namespaces on demand)                                                                           | ✅ हाँ (split locale bundles)                                                                                                                  | ✅ हाँ (dynamic catalog imports)                                          | ✅ हाँ (per-route/per-locale), namespace management की आवश्यकता है                                                     | ✅ हाँ (per-route/per-locale), namespace management की आवश्यकता है                                                     | ✅ हाँ (async locale messages)                                |
+| **अप्रयुक्त content को साफ करें**                        | ✅ हाँ, build time पर per-dictionary                                                                                                                            | ❌ नहीं, केवल manual namespace segmentation के माध्यम से                                                               | ❌ नहीं, सभी declared messages bundled हैं                                                                                                     | ✅ हाँ, अप्रयुक्त keys का पता लगाया जाता है और build पर drop किए जाते हैं | ❌ नहीं, namespace management के साथ manually प्रबंधित किया जा सकता है                                                 | ❌ नहीं, namespace management के साथ manually प्रबंधित किया जा सकता है                                                 | ❌ नहीं, केवल manual lazy-loading के माध्यम से संभव           |
+| **बड़ी Projects का प्रबंधन**                             | ✅ Modular को प्रोत्साहित करता है, design-system के लिए suited                                                                                                  | ⚠️ अच्छी file discipline की आवश्यकता है                                                                                | ⚠️ Central catalogs बड़े हो सकते हैं                                                                                                           | ⚠️ जटिल हो सकता है                                                        | ✅ Setup के साथ Modular                                                                                                | ✅ Setup के साथ Modular                                                                                                | ✅ Vue Router/Nuxt i18n setup के साथ Modular                  |
+
 ## GitHub सितारे
 
 GitHub सितारे किसी प्रोजेक्ट की लोकप्रियता, सामुदायिक विश्वास और दीर्घकालिक प्रासंगिकता का एक मजबूत संकेतक हैं। हालांकि यह तकनीकी गुणवत्ता का प्रत्यक्ष माप नहीं है, वे दर्शाते हैं कि कितने डेवलपर्स प्रोजेक्ट को उपयोगी पाते हैं, इसकी प्रगति का पालन करते हैं, और इसे अपनाने की संभावना रखते हैं। किसी प्रोजेक्ट के मूल्य का अनुमान लगाने के लिए, सितारे विकल्पों के बीच कर्षण की तुलना करने में मदद करते हैं और पारिस्थितिकी तंत्र के विकास में अंतर्दृष्टि प्रदान करते हैं।

package/docs/hi/intlayer_CMS.md

@@ -40,6 +40,12 @@ Intlayer CMS एक एप्लिकेशन है जो आपको Intla
 
 ![Intlayer CMS इंटरफ़ेस](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png)
 
+## विषय सूची
+
+<TOC/>
+
+---
+
 ## दूरस्थ शब्दकोश को समझना
 
 Intlayer 'स्थानीय' (local) और 'दूरस्थ' (distant) शब्दकोश के बीच अंतर करता है।

package/docs/hi/intlayer_with_adonisjs.md

@@ -59,24 +59,40 @@ See [Application Template](https://github.com/aymericzip/intlayer-adonis-templat
 
 `adonis-intlayer` का उपयोग शुरू करने के लिए, npm का उपयोग करके पैकेज स्थापित करें:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` ध्वज (flag) वैकल्पिक है। यदि आप एक AI एजेंट हैं तो `intlayer-cli init` का उपयोग करें।
+
+> यह कमांड आपके एनवायरनमेंट को डिटेक्ट करेगी और आवश्यक पैकेज इंस्टॉल करेगी। उदाहरण के लिए:
+
 ```bash packageManager="npm"
 npm install intlayer adonis-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer adonis-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer adonis-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer adonis-intlayer
-bun x intlayer init
 ```
 
 ### सेटअप

package/docs/hi/intlayer_with_analog.md

@@ -101,24 +101,40 @@ GitHub पर [एप्लिकेशन टेम्पलेट](https://git
 
 npm का उपयोग करके आवश्यक पैकेज स्थापित करें:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` ध्वज (flag) वैकल्पिक है। यदि आप एक AI एजेंट हैं तो `intlayer-cli init` का उपयोग करें।
+
+> यह कमांड आपके एनवायरनमेंट को डिटेक्ट करेगी और आवश्यक पैकेज इंस्टॉल करेगी। उदाहरण के लिए:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer vite-intlayer
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer vite-intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer vite-intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer vite-intlayer
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/hi/intlayer_with_angular_19.md

@@ -107,28 +107,44 @@ GitHub पर [एप्लिकेशन टेम्पलेट](https://git
 
 npm का उपयोग करके आवश्यक पैकेज स्थापित करें:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` ध्वज (flag) वैकल्पिक है। यदि आप एक AI एजेंट हैं तो `intlayer-cli init` का उपयोग करें।
+
+> यह कमांड आपके एनवायरनमेंट को डिटेक्ट करेगी और आवश्यक पैकेज इंस्टॉल करेगी। उदाहरण के लिए:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer
 npm install @angular-builders/custom-webpack --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer
 pnpm add @angular-builders/custom-webpack --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer
 yarn add @angular-builders/custom-webpack --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer
 bun add @angular-builders/custom-webpack --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/hi/intlayer_with_angular_21.md

@@ -106,28 +106,44 @@ GitHub पर [एप्लिकेशन टेम्पलेट](https://git
 
 npm का उपयोग करके आवश्यक पैकेज स्थापित करें:
 
+```bash packageManager="npm"
+npx intlayer-cli init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer-cli init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer-cli init --interactive
+```
+
+> `--interactive` ध्वज (flag) वैकल्पिक है। यदि आप एक AI एजेंट हैं तो `intlayer-cli init` का उपयोग करें।
+
+> यह कमांड आपके एनवायरनमेंट को डिटेक्ट करेगी और आवश्यक पैकेज इंस्टॉल करेगी। उदाहरण के लिए:
+
 ```bash packageManager="npm"
 npm install intlayer angular-intlayer
 npm install @angular-builders/custom-esbuild --save-dev
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer angular-intlayer
 pnpm add @angular-builders/custom-esbuild --save-dev
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer angular-intlayer
 yarn add @angular-builders/custom-esbuild --save-dev
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer angular-intlayer
 bun add @angular-builders/custom-esbuild --dev
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/hi/intlayer_with_astro.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-03-07
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro i18n - अपने ऐप को अनुवाद करने का पूर्ण गाइड"
 description: "अब i18next की जरूरत नहीं। 2026 में Astro ऐप को बहुभाषी (i18n) बनाने का गाइड। AI एजेंट्स से अनुवाद करें और बंडल साइज़, SEO और परफॉर्मेंस ऑप्टिमाइज़ करें।"
 keywords:
@@ -300,7 +300,134 @@ Astro एकीकरण एक Vite मिडलवेयर जोड़ता
 
 </Step>
 
-<Step number={7} title="अपने पसंदीदा फ्रेमवर्क का उपयोग जारी रखें">
+<Step number={7} title="भाषा स्विचर जोड़ें">
+
+उपयोगकर्ताओं को भाषाओं के बीच स्विच करने की अनुमति देने के लिए, आप एक `LocaleSwitcher` घटक बना सकते हैं। इस घटक को सभी समर्थित भाषाओं की एक सूची प्रदर्शित करनी चाहिए और प्रत्येक भाषा में उसी पृष्ठ पर लिंक करना चाहिए।
+
+```astro fileName="src/components/LocaleSwitcher.astro"
+---
+import {
+  locales,
+  getLocaleName,
+  getLocalizedUrl,
+  getLocaleFromPath,
+  getPathWithoutLocale,
+  type LocalesValues,
+} from "intlayer";
+
+const locale = getLocaleFromPath(Astro.url.pathname) as LocalesValues;
+const pathWithoutLocale = getPathWithoutLocale(Astro.url.pathname);
+---
+
+<nav>
+  {
+    locales.map((localeItem) => (
+      <a
+        href={getLocalizedUrl(pathWithoutLocale, localeItem)}
+        data-locale={localeItem}
+        aria-current={localeItem === locale ? "page" : undefined}
+      >
+        {getLocaleName(localeItem)}
+      </a>
+    ))
+  }
+</nav>
+
+<script>
+  import { setLocaleInStorageClient, getLocalizedUrl, type LocalesValues } from "intlayer";
+
+  const localeLinks = document.querySelectorAll("[data-locale]");
+
+  localeLinks.forEach((link) => {
+    link.addEventListener("click", (e) => {
+      const locale = link.getAttribute("data-locale") as LocalesValues;
+
+      // Update the locale cookie
+      setLocaleInStorageClient(locale);
+    });
+  });
+</script>
+
+<style>
+  nav {
+    display: flex;
+    gap: 1rem;
+  }
+  a[aria-current="page"] {
+    font-weight: bold;
+    text-decoration: underline;
+  }
+</style>
+```
+
+> **स्थिरता पर ध्यान दें:**
+> क्लाइंट-साइड स्क्रिप्ट में `setLocaleInStorageClient` का उपयोग यह सुनिश्चित करता है कि उपयोगकर्ता की भाषा प्राथमिकता कुकी में सहेजी गई है। यह Intlayer मिडलवेयर को विकल्प याद रखने और भविष्य की यात्राओं पर उपयोगकर्ता को स्वचालित रूप से उनकी पसंदीदा भाषा में रीडायरेक्ट करने की अनुमति देता है।
+
+</Step>
+
+<Step number={8} title="Sitemap और Robots.txt">
+
+Intlayer आपकी स्थानीयकृत साइटमैप और robots.txt फ़ाइलों को गतिशील रूप से बनाने के लिए उपयोगिताओं की पेशकश करता है।
+
+#### साइटमैप (Sitemap)
+
+Intlayer comes with a built-in sitemap generator to help you create a sitemap for your application easily. It handles localized routes and adds the necessary metadata for search engines.
+
+> The Intlayer generated sitemap supports the `xhtml:link` namespace (Hreflang XML Extensions). Unlike the default sitemap generators that only list raw URLs, Intlayer automatically creates the required bidirectional links between all language versions of a page (e.g., `/about`, `/about?lang=fr`, and `/about?lang=es`). This ensures search engines correctly index and serve the right language version to the right audience.
+
+अपने सभी स्थानीयकृत रूट सहित साइटमैप उत्पन्न करने के लिए `src/pages/sitemap.xml.ts` बनाएँ।
+
+```typescript fileName="src/pages/sitemap.xml.ts"
+import type { APIRoute } from "astro";
+import { generateSitemap, type SitemapUrlEntry } from "intlayer";
+
+const pathList: SitemapUrlEntry[] = [
+  { path: "/", changefreq: "daily", priority: 1.0 },
+  { path: "/about", changefreq: "monthly", priority: 0.7 },
+];
+
+const SITE_URL = import.meta.env.SITE ?? "http://localhost:4321";
+
+export const GET: APIRoute = async ({ site }) => {
+  const xmlOutput = generateSitemap(pathList, { siteUrl: SITE_URL });
+
+  return new Response(xmlOutput, {
+    headers: { "Content-Type": "application/xml" },
+  });
+};
+```
+
+#### Robots.txt
+
+खोज इंजन क्रॉलिंग को नियंत्रित करने के लिए `src/pages/robots.txt.ts` बनाएँ।
+
+```typescript fileName="src/pages/robots.txt.ts"
+import type { APIRoute } from "astro";
+import { getMultilingualUrls } from "intlayer";
+
+const getAllMultilingualUrls = (urls: string[]) =>
+  urls.flatMap((url) => Object.values(getMultilingualUrls(url)) as string[]);
+
+const disallowedPaths = getAllMultilingualUrls(["/admin", "/private"]);
+
+export const GET: APIRoute = ({ site }) => {
+  const robotsTxt = [
+    "User-agent: *",
+    "Allow: /",
+    ...disallowedPaths.map((path) => `Disallow: ${path}`),
+    "",
+    `Sitemap: ${new URL("/sitemap.xml", site).href}`,
+  ].join("\n");
+
+  return new Response(robotsTxt, {
+    headers: { "Content-Type": "text/plain" },
+  });
+};
+```
+
+</Step>
+
+<Step number={9} title="अपने पसंदीदा फ्रेमवर्क का उपयोग जारी रखें">
 
 अपनी पसंद के फ्रेमवर्क का उपयोग करके अपना एप्लिकेशन बनाना जारी रखें।
 
@@ -311,7 +438,7 @@ Astro एकीकरण एक Vite मिडलवेयर जोड़ता
 - Intlayer + Preact: [Preact के साथ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_with_vite+preact.md)
   </Step>
 
-<Step number={1} title="अपने घटकों की सामग्री निकालें" isOptional={true}>
+<Step number={15} title="अपने घटकों की सामग्री निकालें" isOptional={true}>
 
 यदि आपके पास मौजूदा कोडबेस है, तो हजारों फ़ाइलों को बदलना समय लेने वाला हो सकता है।
 

package/docs/hi/intlayer_with_astro_lit.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Lit i18n - अपने ऐप को अनुवाद करने का पूर्ण गाइड"
 description: "अब i18next की जरूरत नहीं। 2026 में Astro + Lit ऐप को बहुभाषी (i18n) बनाने का गाइड। AI एजेंट्स से अनुवाद करें और बंडल साइज़, SEO और परफॉर्मेंस ऑप्टिमाइज़ करें।"
 keywords:

package/docs/hi/intlayer_with_astro_preact.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-04-24
-updatedAt: 2026-05-31
+updatedAt: 2026-06-23
 title: "Astro + Preact i18n - अपने ऐप को अनुवाद करने का पूर्ण गाइड"
 description: "अब i18next की जरूरत नहीं। 2026 में Astro + Preact ऐप को बहुभाषी (i18n) बनाने का गाइड। AI एजेंट्स से अनुवाद करें और बंडल साइज़, SEO और परफॉर्मेंस ऑप्टिमाइज़ करें।"
 keywords: