@intlayer/docs 9.0.0-canary.4 → 9.0.0-canary.6

package/docs/hi/migration_from_vue-i18n_to_intlayer.md

@@ -0,0 +1,359 @@
+---
+createdAt: 2026-06-05
+updatedAt: 2026-06-05
+title: "vue-i18n से Intlayer में माइग्रेट करें | अंतर्राष्ट्रीयकरण (i18n)"
+description: "सीखें कि अपने Vue या Nuxt ऐप को vue-i18n से Intlayer में कैसे माइग्रेट करें — चरण दर चरण, बिना अपने मौजूदा कोड को तोड़े। शून्य-व्यवधान संक्रमण के लिए @intlayer/vue-i18n compat एडॉप्टर का उपयोग करें।"
+keywords:
+  - vue-i18n
+  - intlayer
+  - migration
+  - internationalization
+  - i18n
+  - Nuxt
+  - Vue
+  - JavaScript
+slugs:
+  - doc
+  - migration
+  - vue-i18n
+history:
+  - version: 9.0.0
+    date: 2026-06-05
+    changes: "प्रारंभिक इतिहास"
+author: aymericzip
+---
+
+# vue-i18n से Intlayer में माइग्रेशन
+
+## vue-i18n से Intlayer में माइग्रेट करने के लिए?
+
+<AccordionGroup>
+
+<Accordion header="बंडल का आकार">
+
+बड़ी JSON फाइलों को अपने पेजों में लोड करने के बजाय, केवल आवश्यक सामग्री लोड करें। Intlayer आपके बंडल और पेज आकारों को **50% तक कम करने में मदद करता है**।
+
+</Accordion>
+
+<Accordion header="रखरखाव">
+
+अपने एप्लिकेशन की सामग्री को स्कोप करना **बड़े पैमाने के एप्लिकेशन के लिए रखरखाव को सुविधाजनक बनाता है**। आप अपने पूरे सामग्री कोडबेस की समीक्षा की मानसिक बोझ के बिना एक भी फीचर फोल्डर को डुप्लिकेट या हटा सकते हैं। इसके अलावा, Intlayer **पूरी तरह से टाइप किया गया है** आपकी सामग्री की सटीकता सुनिश्चित करने के लिए।
+
+Intlayer भी i18n पारिस्थितिकी तंत्र में **सबसे सक्रिय विकास** के साथ समाधान है — समस्याएं तेजी से ठीक की जाती हैं, नई फ्रेमवर्क एडॉप्टर नियमित रूप से आती हैं, और मुख्य API को वास्तविक दुनिया के उत्पादन प्रतिक्रिया के आधार पर निरंतर परिष्कृत किया जाता है।
+
+</Accordion>
+
+<Accordion header="AI एजेंट">
+
+सामग्री को सह-स्थित करना **बड़ी भाषा मॉडल (LLM) द्वारा आवश्यक संदर्भ को कम करता है**। Intlayer साथ ही एक समूह के साथ आता है, जैसे कि **CLI** अनुपलब्ध अनुवादों के लिए परीक्षण करने के लिए, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/mcp_server.md)**, और **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/agent_skills.md)**, डेवलपर अनुभव (DX) को AI एजेंटों के लिए भी मसृण बनाने के लिए।
+
+</Accordion>
+
+<Accordion header="स्वचालन">
+
+अपनी पसंद के LLM का उपयोग करके CI/CD पाइपलाइन में अनुवाद करने के लिए स्वचालन का उपयोग करें आपके AI प्रदाता की लागत पर। Intlayer साथ ही एक **compiler** प्रदान करता है सामग्री निष्कर्षण को स्वचालित करने के लिए, साथ ही एक [web platform](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md) **पृष्ठभूमि में अनुवाद करने में मदद करने के लिए**।
+
+</Accordion>
+
+<Accordion header="कार्यक्षमता">
+
+बड़ी JSON फाइलों को घटकों से जोड़ने से कार्यक्षमता और प्रतिक्रिया समस्याएं हो सकती हैं। Intlayer बिल्ड समय पर आपकी सामग्री लोडिंग को अनुकूलित करता है।
+
+</Accordion>
+
+<Accordion header="गैर-dev के साथ स्केलिंग">
+
+केवल एक i18n समाधान से अधिक, Intlayer एक **self-hosted [visual editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_visual_editor.md)** और एक **[full CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md)** आपकी बहुभाषी सामग्री को प्रबंधित करने में मदद करने के लिए **वास्तविक समय में**, अनुवादक, कॉपीराइटर और अन्य टीम सदस्यों के साथ सहयोग को निर्बाध बनाता है। सामग्री स्थानीय रूप से और/या दूरस्थ रूप से संग्रहीत की जा सकती है।
+
+</Accordion>
+
+</AccordionGroup>
+
+---
+
+## माइग्रेशन रणनीति
+
+`vue-i18n` से Intlayer में माइग्रेट करने के लिए दो पूरक रणनीतियां हैं:
+
+1. **Compat एडॉप्टर (मौजूदा ऐप्स के लिए अनुशंसित)** — `@intlayer/vue-i18n` (Vue घटकों के लिए) स्थापित करें। यह पैकेज `vue-i18n` के **बिल्कुल समान API** को उजागर करता है लेकिन सभी अनुवाद कार्य को हूड के तहत Intlayer को सौंपता है। आप अपने मौजूदा `$t`, `useI18n()`, और `<i18n-t>` कॉल रखते हैं — एकमात्र परिवर्तन import पथ और initialization है।
+
+2. **पूर्ण माइग्रेशन** — धीरे-धीरे `vue-i18n` API को native Intlayer hooks (`useIntlayer`) और सह-स्थित सामग्री के साथ `.content.ts` फाइलों में बदलें।
+
+यह गाइड **रणनीति 1** को पहले कवर करता है (drop-in compat एडॉप्टर), फिर वैकल्पिक पूर्ण माइग्रेशन के माध्यम से चलता है।
+
+---
+
+## विषय सूची
+
+<TOC/>
+
+---
+
+## त्वरित माइग्रेशन
+
+निम्नलिखित चरण अपने मौजूदा `vue-i18n` ऐप को आपके घटकों में बिना कोड परिवर्तन के Intlayer पर चलाने के लिए आवश्यक न्यूनतम हैं।
+
+<Steps>
+
+<Step number={1} title="डिपेंडेंसी स्थापित करें">
+
+Intlayer मुख्य पैकेज और compat एडॉप्टर स्थापित करें:
+
+```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` फ्लैग वैकल्पिक है। अगर आप एक AI एजेंट हैं तो `intlayer-cli init` का उपयोग करें।
+
+> यह कमांड आपके वातावरण का पता लगाएगा और आवश्यक पैकेज स्थापित करेगा। उदाहरण के लिए:
+
+```bash packageManager="npm"
+npm install intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="yarn"
+yarn add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+```bash packageManager="bun"
+bun add intlayer vue-intlayer @intlayer/vue-i18n @intlayer/sync-json-plugin
+```
+
+> आप `vue-i18n` को स्थापित रख सकते हैं — compat एडॉप्टर इसे TypeScript प्रकारों के लिए `devDependency` / `peerDependency` के रूप में उपयोग करता है।
+
+</Step>
+
+<Step number={2} title="Intlayer को कॉन्फ़िगर करें">
+
+`intlayer init` कमांड एक स्टार्टर `intlayer.config.ts` बनाता है। अपने मौजूदा locales से मेल खाने के लिए इसे अपडेट करें और `syncJSON` प्लग-इन को अपनी संदेश फाइलों पर इंगित करें:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH,
+      // अपने सभी मौजूदा locales यहां जोड़ें
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      // vue-i18n प्लेसहोल्डर सिंटैक्स से मेल खाता है: {name}
+      format: "icu",
+      source: ({ locale }) => `./src/locales/${locale}.json`,
+      location: "src/locales",
+    }),
+  ],
+};
+
+export default config;
+```
+
+> **`source`** एक locale को इसकी JSON फाइल पथ पर मैप करता है। **`location`** Intlayer को बताता है कि परिवर्तनों की निगरानी के लिए कौन सा फोल्डर देखना चाहिए। `format: 'icu'` विकल्प सुनिश्चित करता है कि placeholders को `vue-i18n` के लिए सही ढंग से पार्स किया जाता है।
+
+</Step>
+
+<Step number={3} title="अपने Bundler में Intlayer Plugin जोड़ें">
+
+अपने मौजूदा bundler config को compat प्लग-इन से लपेटें। यह core Intlayer प्लग-इन को compose करता है, content watching को wire करता है, और — महत्वपूर्ण रूप से — **एक module एलिएस को injects करता है** ताकि आपके मौजूदा `import … from 'vue-i18n'` कॉल को build समय पर transparently `@intlayer/vue-i18n` पर रीडायरेक्ट किया जा सके। कोई स्रोत फाइल परिवर्तन आवश्यक नहीं है।
+
+**Vite के लिए:**
+
+```typescript fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import { vueI18nVitePlugin } from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+> `vueI18nVitePlugin()` `vite-intlayer` के `intlayer()` प्लग-इन को लपेटता है और `vue-i18n` एलिएस को जोड़ता है। `vite-intlayer` से सादे `intlayer()` प्लग-इन का उपयोग करने से dictionaries को संकलित किया जाता है लेकिन **नहीं** एलिएस को जोड़ता है — आप तब imports को `@intlayer/vue-i18n` पर manually नाम दें (चरण 4 देखें)।
+
+**Nuxt के लिए:**
+
+अगर आप `@nuxtjs/i18n` (Nuxt integration) का उपयोग कर रहे हैं, तो `nuxt-intlayer` स्थापित करें और इसे अपने `nuxt.config.ts` में जोड़ें:
+
+```bash packageManager="npm"
+npm install nuxt-intlayer
+```
+
+```typescript fileName="nuxt.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+export default defineNuxtConfig({
+  modules: ["nuxt-intlayer"],
+  // आप अपने modules से @nuxtjs/i18n को safely हटा सकते हैं
+});
+```
+
+> **आपको अब `createI18n()` या manual provider bootstrapping की आवश्यकता नहीं है।** Intlayer सभी dictionaries को **build समय पर** compile करता है, इसलिए कोई runtime loading चरण नहीं है। एलिएस किए गए provider initialization को आपके लिए हैंडल करता है।
+
+</Step>
+
+</Steps>
+
+त्वरित माइग्रेशन के लिए बस इतना ही। आपका ऐप अब Intlayer पर चलता है जबकि हर `vue-i18n` import और API को बरकरार रखता है।
+
+> **Typed अनुवाद कुंजियां — स्वचालित।** एक बार Intlayer आपके dictionaries को compile कर देने के बाद, `useI18n` एक `namespace` option पास करने पर आपकी वास्तविक सामग्री के विरुद्ध typed होता है। कुंजियां आपके IDE में autocompleted होती हैं और invalid paths build समय पर TypeScript त्रुटियां पैदा करते हैं — कोई अतिरिक्त setup आवश्यक नहीं है।
+>
+> ```ts
+> // 'about' एक registered dictionary key है
+> const { t } = useI18n({ namespace: "about" });
+> t("counter.label"); // ✓ autocompleted
+> t("does.not.exist"); // ✗ TypeScript error
+> ```
+
+---
+
+## पूर्ण माइग्रेशन
+
+नीचे दिए गए चरण वैकल्पिक हैं और वृद्धिशील रूप से किए जा सकते हैं। वे पूर्ण Intlayer फीचर सेट को अनलॉक करते हैं: visual editor, CMS, typed content फाइलें, AI-powered अनुवाद, और बहुत कुछ।
+
+<Steps>
+
+<Step number={4} title="स्पष्ट import नाम देना (वैकल्पिक)" isOptional={true}>
+
+Intlayer प्लग-इन पहले से ही bundler स्तर पर aliasing को हैंडल करते हैं। अगर आप अपनी स्रोत फाइलों में निर्भरता को स्पष्ट बनाना पसंद करते हैं, तो आप imports को manually नाम दे सकते हैं:
+
+| पहले                                    | बाद में                                           |
+| --------------------------------------- | ------------------------------------------------- |
+| `import { useI18n } from 'vue-i18n'`    | `import { useI18n } from '@intlayer/vue-i18n'`    |
+| `import { createI18n } from 'vue-i18n'` | `import { createI18n } from '@intlayer/vue-i18n'` |
+
+ये **drop-in replacements** हैं — कॉल signature, arguments, या return प्रकार में कोई परिवर्तन आवश्यक नहीं है।
+
+</Step>
+
+<Step number={5} title="AI-Powered अनुवाद ऑटोमेशन को सक्षम करें" isOptional={true}>
+
+एक बार Intlayer वायर्ड होने के बाद, अनुपलब्ध अनुवादों को स्वचालित रूप से भरने के लिए इसके CLI का उपयोग करें:
+
+```bash packageManager="npm"
+# अनुपलब्ध अनुवादों के लिए परीक्षण (CI में जोड़ें)
+npx intlayer test
+
+# AI के साथ अनुपलब्ध अनुवाद भरें
+npx intlayer fill
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer test
+pnpm intlayer fill
+```
+
+```bash packageManager="yarn"
+yarn intlayer test
+yarn intlayer fill
+```
+
+```bash packageManager="bun"
+bun x intlayer test
+bun x intlayer fill
+```
+
+`intlayer.config.ts` में AI कॉन्फ़िगरेशन जोड़ें:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncJSON({
+      format: "icu",
+      source: ({ locale }) => `./src/locales/${locale}.json`,
+      location: "src/locales",
+    }),
+  ],
+  ai: {
+    apiKey: process.env.OPENAI_API_KEY,
+    // provider: "openai",     // default
+    // model: "gpt-4o-mini",   // default
+  },
+};
+
+export default config;
+```
+
+> सभी उपलब्ध विकल्पों के लिए [Intlayer CLI documentation](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/cli/index.md) देखें।
+
+</Step>
+
+</Steps>
+
+---
+
+## माइग्रेशन के बाद आप क्या हटा सकते हैं
+
+एक बार compat एडॉप्टर मौजूद होने के बाद, निम्नलिखित `vue-i18n` boilerplate को हटाया जा सकता है:
+
+| फाइल / पैटर्न                             | यह अब आवश्यक क्यों नहीं है                                                                                                                                               |
+| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `createI18n()` कॉल                        | Intlayer का provider हर चीज को स्वचालित रूप से आरंभ करता है; कोई runtime loading चरण नहीं है।                                                                            |
+| Vue plugin registration (`app.use(i18n)`) | Intlayer प्लग-इन हूड के तहत injection और bootstrapping को हैंडल करता है।                                                                                                 |
+| JSON language bundles (`locales/*.json`)  | JSON bundles केवल तभी आवश्यक हैं जब आप अभी भी `syncJSON` प्लग-इन का उपयोग करते हैं। एक बार `.content.ts` फाइलों में माइग्रेट करने के बाद आप JSON फोल्डर को हटा सकते हैं। |
+
+जब आप आगे बढ़ने के लिए तैयार हों, Intlayer **स्वचालित रूप से आपके कोडबेस में कहीं भी सभी `.content.ts` और `.content.json` फाइलों को खोजता है** (डिफ़ॉल्ट रूप से, `./src` के अंदर कहीं भी)। आप एक `my-component.content.ts` फाइल को अपने `MyComponent.vue` के बगल में रख सकते हैं और Intlayer इसे बिल्ड समय पर किसी अतिरिक्त कॉन्फ़िगरेशन के बिना उठाएगा — कोई imports, कोई पंजीकरण, कोई केंद्रीकृत index फाइल आवश्यक नहीं है। यह अनुवाद को पेजों और घटकों के साथ सह-स्थित करना पूरी तरह से घर्षण रहित बनाता है।
+
+---
+
+## TypeScript को कॉन्फ़िगर करें
+
+Intlayer module augmentation का उपयोग करता है आपके अनुवाद कुंजियों के लिए पूर्ण TypeScript intellisense प्रदान करने के लिए। सुनिश्चित करें कि आपका `tsconfig.json` auto-generated प्रकारों को शामिल करता है:
+
+```json5 fileName="tsconfig.json"
+{
+  // ... आपकी मौजूदा TypeScript कॉन्फ़िगरेशन
+  "include": [
+    // ... आपकी मौजूदा TypeScript कॉन्फ़िगरेशन
+    ".intlayer/**/*.ts", // auto-generated प्रकारों को शामिल करें
+  ],
+}
+```
+
+---
+
+## Git कॉन्फ़िगरेशन
+
+Intlayer के generated directory को अपने `.gitignore` में जोड़ें:
+
+```plaintext fileName=".gitignore"
+# Intlayer द्वारा जनरेट की गई फाइलों को अनदेखा करें
+.intlayer
+```
+
+---
+
+## आगे बढ़ें
+
+- **Visual Editor** — अपने ब्राउज़र में translations को visually प्रबंधित करें: [Intlayer Visual Editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_visual_editor.md)
+- **CMS** — सामग्री को बाहरी रूप से प्रबंधित करें: [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_CMS.md)
+- **VS Code Extension** — autocompletion और real-time अनुवाद त्रुटि पहचान प्राप्त करें: [Intlayer VS Code Extension](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/vs_code_extension.md)
+- **CLI Reference** — CLI commands की पूर्ण सूची: [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/cli/index.md)
+- **Intlayer with Vue** — Vue के लिए full setup guide: [intlayer_with_vite+vue.md](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_with_vite+vue.md)
+- **Intlayer with Nuxt** — Nuxt के लिए full setup guide: [intlayer_with_nuxt.md](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/intlayer_with_nuxt.md)

