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

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

@@ -0,0 +1,173 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: comparePaths फ़ंक्शन दस्तावेज़ | intlayer
+description: जानें कि intlayer पैकेज के लिए comparePaths फ़ंक्शन का उपयोग कैसे करें
+keywords:
+  - comparePaths
+  - normalizePath
+  - सक्रिय लिंक (active link)
+  - नेविगेशन
+  - Intlayer
+  - intlayer
+  - अंतर्राष्ट्रीयकरण (Internationalization)
+  - दस्तावेज़
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - intlayer
+  - comparePaths
+history:
+  - version: 9.0.0
+    date: 2026-06-22
+    changes: "प्रारंभिक दस्तावेज़"
+author: aymericzip
+---
+
+# दस्तावेज़: `intlayer` में `comparePaths` फ़ंक्शन
+
+## विवरण
+
+`comparePaths` फ़ंक्शन लोकेल (locale) सेगमेंट, प्रोटोकॉल/होस्ट, क्वेरी स्ट्रिंग, हैश और ट्रेलिंग स्लैश (trailing slashes) को अनदेखा करते हुए दो URL या पाथनेम की समानता के लिए तुलना करता है। यह निर्धारित करने का अनुशंसित तरीका है कि कोई नेविगेशन लिंक वर्तमान पृष्ठ को इंगित करता है या नहीं — उदाहरण के लिए सक्रिय लिंक को हाइलाइट करने के लिए — बिना अपना स्वयं का (त्रुटि-प्रवण) सामान्यीकरण लॉजिक (normalization logic) लिखे।
+
+आंतरिक रूप से यह लोकेल सेगमेंट को हटाने के लिए [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPathWithoutLocale.md) का पुन: उपयोग करता है, इसलिए यह आपके कॉन्फ़िगर किए गए रूटिंग मोड और लोकेल्स का सम्मान करता है।
+
+पैकेज अंतर्निहित [`normalizePath`](#normalizepath) हेल्पर को भी निर्यात (export) करता है, जो तुलना के लिए उपयोग किए जाने वाले कैनोनिकल, लोकेल-स्वतंत्र पाथनेम को लौटाता है।
+
+**मुख्य विशेषताएँ:**
+
+- लोकेल-स्वतंत्र तुलना (`/hi/about`, `/about` से मेल खाता है)
+- एब्सोल्यूट URL और रिलेटिव पाथ दोनों के साथ काम करता है
+- क्वेरी स्ट्रिंग, हैश और ट्रेलिंग स्लैश को अनदेखा करता है
+- गायब लीडिंग स्लैश और खाली मानों को सहन करता है (`/` में सामान्यीकृत)
+- हल्का (Lightweight) — `getPathWithoutLocale` के ऊपर बनाया गया
+
+---
+
+## फ़ंक्शन सिग्नेचर
+
+```typescript
+comparePaths(
+  pathname: string,  // आवश्यक
+  href: string,      // आवश्यक
+  locales?: Locales[] // वैकल्पिक
+): boolean
+
+normalizePath(
+  inputUrl: string,   // आवश्यक
+  locales?: Locales[] // वैकल्पिक
+): string
+```
+
+---
+
+## पैरामीटर्स
+
+- `pathname: string`
+  - **विवरण**: तुलना करने के लिए पहली URL स्ट्रिंग या पाथनेम (आमतौर पर वर्तमान पाथनेम)।
+  - **प्रकार**: `string`
+  - **आवश्यक**: हाँ
+
+- `href: string`
+  - **विवरण**: तुलना करने के लिए दूसरी URL स्ट्रिंग या पाथनेम (आमतौर पर नेविगेशन लिंक का `href`)।
+  - **प्रकार**: `string`
+  - **आवश्यक**: हाँ
+
+- `locales: Locales[]`
+  - **विवरण**: समर्थित लोकेल्स का वैकल्पिक एरे। डिफ़ॉल्ट रूप से प्रोजेक्ट में कॉन्फ़िगर किए गए लोकेल्स लेता है।
+  - **प्रकार**: `Locales[]`
+  - **आवश्यक**: नहीं (वैकल्पिक)
+
+### रिटर्न (Returns)
+
+- **प्रकार**: `boolean`
+- **विवरण**: `true` जब दोनों इनपुट एक ही लोकेल-स्वतंत्र पाथ पर रिज़ॉल्व होते हैं, अन्यथा `false`।
+
+---
+
+## उदाहरण उपयोग
+
+### मूल उपयोग
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { comparePaths } from "intlayer";
+
+comparePaths("/ru/path", "/path"); // true
+comparePaths("/ru/path/", "/path"); // true
+comparePaths("/ru/path", "/path/"); // true
+comparePaths("/ru/", "/"); // true
+comparePaths("/ru", "/"); // true
+comparePaths("ru/path", "/path"); // true
+comparePaths("", "/"); // true
+comparePaths("/ru", ""); // true
+comparePaths("/ru/path", "/other"); // false
+```
+
+### एब्सोल्यूट और रिलेटिव URL
+
+```typescript
+import { comparePaths } from "intlayer";
+
+comparePaths("https://example.com/ru/path", "/path"); // true
+```
+
+### सक्रिय नेविगेशन लिंक को हाइलाइट करना
+
+```tsx
+import { comparePaths } from "intlayer";
+import { useLocation } from "react-router";
+
+const NavLink = ({ href, children }) => {
+  const { pathname } = useLocation();
+  const isActive = comparePaths(pathname, href);
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {children}
+    </a>
+  );
+};
+```
+
+---
+
+## normalizePath
+
+`normalizePath` वह कैनोनिकल, लोकेल-स्वतंत्र पाथनेम लौटाता है जिसका उपयोग `comparePaths` द्वारा किया जाता है। यह लोकेल सेगमेंट, प्रोटोकॉल/होस्ट, क्वेरी स्ट्रिंग और हैश को हटा देता है, एक सिंगल लीडिंग स्लैश सुनिश्चित करता है, किसी भी ट्रेलिंग स्लैश को हटा देता है (रूट को छोड़कर) और खाली मानों के लिए `/` पर वापस आ जाता है।
+
+```typescript codeFormat={["typescript", "esm", "commonjs"]}
+import { normalizePath } from "intlayer";
+
+normalizePath("/ru/path"); // "/path"
+normalizePath("/ru/path/"); // "/path"
+normalizePath("ru/path"); // "/path"
+normalizePath("/ru/"); // "/"
+normalizePath("/ru"); // "/"
+normalizePath(""); // "/"
+normalizePath("https://example.com/ru/path"); // "/path"
+```
+
+---
+
+## संबंधित फ़ंक्शन्स
+
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPathWithoutLocale.md): URL या पाथनेम से लोकेल सेगमेंट को हटाता है।
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPrefix.md): किसी दिए गए लोकेल के लिए URL उपसर्ग (prefix) निर्धारित करता है।
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocalizedUrl.md): विशिष्ट लोकेल के लिए स्थानीयकृत (localized) URL जनरेट करता है।
+
+---
+
+## TypeScript
+
+```typescript
+function normalizePath(inputUrl: string, locales?: Locales[]): string;
+
+function comparePaths(
+  pathname: string,
+  href: string,
+  locales?: Locales[]
+): boolean;
+```

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

@@ -14,6 +14,9 @@ slugs:
   - intlayer
   - exports
 history:
+  - version: 9.0.0
+    date: 2026-06-23
+    changes: "comparePaths उपयोगिता जोड़ी गई"
   - version: 8.0.0
     date: 2026-01-21
     changes: "सभी एक्सपोर्ट्स के लिए एकीकृत प्रलेखन"
@@ -108,19 +111,21 @@ import "intlayer";
 import "intlayer";
 ```
 
