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

package/docs/hi/packages/angular-intlayer/usePathname.md

@@ -0,0 +1,119 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook प्रलेखन | angular-intlayer
+description: देखें कि angular-intlayer पैकेज के लिए usePathname hook का उपयोग कैसे करें
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Angular
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - packages
+  - angular-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname उपयोगिता जोड़ी गई"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "इतिहास प्रारंभ"
+author: aymericzip
+---
+
+# Angular एकीकरण: `usePathname` Hook प्रलेखन
+
+`usePathname` हुक वर्तमान ब्राउज़र पाथनेम को Angular `Signal<string>` के रूप में लौटाता है, जिसमें से स्थान (locale) खंड हटा दिया गया होता है। यह स्थानीयता-जागरूक (locale-aware) नेविगेशन बनाने के लिए उपयोगी है — उदाहरण के लिए, यह निर्धारित करना कि कौन सा नेविगेशन आइटम सक्रिय है — बिना स्थानीयता उपसर्ग को मैन्युअल रूप से हटाए।
+
+## Angular में `usePathname` आयात करना
+
+```typescript
+import { usePathname } from "angular-intlayer";
+```
+
+## अवलोकन
+
+`usePathname` `window.location.pathname` पढ़ता है, `getPathWithoutLocale` के माध्यम से स्थानीयता उपसर्ग को हटाता है, और जब भी ब्राउज़र `popstate` ईवेंट (बैक/फॉरवर्ड नेविगेशन) फायर करता है तो सिग्नल को अपडेट करता है। यह Angular के `DestroyRef` का उपयोग करता है ताकि घटक के नष्ट होने पर ईवेंट श्रोता को स्वचालित रूप से साफ़ किया जा सके।
+
+## उपयोग
+
+```typescript fileName="src/app/nav-item.component.ts"
+import { Component, input } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-nav-item",
+  template: `
+    <a
+      [href]="href()"
+      [attr.aria-current]="pathname() === href() ? 'page' : null"
+    >
+      {{ label() }}
+    </a>
+  `,
+})
+export class NavItemComponent {
+  readonly href = input.required<string>();
+  readonly label = input.required<string>();
+
+  readonly pathname = usePathname();
+}
+```
+
+## रिटर्न वैल्यू
+
+| प्रकार           | विवरण                                                                   |
+| ---------------- | ----------------------------------------------------------------------- |
+| `Signal<string>` | Angular सिग्नल जिसमें स्थानीयता उपसर्ग के बिना वर्तमान पाथनेम शामिल है। |
+
+## व्यवहार
+
+- **स्थानीयता हटाना (Locale stripping)**: अग्रणी स्थानीयता खंड को हटाता है (उदा. `/hi/dashboard` → `/dashboard`)।
+- **प्रतिक्रियाशील**: `popstate` ईवेंट्स (ब्राउज़र बैक / फॉरवर्ड नेविगेशन) पर स्वचालित रूप से अपडेट होता है।
+- **SSR-सुरक्षित**: `window` उपलब्ध न होने पर `""` लौटाता है।
+- **सफाई**: होस्ट घटक के नष्ट होने पर `DestroyRef.onDestroy` के माध्यम से `popstate` श्रोता को हटा दिया जाता है।
+
+## उदाहरण
+
+```typescript fileName="src/app/sidebar.component.ts"
+import { Component } from "@angular/core";
+import { usePathname } from "angular-intlayer";
+
+@Component({
+  standalone: true,
+  selector: "app-sidebar",
+  template: `
+    <nav>
+      @for (link of links; track link.href) {
+        <a
+          [href]="link.href"
+          [style.font-weight]="pathname() === link.href ? 'bold' : 'normal'"
+        >
+          {{ link.label }}
+        </a>
+      }
+    </nav>
+  `,
+})
+export class SidebarComponent {
+  readonly links = [
+    { href: "/dashboard", label: "डैशबोर्ड" },
+    { href: "/settings", label: "सेटिंग्स" },
+  ];
+
+  readonly pathname = usePathname();
+}
+```
+
+## संबंधित
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/angular-intlayer/exports.md) — वर्तमान स्थानीयता + स्थानीयता स्विचर
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPathWithoutLocale.md) — इस हुक द्वारा उपयोग की जाने वाली अंतर्निहित उपयोगिता

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/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/usePathname.md

