@intlayer/docs 5.5.8

package/hi/packages/intlayer/getMultilingualUrls.md

@@ -0,0 +1,198 @@
+# दस्तावेज़: `getMultilingualUrls` फ़ंक्शन `intlayer` में
+
+## विवरण
+
+`getMultilingualUrls` फ़ंक्शन बहुभाषी URLs का एक मैपिंग उत्पन्न करता है, दिए गए URL को प्रत्येक समर्थित लोकेल के साथ प्रीफिक्स करके। यह दोनों पूर्ण और सापेक्ष URLs को संभाल सकता है, प्रदान की गई कॉन्फ़िगरेशन या डिफ़ॉल्ट्स के आधार पर उपयुक्त लोकेल प्रीफिक्स लागू करता है।
+
+---
+
+## पैरामीटर्स
+
+- `url: string`
+
+  - **विवरण**: मूल URL स्ट्रिंग जिसे लोकेल्स के साथ प्रीफिक्स किया जाना है।
+  - **प्रकार**: `string`
+
+- `locales: Locales[]`
+
+  - **विवरण**: समर्थित लोकेल्स की वैकल्पिक सूची। प्रोजेक्ट में कॉन्फ़िगर किए गए लोकेल्स को डिफ़ॉल्ट मानता है।
+  - **प्रकार**: `Locales[]`
+  - **डिफ़ॉल्ट**: `localesDefault`
+
+- `defaultLocale: Locales`
+
+  - **विवरण**: एप्लिकेशन के लिए डिफ़ॉल्ट लोकेल। प्रोजेक्ट में कॉन्फ़िगर किए गए डिफ़ॉल्ट लोकेल को डिफ़ॉल्ट मानता है।
+  - **प्रकार**: `Locales`
+  - **डिफ़ॉल्ट**: `defaultLocaleDefault`
+
+- `prefixDefault: boolean`
+  - **विवरण**: डिफ़ॉल्ट लोकेल को प्रीफिक्स करना है या नहीं। प्रोजेक्ट में कॉन्फ़िगर किए गए मान को डिफ़ॉल्ट मानता है।
+  - **प्रकार**: `boolean`
+  - **डिफ़ॉल्ट**: `prefixDefaultDefault`
+
+### रिटर्न्स
+
+- **प्रकार**: `IConfigLocales<string>`
+- **विवरण**: प्रत्येक लोकेल को उसके संबंधित बहुभाषी URL के साथ मैप करने वाला एक ऑब्जेक्ट।
+
+---
+
+## उदाहरण उपयोग
+
+### सापेक्ष URLs
+
+```typescript codeFormat="typescript"
+import { getMultilingualUrls, Locales } from "intlayer";
+
+getMultilingualUrls(
+  "/dashboard",
+  [Locales.ENGLISH, Locales.FRENCH],
+  Locales.ENGLISH,
+  false
+);
+// आउटपुट: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
+```javascript codeFormat="esm"
+import { getMultilingualUrls, Locales } from "intlayer";
+
+getMultilingualUrls(
+  "/dashboard",
+  [Locales.ENGLISH, Locales.FRENCH],
+  Locales.ENGLISH,
+  false
+);
+// आउटपुट: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
+```javascript codeFormat="commonjs"
+const { getMultilingualUrls, Locales } = require("intlayer");
+
+getMultilingualUrls(
+  "/dashboard",
+  [Locales.ENGLISH, Locales.FRENCH],
+  Locales.ENGLISH,
+  false
+);
+// आउटपुट: {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard"
+// }
+```
+
+### पूर्ण URLs
+
+```typescript
+getMultilingualUrls(
+  "https://example.com/dashboard",
+  [Locales.ENGLISH, Locales.FRENCH],
+  Locales.ENGLISH,
+  true
+);
+// आउटपुट: {
+//   en: "https://example.com/en/dashboard",
+//   fr: "https://example.com/fr/dashboard"
+// }
+```
+
+---
+
+## किनारे के मामले
+
+- **कोई लोकेल सेगमेंट नहीं:**
+
+  - फ़ंक्शन URL से किसी भी मौजूदा लोकेल सेगमेंट को हटाता है, इससे पहले कि बहुभाषी मैपिंग उत्पन्न हो।
+
+- **डिफ़ॉल्ट लोकेल:**
+
+  - जब `prefixDefault` `false` होता है, तो फ़ंक्शन डिफ़ॉल्ट लोकेल के लिए URL को प्रीफिक्स नहीं करता।
+
+- **असमर्थित लोकेल्स:**
+  - केवल `locales` ऐरे में प्रदान किए गए लोकेल्स को URLs उत्पन्न करने के लिए माना जाता है।
+
+---
+
+## एप्लिकेशन में उपयोग
+
+एक बहुभाषी एप्लिकेशन में, `locales` और `defaultLocale` के साथ अंतर्राष्ट्रीयकरण सेटिंग्स को कॉन्फ़िगर करना सही भाषा सुनिश्चित करने के लिए महत्वपूर्ण है। नीचे दिखाया गया है कि `getMultilingualUrls` को एप्लिकेशन सेटअप में कैसे उपयोग किया जा सकता है:
+
+```tsx codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+// समर्थित लोकेल्स और डिफ़ॉल्ट लोकेल के लिए कॉन्फ़िगरेशन
+export default {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+} satisfies IntlayerConfig;
+
+export default config;
+```
+
+```javascript codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+उपरोक्त कॉन्फ़िगरेशन यह सुनिश्चित करता है कि एप्लिकेशन `ENGLISH`, `FRENCH`, और `SPANISH` को समर्थित भाषाओं के रूप में पहचानता है और `ENGLISH` को बैकअप भाषा के रूप में उपयोग करता है।
+
+इस कॉन्फ़िगरेशन का उपयोग करके, `getMultilingualUrls` फ़ंक्शन एप्लिकेशन के समर्थित लोकेल्स के आधार पर गतिशील रूप से बहुभाषी URL मैपिंग उत्पन्न कर सकता है:
+
+```typescript
+getMultilingualUrls(
+  "/dashboard",
+  [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  Locales.ENGLISH
+);
+// आउटपुट:
+// {
+//   en: "/dashboard",
+//   fr: "/fr/dashboard",
+//   es: "/es/dashboard"
+// }
+
+getMultilingualUrls(
+  "https://example.com/dashboard",
+  [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+  Locales.ENGLISH,
+  true
+);
+// आउटपुट:
+// {
+//   en: "https://example.com/en/dashboard",
+//   fr: "https://example.com/fr/dashboard",
+//   es: "https://example.com/es/dashboard"
+// }
+```
+
+`getMultilingualUrls` को एकीकृत करके, डेवलपर्स कई भाषाओं में सुसंगत URL संरचनाओं को बनाए रख सकते हैं, जिससे उपयोगकर्ता अनुभव और SEO दोनों में सुधार होता है।

package/hi/packages/intlayer/getPathWithoutLocale.md

@@ -0,0 +1,50 @@
+# दस्तावेज़: `getPathWithoutLocale` फ़ंक्शन `intlayer` में
+
+## विवरण
+
+दिए गए URL या पथनाम से स्थानीय खंड को हटा देता है यदि वह मौजूद हो। यह पूर्ण URLs और सापेक्ष पथनाम दोनों के साथ काम करता है।
+
+## पैरामीटर
+
+- `inputUrl: string`
+
+  - **विवरण**: प्रक्रिया के लिए पूर्ण URL स्ट्रिंग या पथनाम।
+  - **प्रकार**: `string`
+
+- `locales: Locales[]`
+  - **विवरण**: समर्थित स्थानीयताओं की वैकल्पिक सूची। प्रोजेक्ट में कॉन्फ़िगर की गई स्थानीयताओं को डिफ़ॉल्ट करता है।
+  - **प्रकार**: `Locales[]`
+
+## रिटर्न्स
+
+- **प्रकार**: `string`
+- **विवरण**: स्थानीय खंड के बिना URL स्ट्रिंग या पथनाम।
+
+## उदाहरण उपयोग
+
+```typescript codeFormat="typescript"
+import { getPathWithoutLocale } from "intlayer";
+
+console.log(getPathWithoutLocale("/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("/en/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("/fr/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("https://example.com/en/dashboard")); // आउटपुट: "https://example.com/dashboard"
+```
+
+```javascript codeFormat="esm"
+import { getPathWithoutLocale } from "intlayer";
+
+console.log(getPathWithoutLocale("/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("/en/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("/fr/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("https://example.com/en/dashboard")); // आउटपुट: "https://example.com/dashboard"
+```
+
+```javascript codeFormat="commonjs"
+const { getPathWithoutLocale } = require("intlayer");
+
+console.log(getPathWithoutLocale("/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("/en/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("/fr/dashboard")); // आउटपुट: "/dashboard"
+console.log(getPathWithoutLocale("https://example.com/en/dashboard")); // आउटपुट: "https://example.com/dashboard"
+```

package/hi/packages/intlayer/getTranslation.md

@@ -0,0 +1,175 @@
+# दस्तावेज़: `getTranslationContent` फ़ंक्शन `intlayer` में
+
+## विवरण
+
+`getTranslationContent` फ़ंक्शन एक सेट से एक विशिष्ट लोकेल के लिए सामग्री प्राप्त करता है जो अनुकूलन योग्य भाषा सामग्री है। यदि निर्दिष्ट लोकेल नहीं मिलता है, तो यह प्रोजेक्ट में कॉन्फ़िगर किए गए डिफ़ॉल्ट लोकेल की सामग्री को लौटाता है।
+
+## पैरामीटर
+
+- `languageContent: CustomizableLanguageContent<Content>`
+
+  - **विवरण**: एक ऑब्जेक्ट जिसमें विभिन्न लोकेल्स के लिए अनुवाद होते हैं। प्रत्येक कुंजी एक लोकेल का प्रतिनिधित्व करती है, और इसका मान संबंधित सामग्री है।
+  - **प्रकार**: `CustomizableLanguageContent<Content>`
+    - `Content` किसी भी प्रकार का हो सकता है, डिफ़ॉल्ट रूप से `string`।
+
+- `locale: Locales`
+
+  - **विवरण**: वह लोकेल जिसके लिए सामग्री प्राप्त की जानी है।
+  - **प्रकार**: `Locales`
+
+## रिटर्न्स
+
+- **प्रकार**: `Content`
+- **विवरण**: निर्दिष्ट लोकेल के लिए सामग्री। यदि लोकेल नहीं मिलता है, तो डिफ़ॉल्ट लोकेल की सामग्री लौटाई जाती है।
+
+## उदाहरण उपयोग
+
+### बुनियादी उपयोग
+
+```typescript codeFormat="typescript"
+import { getTranslationContent, Locales } from "intlayer";
+
+const content = getTranslationContent(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="esm"
+import { getTranslationContent, Locales } from "intlayer";
+
+const content = getTranslationContent(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslationContent, Locales } = require("intlayer");
+
+const content = getTranslationContent(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // आउटपुट: "Bonjour"
+```
+
+### गायब लोकेल:
+
+```typescript codeFormat="typescript"
+import { getTranslationContent, Locales } from "intlayer";
+
+const content = getTranslationContent(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // आउटपुट: "Hello" (डिफ़ॉल्ट लोकेल सामग्री)
+```
+
+```javascript codeFormat="esm"
+import { getTranslationContent, Locales } from "intlayer";
+
+const content = getTranslationContent(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // आउटपुट: "Hello" (डिफ़ॉल्ट लोकेल सामग्री)
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslationContent, Locales } = require("intlayer");
+
+const content = getTranslationContent(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // आउटपुट: "Hello" (डिफ़ॉल्ट लोकेल सामग्री)
+```
+
+### कस्टम सामग्री प्रकारों का उपयोग:
+
+```typescript codeFormat="typescript"
+import { getTranslationContent, Locales } from "intlayer";
+
+const customContent = getTranslationContent<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    hi: { greeting: "नमस्ते" },
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="esm"
+import { getTranslationContent, Locales } from "intlayer";
+
+const customContent = getTranslationContent<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    hi: { greeting: "नमस्ते" },
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslationContent, Locales } = require("intlayer");
+
+const customContent = getTranslationContent<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    hi: { greeting: "नमस्ते" },
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // आउटपुट: "Bonjour"
+```
+
+## किनारे के मामले
+
+- **लोकेल नहीं मिला:**
+  - जब `locale` `languageContent` में नहीं मिलता है, तो फ़ंक्शन डिफ़ॉल्ट लोकेल की सामग्री लौटाता है।
+- **अधूरी भाषा सामग्री:**
+  - यदि कोई लोकेल आंशिक रूप से परिभाषित है, तो फ़ंक्शन सामग्री को मर्ज नहीं करता है। यह निर्दिष्ट लोकेल का मान सख्ती से प्राप्त करता है या डिफ़ॉल्ट पर वापस आ जाता है।
+- **टाइपस्क्रिप्ट प्रवर्तन:**
+  - यदि `languageContent` में लोकेल्स प्रोजेक्ट कॉन्फ़िगरेशन से मेल नहीं खाते हैं, तो टाइपस्क्रिप्ट सभी आवश्यक लोकेल्स को परिभाषित करने के लिए मजबूर करेगा, जिससे सामग्री पूरी और प्रकार-सुरक्षित हो।

package/hi/packages/intlayer/getTranslationContent.md

@@ -0,0 +1,175 @@
+# दस्तावेज़: `getTranslation` फ़ंक्शन `intlayer` में
+
+## विवरण
+
+`getTranslation` फ़ंक्शन एक सेट से एक विशिष्ट लोकेल के लिए सामग्री प्राप्त करता है जिसमें अनुकूलन योग्य भाषा सामग्री होती है। यदि निर्दिष्ट लोकेल नहीं मिलता है, तो यह प्रोजेक्ट में कॉन्फ़िगर किए गए डिफ़ॉल्ट लोकेल की सामग्री को लौटाता है।
+
+## पैरामीटर्स
+
+- `languageContent: CustomizableLanguageContent<Content>`
+
+  - **विवरण**: विभिन्न लोकेल्स के लिए अनुवादों को संग्रहीत करने वाली एक वस्तु। प्रत्येक कुंजी एक लोकेल का प्रतिनिधित्व करती है, और इसका मान संबंधित सामग्री है।
+  - **प्रकार**: `CustomizableLanguageContent<Content>`
+    - `Content` किसी भी प्रकार का हो सकता है, डिफ़ॉल्ट रूप से `string`।
+
+- `locale: Locales`
+
+  - **विवरण**: वह लोकेल जिसके लिए सामग्री प्राप्त की जानी है।
+  - **प्रकार**: `Locales`
+
+## रिटर्न्स
+
+- **प्रकार**: `Content`
+- **विवरण**: निर्दिष्ट लोकेल के लिए सामग्री। यदि लोकेल नहीं मिलता है, तो डिफ़ॉल्ट लोकेल की सामग्री लौटाई जाती है।
+
+## उदाहरण उपयोग
+
+### बुनियादी उपयोग
+
+```typescript codeFormat="typescript"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="esm"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslation, Locales } = require("intlayer");
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.ENGLISH
+);
+
+console.log(content); // आउटपुट: "Bonjour"
+```
+
+### गायब लोकेल:
+
+```typescript codeFormat="typescript"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // आउटपुट: "Hello" (डिफ़ॉल्ट लोकेल सामग्री)
+```
+
+```javascript codeFormat="esm"
+import { getTranslation, Locales } from "intlayer";
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // आउटपुट: "Hello" (डिफ़ॉल्ट लोकेल सामग्री)
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslation, Locales } = require("intlayer");
+
+const content = getTranslation(
+  {
+    en: "Hello",
+    fr: "Bonjour",
+    hi: "नमस्ते",
+  },
+  Locales.SPANISH
+);
+
+console.log(content); // आउटपुट: "Hello" (डिफ़ॉल्ट लोकेल सामग्री)
+```
+
+### कस्टम सामग्री प्रकारों का उपयोग:
+
+```typescript codeFormat="typescript"
+import { getTranslation, Locales } from "intlayer";
+
+const customContent = getTranslation<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    hi: { greeting: "नमस्ते" },
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="esm"
+import { getTranslation, Locales } from "intlayer";
+
+const customContent = getTranslation<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    hi: { greeting: "नमस्ते" },
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // आउटपुट: "Bonjour"
+```
+
+```javascript codeFormat="commonjs"
+const { getTranslation, Locales } = require("intlayer");
+
+const customContent = getTranslation<Record<string, string>>(
+  {
+    en: { greeting: "Hello" },
+    fr: { greeting: "Bonjour" },
+    hi: { greeting: "नमस्ते" },
+  },
+  Locales.FRENCH
+);
+
+console.log(customContent.greeting); // आउटपुट: "Bonjour"
+```
+
+## किनारे के मामले
+
+- **लोकेल नहीं मिला:**
+  - जब `locale` `languageContent` में नहीं मिलता है, तो फ़ंक्शन डिफ़ॉल्ट लोकेल की सामग्री लौटाता है।
+- **अधूरी भाषा सामग्री:**
+  - यदि कोई लोकेल आंशिक रूप से परिभाषित है, तो फ़ंक्शन सामग्री को मर्ज नहीं करता है। यह निर्दिष्ट लोकेल का मान सख्ती से प्राप्त करता है या डिफ़ॉल्ट पर वापस लौटता है।
+- **टाइपस्क्रिप्ट प्रवर्तन:**
+  - यदि `languageContent` में लोकेल्स प्रोजेक्ट कॉन्फ़िगरेशन से मेल नहीं खाते हैं, तो टाइपस्क्रिप्ट सभी आवश्यक लोकेल्स को परिभाषित करने को लागू करेगा, जिससे सामग्री पूर्ण और प्रकार-सुरक्षित हो जाएगी।