-| `फ़ंक्शन`              | `प्रकार`   | विवरण                                            | संबंधित डॉक्स                                                                                                                   |
-| ---------------------- | ---------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
-| `getLocale`            | `Function` | किसी स्ट्रिंग या path से locale का पता लगाता है। | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocale.md)                       |
-| `getLocaleLang`        | `Function` | किसी locale का भाषा भाग प्राप्त करता है।         | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocaleLang.md)               |
-| `getLocaleName`        | `Function` | किसी locale का display name प्राप्त करता है।     | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocaleName.md)               |
-| `getLocalizedPath`     | `Function` | कैनोनिकल पथ को स्थानीयकृत पथ में हल करता है।     | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocalizedPath.md)         |
-| `getCanonicalPath`     | `Function` | स्थानीयकृत पथ को canonical पथ में हल करता है।    | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getCanonicalPath.md)         |
-| `getLocalizedUrl`      | `Function` | स्थानीयकृत URL उत्पन्न करता है।                  | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocalizedUrl.md)           |
-| `getMultilingualUrls`  | `Function` | समर्थित सभी locales के लिए URLs उत्पन्न करता है। | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getMultilingualUrls.md)   |
-| `getPathWithoutLocale` | `Function` | पाथ से locale प्रिफिक्स हटाता है।                | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPathWithoutLocale.md) |
-| `getPrefix`            | `Function` | पाथ से locale प्रिफिक्स प्राप्त करता है।         | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPrefix.md)                       |
-| `getHTMLTextDir`       | `Function` | टेक्स्ट की दिशा (LTR/RTL) प्राप्त करता है।       | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getHTMLTextDir.md)             |
-| `validatePrefix`       | `Function` | locale प्रीफिक्स की वैधता की जाँच करता है।       | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/validatePrefix.md)             |
+| `फ़ंक्शन`              | `प्रकार`   | विवरण                                               | संबंधित डॉक्स                                                                                                                   |
+| ---------------------- | ---------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `getLocale`            | `Function` | किसी स्ट्रिंग या path से locale का पता लगाता है।    | [getLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocale.md)                       |
+| `getLocaleLang`        | `Function` | किसी locale का भाषा भाग प्राप्त करता है।            | [getLocaleLang](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocaleLang.md)               |
+| `getLocaleName`        | `Function` | किसी locale का display name प्राप्त करता है।        | [getLocaleName](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocaleName.md)               |
+| `getLocalizedPath`     | `Function` | कैनोनिकल पथ को स्थानीयकृत पथ में हल करता है।        | [getLocalizedPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocalizedPath.md)         |
+| `getCanonicalPath`     | `Function` | स्थानीयकृत पथ को canonical पथ में हल करता है।       | [getCanonicalPath](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getCanonicalPath.md)         |
+| `getLocalizedUrl`      | `Function` | स्थानीयकृत URL उत्पन्न करता है।                     | [getLocalizedUrl](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getLocalizedUrl.md)           |
+| `getMultilingualUrls`  | `Function` | समर्थित सभी locales के लिए URLs उत्पन्न करता है।    | [getMultilingualUrls](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getMultilingualUrls.md)   |
+| `getPathWithoutLocale` | `Function` | पाथ से locale प्रिफिक्स हटाता है।                   | [getPathWithoutLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPathWithoutLocale.md) |
+| `getPrefix`            | `Function` | पाथ से locale प्रिफिक्स प्राप्त करता है।            | [getPrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPrefix.md)                       |
+| `comparePaths`         | `Function` | लोकेल को अनदेखा करते हुए दो पाथ्स की तुलना करता है। | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/comparePaths.md)                 |
+| `normalizePath`        | `Function` | पाथ को लोकेल-स्वतंत्र पाथ में सामान्यीकृत करता है।  | [comparePaths](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/comparePaths.md)                 |
+| `getHTMLTextDir`       | `Function` | टेक्स्ट की दिशा (LTR/RTL) प्राप्त करता है।          | [getHTMLTextDir](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getHTMLTextDir.md)             |
+| `validatePrefix`       | `Function` | locale प्रीफिक्स की वैधता की जाँच करता है।          | [validatePrefix](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/validatePrefix.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/intlayer/index.md

@@ -38,24 +38,40 @@ author: aymericzip
 
 अपनी पसंदीदा पैकेज मैनेजर का उपयोग करके आवश्यक पैकेज इंस्टॉल करें:
 
+```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
-npx intlayer init
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer
-bun x intlayer init
 ```
 
 ### Intlayer को कॉन्फ़िगर करें

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

@@ -15,6 +15,9 @@ slugs:
   - next-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname उपयोगिता जोड़ी गई"
   - version: 8.0.0
     date: 2026-01-21
     changes: "सभी एक्सपोर्ट्स के लिए एकीकृत दस्तावेज़ीकरण"
@@ -95,6 +98,7 @@ import "next-intlayer";
 | `useDictionaryAsync`   | यह हुक असिंक्रोनस डिक्शनरीज़ को संभालता है। यह एक promise-आधारित dictionary map स्वीकार करता है और वर्तमान locale के लिए इसे resolve करता है।                 | -                                                                                                                       |
 | `useDictionaryDynamic` | यह हुक key द्वारा लोड की जाने वाली dynamic dictionaries को संभालता है। लोडिंग स्टेट्स के लिए यह अंदर से React Suspense का उपयोग करता है।                      | -                                                                                                                       |
 | `useLocale`            | क्लाइंट-साइड hook जो वर्तमान locale और उसे सेट करने के लिए एक फ़ंक्शन प्रदान करता है। Next.js App Router के लिए नेविगेशन समर्थन के साथ संवर्धित।              | [useLocale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/react-intlayer/useLocale.md)         |
+| `usePathname`          | वर्तमान पाथनेम लौटाता है जिसमें से लोकेल प्रीफ़िक्स और लोकेल पैरामीटर्स से जुड़े क्वेरी पैरामीटर्स हटा दिए गए होते हैं।                                       | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/next-intlayer/usePathname.md)      |
 | `useRewriteURL`        | क्लाइंट-साइड hook जो URL rewrites को प्रबंधित करता है। यदि कोई अधिक उपयुक्त localized rewrite नियम मौजूद हो तो यह स्वचालित रूप से URL को अपडेट कर देता है।    | [useRewriteURL](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/next-intlayer/useRewriteURL.md)  |
 | `useLocalePageRouter`  | Next.js Page Router के लिए विशिष्ट hook जो locale प्रबंधन के लिए है। locale बदलने पर यह रीडायरेक्शन और पेज रीलोड को संभालता है।                               | -                                                                                                                       |
 | `useI18n`              | एक hook जो nested सामग्री को key से एक्सेस करने के लिए अनुवाद फ़ंक्शन `t()` प्रदान करता है। यह i18next/next-intl पैटर्न की नकल करता है।                       | [useI18n](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/react-intlayer/useI18n.md)             |

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

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