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

package/docs/ur/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) سیگمنٹ، پروٹوکول/ہوسٹ، استفسار کی تار (query string)، ہیش اور ٹریلنگ سلیش (trailing slashes) کو نظرانداز کرتے ہوئے دو یو آر ایل (URLs) یا راستوں کی برابری کا موازنہ کرتا ہے۔ یہ اس بات کا تعین کرنے کا تجویز کردہ طریقہ ہے کہ آیا کوئی نیویگیشن لنک موجودہ صفحے کی طرف اشارہ کر رہا ہے — مثال کے طور پر فعال لنک کو اجاگر کرنے کے لیے — اپنا خود کا (غلطی کا شکار) معمول کی منطق (normalization logic) لکھے بغیر۔
+
+اندرونی طور پر یہ لوکیل سیگمنٹ کو ہٹانے کے لیے [`getPathWithoutLocale`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/packages/intlayer/getPathWithoutLocale.md) کو دوبارہ استعمال کرتا ہے، اس طرح یہ آپ کے تشکیل شدہ روٹنگ موڈ اور لوکیلز کا احترام کرتا ہے۔
+
+پیکیج ایک بنیادی [`normalizePath`](#normalizepath) مددگار (helper) کو بھی برآمد کرتا ہے، جو موازنہ کے لیے استعمال ہونے والا کینونیکل، لوکیل سے آزاد راستہ واپس کرتا ہے۔
+
+**کلیدی خصوصیات:**
+
+- لوکیل سے آزاد موازنہ (`/ur/about`, `/about` سے میل کھاتا ہے)
+- مطلق (absolute) URLs اور متعلقہ (relative) راستوں دونوں کے ساتھ کام کرتا ہے
+- استفسار کی تار (query string)، ہیش اور ٹریلنگ سلیش کو نظر انداز کرتا ہے
+- غائب معروف سلیش اور خالی اقدار کو برداشت کرتا ہے (`/` میں معمول کے مطابق)
+- ہلکا پھلکا — `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[]`
+  - **تفصیل**: حمایت یافتہ لوکیلز کا اختیاری مجموعہ (array)۔ پہلے سے طے شدہ طور پر پروجیکٹ میں تشکیل شدہ لوکیلز کو لیتا ہے۔
+  - **قسم**: `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
+```
+
+### مطلق اور رشتہ دار URLs
+
+```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/ur/packages/intlayer/getPathWithoutLocale.md): کسی URL یا راستے سے لوکیل سیگمنٹ کو ہٹاتا ہے۔
+- [`getPrefix`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/packages/intlayer/getPrefix.md): کسی دیئے گئے لوکیل کے لیے URL سابقہ (prefix) کا تعین کرتا ہے۔
+- [`getLocalizedUrl`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/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/vi/intlayer_with_adonisjs.md

@@ -59,24 +59,40 @@ Xem [Application Template](https://github.com/aymericzip/intlayer-adonisjs-templ
 
 Để bắt đầu sử dụng `adonis-intlayer`, hãy cài đặt gói bằng 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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
+
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
 ```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
 ```
 
 ### Thiết lập

package/docs/vi/intlayer_with_analog.md

@@ -118,24 +118,40 @@ Xem [Mẫu ứng dụng](https://github.com/aymericzip/intlayer-analog-template)
 
 Cài đặt các gói cần thiết bằng 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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
+
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
 ```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/vi/intlayer_with_angular_19.md

@@ -121,28 +121,44 @@ Xem [Mẫu ứng dụng](https://github.com/aymericzip/intlayer-angular-19-templ
 
 Cài đặt các gói cần thiết bằng 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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
+
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
 ```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/vi/intlayer_with_angular_21.md

@@ -123,28 +123,44 @@ Xem [Mẫu Ứng Dụng](https://github.com/aymericzip/intlayer-angular-21-templ
 
 Cài đặt các gói cần thiết bằng cách sử dụng 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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
+
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
 ```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/vi/intlayer_with_astro_lit.md

@@ -122,27 +122,39 @@ Xem [mẫu ứng dụng](https://github.com/aymericzip/intlayer-astro-template)
 Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer lit lit-intlayer @astrojs/lit
+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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
 
-npx intlayer init
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer lit lit-intlayer @astrojs/lit
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer lit lit-intlayer @astrojs/lit
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer lit lit-intlayer @astrojs/lit
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer lit lit-intlayer @astrojs/lit
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/vi/intlayer_with_astro_preact.md

@@ -121,27 +121,39 @@ Xem [mẫu ứng dụng](https://github.com/aymericzip/intlayer-astro-template)
 Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer preact preact-intlayer @astrojs/preact
+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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
 
-npx intlayer init
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer preact preact-intlayer @astrojs/preact
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer preact preact-intlayer @astrojs/preact
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer preact preact-intlayer @astrojs/preact
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer preact preact-intlayer @astrojs/preact
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/vi/intlayer_with_astro_react.md

@@ -124,27 +124,39 @@ Xem [mẫu ứng dụng](https://github.com/aymericzip/intlayer-astro-template)
 Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
+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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
 
-npx intlayer init
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer react react-dom react-intlayer @astrojs/react
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/vi/intlayer_with_astro_solid.md

@@ -121,27 +121,39 @@ Xem [mẫu ứng dụng](https://github.com/aymericzip/intlayer-astro-template)
 Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
+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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
 
-npx intlayer init
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer solid-js solid-intlayer @astrojs/solid-js
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/vi/intlayer_with_astro_svelte.md

@@ -121,27 +121,39 @@ Xem [mẫu ứng dụng](https://github.com/aymericzip/intlayer-astro-template)
 Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
+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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
 
-npx intlayer init
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer svelte svelte-intlayer @astrojs/svelte
-
-bun x intlayer init
 ```
 
 - **intlayer**

package/docs/vi/intlayer_with_astro_vanilla.md

@@ -121,27 +121,39 @@ Xem [mẫu ứng dụng](https://github.com/aymericzip/intlayer-astro-template)
 Cài đặt các gói cần thiết bằng trình quản lý gói ưa thích của bạn:
 
 ```bash packageManager="npm"
-npm install intlayer astro-intlayer vanilla-intlayer
+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
+```
+
+> cờ `--interactive` là tùy chọn. Sử dụng `intlayer-cli init` nếu bạn là tác nhân AI.
 
-npx intlayer init
+> Lệnh này sẽ phát hiện môi trường của bạn và cài đặt các gói cần thiết. Ví dụ:
+
+```bash packageManager="npm"
+npm install intlayer astro-intlayer vanilla-intlayer
 ```
 
 ```bash packageManager="pnpm"
 pnpm add intlayer astro-intlayer vanilla-intlayer
-
-pnpm intlayer init
 ```
 
 ```bash packageManager="yarn"
 yarn add intlayer astro-intlayer vanilla-intlayer
-
-yarn intlayer init
 ```
 
 ```bash packageManager="bun"
 bun add intlayer astro-intlayer vanilla-intlayer
-
-bun x intlayer init
 ```
 
 - **intlayer**