@@ -0,0 +1,136 @@
+---
+createdAt: 2026-06-22
+updatedAt: 2026-06-22
+title: usePathname Hook दस्तावेज़ | next-intlayer
+description: next-intlayer पैकेज के लिए usePathname हुक का उपयोग करना सीखें
+keywords:
+  - usePathname
+  - pathname
+  - locale
+  - Intlayer
+  - Internationalization
+  - Documentation
+  - Next.js
+  - JavaScript
+  - React
+slugs:
+  - doc
+  - packages
+  - next-intlayer
+  - usePathname
+history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname उपयोगिता जोड़ी गई"
+  - version: 8.2.0
+    date: 2026-06-22
+    changes: "इतिहास का आरंभ"
+author: aymericzip
+---
+
+# Next.js इंटीग्रेशन: `usePathname` हुक दस्तावेज़
+
+`usePathname` हुक वर्तमान Next.js पथ (pathname) को बिना लोकेल (locale) सेगमेंट के लौटाता है। यह लोकेल-जागरूक नेविगेशन बनाने के लिए उपयोगी है — उदाहरण के लिए, यह निर्धारित करना कि कौन सा नेविगेशन आइटम सक्रिय है — बिना मैन्युअल रूप से लोकेल उपसर्ग को हटाए।
+
+## Next.js में `usePathname` को आयात करना
+
+```typescript
+import { usePathname } from "next-intlayer";
+```
+
+## अवलोकन
+
+`usePathname`, `next/navigation` से Next.js के अंतर्निहित `usePathname()` को रैप करता है, किसी भी खोज पैरामीटर (search params) को जोड़ता है, और `getPathWithoutLocale` के माध्यम से लोकेल उपसर्ग को हटा देता है। यह हर क्लाइंट-साइड नेविगेशन पर फिर से रेंडर (re-render) को ट्रिगर करता है। यह हुक केवल Client Components में उपलब्ध है (`"use client"` की आवश्यकता है)।
+
+## उपयोग
+
+```tsx fileName="src/components/NavItem.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+type NavItemProps = {
+  href: string;
+  label: string;
+};
+
+const NavItem: FC<NavItemProps> = ({ href, label }) => {
+  const pathname = usePathname();
+  const isActive = pathname === href;
+
+  return (
+    <a href={href} aria-current={isActive ? "page" : undefined}>
+      {label}
+    </a>
+  );
+};
+
+export default NavItem;
+```
+
+## रिटर्न वैल्यू
+
+| प्रकार   | विवरण                                                                                                         |
+| -------- | ------------------------------------------------------------------------------------------------------------- |
+| `string` | वर्तमान पाथनेम जिसमें से लोकेल प्रीफ़िक्स और लोकेल पैरामीटर्स से जुड़े क्वेरी पैरामीटर्स हटा दिए गए होते हैं। |
+
+## व्यवहार
+
+- **लोकेल स्ट्रिपिंग**: शुरुआती लोकेल सेगमेंट को हटा देता है (उदा: `/hi/dashboard` → `/dashboard`)।
+- **सर्च पैरामीटर स्ट्रिपिंग**: जब सर्च पैरामीटर-आधारित रूटिंग मोड का उपयोग किया जाता है, तो यह `?locale=...` क्वेरी पैरामीटर को भी हटा देता है।
+- **रिएक्टिव**: Next.js App Router के माध्यम से प्रत्येक क्लाइंट-साइड नेविगेशन पर स्वचालित रूप से अपडेट होता है।
+- **SSR सुरक्षित**: पहले रेंडर के दौरान सर्वर-साइड पथ लौटाता है, फिर क्लाइंट पर सर्च पैरामीटर्स को सिंक करता है।
+
+## `useLocale` के साथ तुलना
+
+`next-intlayer` से `useLocale` पहले से ही अपने रिटर्न वैल्यू के हिस्से के रूप में `pathWithoutLocale` को प्रदर्शित करता है। जब आपको केवल पथ (path) की आवश्यकता हो और लोकेल-स्विचिंग कार्यक्षमता की आवश्यकता न हो, तो `usePathname` का उपयोग करें।
+
+```tsx codeFormat={["typescript", "esm"]}
+// जब आपको लोकेल स्थिति और पथ दोनों की आवश्यकता हो:
+import { useLocale } from "next-intlayer";
+const { locale, pathWithoutLocale } = useLocale();
+
+// जब आपको केवल पथ की आवश्यकता हो:
+import { usePathname } from "next-intlayer";
+const pathname = usePathname();
+```
+
+## उदाहरण
+
+```tsx fileName="src/components/Sidebar.tsx" codeFormat={["typescript", "esm"]}
+"use client";
+
+import type { FC } from "react";
+import { usePathname } from "next-intlayer";
+
+const links = [
+  { href: "/dashboard", label: "डैशबोर्ड" },
+  { href: "/settings", label: "सेटिंग्स" },
+];
+
+const Sidebar: FC = () => {
+  const pathname = usePathname();
+
+  return (
+    <nav>
+      {links.map(({ href, label }) => (
+        <a
+          key={href}
+          href={href}
+          style={{ fontWeight: pathname === href ? "bold" : "normal" }}
+        >
+          {label}
+        </a>
+      ))}
+    </nav>
+  );
+};
+
+export default Sidebar;
+```
+
+## संबंधित दस्तावेज़
+
+- [`useLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/next-intlayer/useLocale.md) — वर्तमान लोकेल + लोकेल स्विचर (यह `pathWithoutLocale` भी प्रदर्शित करता है)
+- [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/intlayer/getPathWithoutLocale.md) — इस हुक द्वारा उपयोग की जाने वाली अंतर्निहित उपयोगिता

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

@@ -14,6 +14,9 @@ slugs:
   - preact-intlayer
   - exports
 history:
+  - version: 10.0.0
+    date: 2026-06-23
+    changes: "usePathname उपयोगिता (utility) जोड़ी गई"
   - version: 8.0.0
     date: 2026-01-21
     changes: "Unified documentation for all exports"
@@ -40,12 +43,13 @@ npm install preact-intlayer
 
 ### हुक्स
 
-| हुक             | विवरण                                                                                                                               | संबंधित दस्तावेज़                                                                                 |
-| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| `useIntlayer`   | यह `useDictionary` पर आधारित है, लेकिन जनरेट की गई घोषणा से शब्दकोश का एक अनुकूलित संस्करण इंजेक्ट करता है।                         | -                                                                                                 |
-| `useDictionary` | ऐसे ऑब्जेक्ट्स को प्रोसेस करता है जो शब्दकोश जैसे दिखते हैं (key, content)। यह `t()` अनुवादों, enumerations आदि को प्रोसेस करता है। | -                                                                                                 |
-| `useLocale`     | वर्तमान locale और इसे सेट करने के लिए एक फ़ंक्शन लौटाता है।                                                                         | -                                                                                                 |
-| `t`             | वर्तमान locale के आधार पर सामग्री चुनता है।                                                                                         | [अनुवाद](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dictionary/translation.md) |
+| हुक             | विवरण                                                                                                                                        | संबंधित दस्तावेज़                                                                                                    |
+| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `useIntlayer`   | यह `useDictionary` पर आधारित है, लेकिन जनरेट की गई घोषणा से शब्दकोश का एक अनुकूलित संस्करण इंजेक्ट करता है।                                  | -                                                                                                                    |
+| `useDictionary` | ऐसे ऑब्जेक्ट्स को प्रोसेस करता है जो शब्दकोश जैसे दिखते हैं (key, content)। यह `t()` अनुवादों, enumerations आदि को प्रोसेस करता है।          | -                                                                                                                    |
+| `useLocale`     | वर्तमान locale और इसे सेट करने के लिए एक फ़ंक्शन लौटाता है।                                                                                  | -                                                                                                                    |
+| `usePathname`   | यह हुक (hook) locale सेगमेंट को हटाकर वर्तमान पाथनेम (pathname) लौटाता है। `popstate` के माध्यम से ब्राउज़र नेविगेशन पर प्रतिक्रिया करता है। | [usePathname](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/preact-intlayer/usePathname.md) |
+| `t`             | वर्तमान locale के आधार पर सामग्री चुनता है।                                                                                                  | [अनुवाद](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/dictionary/translation.md)                    |
 
 ### कंपोनेंट्स