package/docs/hi/packages/intlayer/getLocalizedUrl.md

@@ -29,12 +29,40 @@ author: aymericzip
 
 ## विवरण
 
+`getLocalizedUrl` फ़ंक्शन दिए गए URL को निर्दिष्ट locale के साथ उपसर्ग करके एक localized URL उत्पन्न करता है। यह absolute और relative दोनों URLs को हैंडल करता है, यह सुनिश्चित करता है कि सही locale prefix configuration के आधार पर लागू किया जाता है।
+
+**मुख्य विशेषताएं:**
+
+- केवल 2 parameters आवश्यक हैं: `url` और `currentLocale`
+- `locales`, `defaultLocale`, और `mode` के साथ optional `options` object
+- अपनी project की internationalization configuration को defaults के रूप में उपयोग करता है
+- सरल cases के लिए minimal parameters के साथ या complex scenarios के लिए पूरी तरह से customized किया जा सकता है
+- कई routing modes को support करता है: `prefix-no-default`, `prefix-all`, `no-prefix`, और `search-params`
+
+---
+
+## विवरण
+
 `getLocalizedUrl` फ़ंक्शन निर्दिष्ट लोकल के साथ दिए गए URL के आगे लोकलाइज़्ड URL उत्पन्न करता है। यह पूर्ण (absolute) और सापेक्ष (relative) दोनों प्रकार के URL को संभालता है, यह सुनिश्चित करते हुए कि कॉन्फ़िगरेशन के आधार पर सही लोकल उपसर्ग लागू किया गया है।
 
 ---
 
 ## पैरामीटर
 
+### आवश्यक पैरामीटर
+
+- `url: string`
+  - **Description**: मूल URL string जिसे locale के साथ prefix किया जाना है।
+  - **Type**: `string`
+  - **Required**: Yes
+
+- `currentLocale: Locales`
+  - **Description**: वर्तमान locale जिसके लिए URL को localize किया जा रहा है।
+  - **Type**: `Locales`
+  - **Required**: Yes
+
+## पैरामीटर
+
 - `url: string`
   - **विवरण**: मूल URL स्ट्रिंग जिसे लोकल के साथ उपसर्गित किया जाना है।
   - **प्रकार**: `string`
@@ -67,6 +95,46 @@ author: aymericzip
 
 ## उदाहरण उपयोग
 
+### बुनियादी उपयोग (केवल आवश्यक पैरामीटर)
+
+जब आप अपनी परियोजना को अंतर्राष्ट्रीयकरण सेटिंग्स के साथ कॉन्फ़िगर कर लेते हैं, तो आप केवल आवश्यक पैरामीटर के साथ फ़ंक्शन का उपयोग कर सकते हैं:
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// आपकी परियोजना की कॉन्फ़िगरेशन का उपयोग करता है locales, defaultLocale, और mode के लिए
+getLocalizedUrl("/about", Locales.FRENCH);
+// आउटपुट: "/fr/about" (मानते हुए कि फ्रेंच समर्थित है और mode 'prefix-no-default' है)
+
+getLocalizedUrl("/about", Locales.ENGLISH);
+// आउटपुट: "/about" या "/en/about" (आपकी mode सेटिंग के आधार पर)
+```
+
+### Advanced Usage (With Optional Parameters)
+
+आप optional `options` parameter प्रदान करके default configuration को override कर सकते हैं:
+
+### Relative URLs (All Options Specified)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getLocalizedUrl, Locales } from "intlayer";
+
+// सभी optional parameters को स्पष्ट रूप से प्रदान करना
+getLocalizedUrl("/about", Locales.FRENCH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Output: "/fr/about" French locale के लिए
+
+getLocalizedUrl("/about", Locales.ENGLISH, {
+  locales: [Locales.ENGLISH, Locales.FRENCH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// Output: "/about" डिफ़ॉल्ट (English) locale के लिए
+```
+
 ### सापेक्ष URL
 
 ```typescript codeFormat={["typescript", "esm"]}

package/docs/hi/packages/intlayer/getMultilingualUrls.md

@@ -29,12 +29,28 @@ author: aymericzip
 
 ## विवरण
 
+`getMultilingualUrls` फ़ंक्शन प्रत्येक समर्थित locale के साथ दिए गए URL को प्रीफ़िक्स करके बहुभाषी URLs की एक mapping तैयार करता है। यह निरपेक्ष और सापेक्ष दोनों URLs को संभाल सकता है, प्रदान किए गए कॉन्फ़िगरेशन या डिफ़ॉल्ट के आधार पर उपयुक्त locale prefix लागू करता है।
+
+**मुख्य विशेषताएं:**
+
+- केवल 1 पैरामीटर आवश्यक है: `url`
+- Optional `options` ऑब्जेक्ट जिसमें `locales`, `defaultLocale`, और `mode` हैं
+- अपने प्रोजेक्ट के internationalization कॉन्फ़िगरेशन को डिफ़ॉल्ट के रूप में उपयोग करता है
+- कई routing modes को समर्थन करता है: `prefix-no-default`, `prefix-all`, `no-prefix`, और `search-params`
+- एक mapping ऑब्जेक्ट रिटर्न करता है जिसमें सभी locales keys के रूप में हैं और उनके संबंधित URLs values के रूप में हैं
+
+---
+
+## विवरण
+
 `getMultilingualUrls` फ़ंक्शन प्रत्येक समर्थित भाषा-स्थान के साथ दिए गए URL को उपसर्गित करके बहुभाषी URL का एक मानचित्रण उत्पन्न करता है। यह दोनों पूर्ण और सापेक्ष URL को संभाल सकता है, और प्रदान की गई कॉन्फ़िगरेशन या डिफ़ॉल्ट के आधार पर उपयुक्त भाषा-स्थान उपसर्ग लागू करता है।
 
 ---
 
 ## पैरामीटर
 
+## पैरामीटर
+
 - `url: string`
   - **विवरण**: मूल URL स्ट्रिंग जिसे भाषा-स्थान के साथ उपसर्गित किया जाना है।
   - **प्रकार**: `string`
@@ -54,6 +70,33 @@ author: aymericzip
   - **प्रकार**: `boolean`
   - **डिफ़ॉल्ट**: `prefixDefaultDefault`
 
+### वैकल्पिक Parameters
+
+- `options?: object`
+  - **Description**: URL localization behavior के लिए configuration object।
+  - **Type**: `object`
+  - **Required**: No (Optional)
+
+  - `options.locales?: Locales[]`
+    - **Description**: समर्थित locales की array। यदि प्रदान नहीं किया गया है, तो आपके project configuration से configured locales का उपयोग करता है।
+    - **Type**: `Locales[]`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md#middleware)
+
+  - `options.defaultLocale?: Locales`
+    - **Description**: application के लिए default locale। यदि प्रदान नहीं किया गया है, तो आपके project configuration से configured default locale का उपयोग करता है।
+    - **Type**: `Locales`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md#middleware)
+
+  - `options.mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Description**: locale handling के लिए URL routing mode। यदि प्रदान नहीं किया गया है, तो आपके project configuration से configured mode का उपयोग करता है।
+    - **Type**: `'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'`
+    - **Default**: [`Project Configuration`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/configuration.md#middleware)
+    - **Modes**:
+      - `prefix-no-default`: Default locale के लिए कोई prefix नहीं, अन्य सभी के लिए prefix
+      - `prefix-all`: सभी locales के लिए prefix, default सहित
+      - `no-prefix`: URL में कोई locale prefix नहीं
+      - `search-params`: Locale के लिए query parameters का उपयोग करें (जैसे, `?locale=fr`)
+
 ### रिटर्न्स
 
 - **प्रकार**: `IConfigLocales<string>`
@@ -63,6 +106,20 @@ author: aymericzip
 
 ## उदाहरण उपयोग
 
+### बुनियादी उपयोग (परियोजना कॉन्फ़िगरेशन का उपयोग करता है)
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { getMultilingualUrls, Locales } from "intlayer";
+
+// आपकी परियोजना के कॉन्फ़िगरेशन को locales, defaultLocale, और mode के लिए उपयोग करता है
+getMultilingualUrls("/dashboard");
+// आउटपुट (यह मानते हुए कि परियोजना कॉन्फ़िगरेशन में en, fr है mode 'prefix-no-default' के साथ):
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
 ### सापेक्ष URL
 
 ```typescript codeFormat={["typescript", "esm", "commonjs"]}
@@ -97,6 +154,60 @@ getMultilingualUrls(
 
 ---
 
+### विभिन्न रूटिंग मोड्स
+
+```typescript
+// prefix-no-default: डिफ़ॉल्ट लोकेल के लिए कोई प्रीफिक्स नहीं
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-no-default",
+});
+// आउटपुट: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// prefix-all: सभी लोकेल्स के लिए प्रीफिक्स
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "prefix-all",
+});
+// आउटपुट: {
+//   en: "/en/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+// no-prefix: URLs में कोई लोकेल प्रीफिक्स नहीं
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "no-prefix",
+});
+// आउटपुट: {
+//   en: "/dashboard",
+//   fr: "/dashboard",
+//   es: "/dashboard"
+// }
+
+// search-params: क्वेरी पैरामीटर के रूप में लोकेल
+getMultilingualUrls("/dashboard", {
+  locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  defaultLocale: Locales.ENGLISH,
+  mode: "search-params",
+});
+// आउटपुट: {
+//   en: "/dashboard?locale=en",
+//   fr: "/dashboard?locale=fr",
+//   es: "/dashboard?locale=es"
+// }
+```
+
+---
+
 ## किनारे के मामले
 
 - **कोई भाषा-स्थान खंड नहीं:**

package/docs/hi/packages/next-intlayer/t.md

@@ -135,6 +135,8 @@ export const ServerComponentExample: FC = () => (
 
 ## उन्नत विषय
 
+## Advanced Topics
+
 ### TypeScript एकीकरण
 
 जब `t` फ़ंक्शन TypeScript के साथ उपयोग किया जाता है, तो यह टाइप-सुरक्षित होता है, जिससे यह सुनिश्चित होता है कि सभी आवश्यक लोकल्स प्रदान किए गए हैं।