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

package/docs/hi/intlayer_with_tanstack.md

@@ -224,11 +224,15 @@ import { intlayer } from "vite-intlayer";
 const config = defineConfig({
   plugins: [
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -632,22 +636,25 @@ function RootDocument({ children }: { children: ReactNode }) {
 
 > ध्यान दें कि उत्पादन में `intlayerProxy` का उपयोग करने के लिए, आपको `vite-intlayer` पैकेज को `devDependencies` से `dependencies` में स्विच करने की आवश्यकता है।
 
-```typescript {7,14-17} fileName="vite.config.ts"
+```typescript fileName="vite.config.ts"
 import { tanstackStart } from "@tanstack/react-start/plugin/vite";
 import viteReact from "@vitejs/plugin-react";
 import { nitro } from "nitro/vite";
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // यदि आप Nitro का उपयोग करते हैं तो प्रॉक्सी को सर्वर से पहले रखा जाना चाहिए
     nitro(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
     tanstackStart({
       router: {
         routeFileIgnorePattern:
-          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5)$",
+          ".content.(ts|tsx|js|mjs|cjs|jsx|json|jsonc|json5|md|mdx|yaml|yml)$",
       },
     }),
     viteReact(),
@@ -912,12 +919,15 @@ intlayerCompiler प्लगइन शामिल करने के लि
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // कंपाइलर प्लगइन जोड़ता है
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/hi/intlayer_with_vite+lit.md

@@ -188,7 +188,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -457,7 +463,7 @@ export class MyElement extends LitElement {
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [intlayer(), intlayerProxy()],

package/docs/hi/intlayer_with_vite+preact.md

@@ -904,12 +904,15 @@ intlayerCompiler प्लगइन शामिल करने के लि
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // कंपाइलर प्लगइन जोड़ता है
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/hi/intlayer_with_vite+react.md

@@ -503,14 +503,17 @@ const App: FC = () => (
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     react(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -818,12 +821,15 @@ intlayerCompiler प्लगइन शामिल करने के लि
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // कंपाइलर प्लगइन जोड़ता है
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/hi/intlayer_with_vite+react_compiler.md

@@ -213,11 +213,18 @@ export default config;
 ```typescript fileName="vite.config.ts"
 import { defineConfig } from "vite";
 import react from "@vitejs/plugin-react-swc";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [react(), intlayer(), intlayerCompiler()],
+  plugins: [
+    react(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 

package/docs/hi/intlayer_with_vite+solid.md

@@ -583,12 +583,15 @@ intlayerCompiler प्लगइन शामिल करने के लि
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // कंपाइलर प्लगइन जोड़ता है
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/hi/intlayer_with_vite+svelte.md

@@ -426,7 +426,7 @@ $: content = useIntlayer('app', locale);
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import { svelte } from "@sveltejs/vite-plugin-svelte";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
   plugins: [intlayerProxy(), // should be placed first
  svelte(), intlayer()],
@@ -540,12 +540,15 @@ intlayerCompiler प्लगइन शामिल करने के लि
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // कंपाइलर प्लगइन जोड़ता है
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/hi/intlayer_with_vite+vanilla.md

@@ -188,7 +188,13 @@ import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
-  plugins: [intlayer()],
+  plugins: [
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
+  ],
 });
 ```
 
@@ -517,12 +523,15 @@ document.querySelector<HTMLDivElement>(".edit-note")!.innerHTML =
 
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // पहले रखा जाना चाहिए
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -654,6 +663,8 @@ bun x intlayer extract
  </Tab>
  <Tab value='Babel कंपाइलर'>
 
+> Since v9, the `intlayerCompiler` is included in the `intlayer` plugin. So you don't need to add it manually.
+
 `intlayerCompiler` प्लगइन शामिल करने के लिए अपना `vite.config.ts` अपडेट करें:
 
 ```ts fileName="vite.config.ts"
@@ -663,7 +674,7 @@ import { intlayer, intlayerCompiler } from "vite-intlayer";
 export default defineConfig({
   plugins: [
     intlayer(),
-    intlayerCompiler(), // कंपाइलर प्लगइन जोड़ता है
+    intlayerCompiler(), // Adds the compiler plugin
   ],
 });
 ```

package/docs/hi/intlayer_with_vite+vue.md

@@ -614,14 +614,17 @@ import LocaleSwitcher from "@components/LocaleSwitcher.vue";
 ```typescript {3,7} fileName="vite.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import { defineConfig } from "vite";
 import vue from "@vitejs/plugin-vue";
-import { intlayer, intlayerProxy } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 // https://vitejs.dev/config/
 export default defineConfig({
   plugins: [
-    intlayerProxy(), // should be placed first
     vue(),
-    intlayer(),
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```
@@ -949,12 +952,15 @@ intlayerCompiler प्लगइन शामिल करने के लि
 
 ```ts fileName="vite.config.ts"
 import { defineConfig } from "vite";
-import { intlayer, intlayerCompiler } from "vite-intlayer";
+import { intlayer } from "vite-intlayer";
 
 export default defineConfig({
   plugins: [
-    intlayer(),
-    intlayerCompiler(), // कंपाइलर प्लगइन जोड़ता है
+    intlayer({
+      proxy: {
+        ignore: (req) => req.url?.startsWith("/api"),
+      },
+    }),
   ],
 });
 ```

package/docs/hi/packages/@intlayer_babel/export.md

@@ -0,0 +1,131 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: "@intlayer/babel पैकेज दस्तावेज़"
+description: बिल्ड के दौरान सामग्री निष्कर्षण, आयात अनुकूलन, अप्रयुक्त फ़ील्ड को हटाने और फ़ील्ड नामों को विकृत (mangle) करने के लिए Intlayer हेतु Babel प्लगइन्स।
+keywords:
+  - "@intlayer/babel"
+  - babel
+  - plugin
+  - अंतर्राष्ट्रीयकरण
+  - i18n
+  - कंपाइलर
+  - अनुकूलन
+  - प्रून
+  - मिनिफाई
+slugs:
+  - doc
+  - packages
+  - "@intlayer/babel"
+  - export
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "सभी निर्यात दस्तावेज़ीकरण का एकीकरण"
+author: aymericzip
+---
+
+# @intlayer/babel पैकेज
+
+`@intlayer/babel` पैकेज Intlayer के लिए विशेष Babel प्लगइन्स का एक सेट प्रदान करता है। ये प्लगइन्स पूरे बिल्ड चक्र को कवर करते हैं: सामग्री घोषणाओं को निकालना, `useIntlayer` / `getIntlayer` कॉल को अनुकूलित शब्दकोश आयातों में फिर से लिखना, अप्रयुक्त फ़ील्ड को हटाना, और फ़ील्ड नामों को छोटा करना।
+
+## स्थापना
+
+```bash
+npm install @intlayer/babel
+```
+
+## निर्यात
+
+आयात (Import):
+
+```ts
+import { ... } from "@intlayer/babel";
+```
+
+---
+
+### प्लगइन्स
+
+| फ़ंक्शन / वर्ग                 | विवरण                                                                                                                                                                                                             |
+| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `intlayerExtractBabelPlugin`   | Babel प्लगइन जो स्रोत फ़ाइलों से अनुवाद योग्य सामग्री निकालता है और `useIntlayer` / `getIntlayer` हुक को स्वचालित रूप से इंजेक्ट करता है। Next.js और Babel-आधारित बिल्ड टूल के साथ उपयोग के लिए डिज़ाइन किया गया। |
+| `intlayerOptimizeBabelPlugin`  | `useIntlayer` और `getIntlayer` कॉल को रूपांतरित करता है और उनके आयात को अनुकूलित JSON शब्दकोश आयात (स्थिर, गतिशील, या fetch के माध्यम से) में फिर से लिखता है।                                                    |
+| `intlayerPurgeBabelPlugin`     | Babel प्लгин जो स्रोत फ़ाइलों का विश्लेषण करता है और अप्रयुक्त फ़ील्ड (`build.purge`) को हटाने या उन्हें छोटे उपनामों (`build.minify`) में बदलने के लिए संकलित शब्दкош JSON फ़ाइलों को फिर से लिखता है।           |
+| `intlayerMinifyBabelPlugin`    | Babel प्लगइन जो स्रोत फ़ाइलों को छोटा करने के चरण के दौरान सौंपे गए छोटे फ़ील्ड उपनामों (जैसे `content.title` ← `content.a`) का उपयोग करने के लिए फिर से लिखता है। `intlayerPurgeBabelPlugin` पर निर्भर करता है।  |
+| `makeFieldRenameBabelPlugin`   | फ़ैक्टरी फ़ंक्शन जो `PruneContext` में भरे गए `dictionaryKeyToFieldRenameMap` के अनुसार स्रोत फ़ाइलों में शब्दकोश सामग्री फ़ील्ड एक्सेस का नाम बदलने के लिए एक Babel प्लगइन उत्पन्न करता है।                      |
+| `makeUsageAnalyzerBabelPlugin` | फ़ैक्टरी फ़ंक्शन जो स्रोत कोड में `useIntlayer` / `getIntlayer` के उपयोग का विश्लेषण करने और साझा `PruneContext` में फ़ील्ड उपयोग डेटा एकत्र करने के लिए एक Babel प्लगइन उत्पन्न करता है।                         |
+| `getSharedPruneContext`        | सहायक फ़ंक्शन जो निर्दिष्ट आधार निर्देशिका के लिए साझा `PruneContext` ऑब्जेक्ट लौटाता है, या यदि यह अभी तक आरंभ नहीं हुआ है तो `null` लौटाता है।                                                                  |
+
+---
+
+### प्लगइन कॉन्फ़िगरेशन उपयोगिताएँ
+
+| फ़ंक्शन                    | विवरण                                                                                                                                                   |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `getExtractPluginOptions`  | Intlayer कॉन्फ़िगरेशन लोड करता है और `intlayerExtractBabelPlugin` के साथ उपयोग के लिए तैयार `ExtractPluginOptions` लौटाता है।                           |
+| `getOptimizePluginOptions` | Intlayer कॉन्फ़िगरेशन और संकलित शब्दकोशों को लोड करता है, और `intlayerOptimizeBabelPlugin` के साथ उपयोग के लिए तैयार `OptimizePluginOptions` लौटाता है। |
+| `getPurgePluginOptions`    | Intlayer कॉन्फ़िगरेशन लोड करता है और `intlayerPurgeBabelPlugin` के साथ उपयोग के लिए तैयार `PurgePluginOptions` लौटाता है।                               |
+| `getMinifyPluginOptions`   | Intlayer कॉन्फ़िगरेशन लोड करता है और `intlayerMinifyBabelPlugin` के साथ उपयोग के लिए तैयार `MinifyPluginOptions` लौटाता है।                             |
+
+---
+
+### प्रकार
+
+| प्रकार                  | विवरण                                                                                                            |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `CompilerMode`          | कंपाइलर मोड: `'dev'` HMR समर्थन के साथ विकास के लिए, या `'build'` उत्पादन बिल्ड के लिए।                          |
+| `ExtractPluginOptions`  | `intlayerExtractBabelPlugin` के लिए विकल्प: फ़ाइल सूची, कॉन्फ़िगरेशन, `onExtract` कॉलबैक आदि।                    |
+| `ExtractResult`         | निष्कर्षण परिणाम: शब्दकोश कुंजी, फ़ाइल पथ, सामग्री और लोकेल।                                                     |
+| `OptimizePluginOptions` | `intlayerOptimizeBabelPlugin` के लिए विकल्प: शब्दकोश पथ, आयात मोड, प्रति शब्दकोश मोड मानचित्र आदि।               |
+| `PurgePluginOptions`    | `intlayerPurgeBabelPlugin` के लिए विकल्प: आधार निर्देशिका, प्रून/मिनिफाई/ऑप्टिमाइज़ फ़्लैग, घटक फ़ाइल सूची।      |
+| `MinifyPluginOptions`   | `intlayerMinifyBabelPlugin` के लिए विकल्प: आधार निर्देशिका, मिनिफाई/ऑप्टिमाइज़/editorEnabled फ़्लैग।             |
+| `PruneContext`          | विश्लेषण और प्रून प्लगइन्स के बीच साझा स्थिति: फ़ील्ड उपयोग मानचित्र, नाम बदलें मानचित्र आदि।                    |
+| `DictionaryFieldUsage`  | एकल शब्दकोश के लिए फ़ील्ड उपयोग परिणाम: `Set<string>` या `'all'` जब स्थिर विश्लेषण अनिर्णायक होता है।            |
+| `NestedRenameEntry`     | नाम बदलने वाले पेड़ में नोड: `shortName` और बच्चों का मानचित्र।                                                  |
+| `NestedRenameMap`       | नाम बदलने वाले पेड़ में एक स्तर: `Map<string, NestedRenameEntry>`।                                               |
+| `CompatCallerConfig`    | `compat-adapter` पैकेजों के लिए एक संगत उपयोग विश्लेषक कॉन्फ़िगरेशन (कॉल करने वाले का नाम और प्रसंस्करण विकल्प)। |
+| `ScriptBlock`           | एक SFC फ़ाइल (Vue या Svelte) से निकाली गई स्क्रिप्ट ब्लॉक: सामग्री, प्रारंभ ऑफ़सेट और अंत ऑफ़सेट।                |
+
+---
+
+### उपयोगिता फ़ंक्शन
+
+| फ़ंक्शन                           | विवरण                                                                                                                                                     |
+| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `generateShortFieldName`          | एक पूर्णांक (शून्य से शुरू) को एक छोटे वर्णानुक्रमिक पहचानकर्ता में परिवर्तित करता है: `0` → `'a'`, `25` → `'z'`, `26` → `'aa'`, आदि।                     |
+| `buildNestedRenameMapFromContent` | Intlayer नोड संरचनाओं (translation, enumeration आदि) का सम्मान करते हुए संकलित शब्दकोश के सामग्री मान से पुनरावर्ती रूप से एक `NestedRenameMap` बनाता है। |
+| `createPruneContext`              | डिफ़ॉल्ट मानों के साथ आरंभ की गई एक नई खाली `PruneContext` ऑब्जेक्ट बनाता है।                                                                             |
+| `extractScriptBlocks`             | बाद के Babel विश्लेषण के लिए SFC फ़ाइलों (Vue / Svelte) से `<script>` ब्लॉक निकालता है।                                                                   |
+| `BABEL_PARSER_OPTIONS`            | स्थिरांक जो समर्थित फ्रेमवर्क (React/Vue/Svelte/Angular/...) को कवर करने वाले Babel पार्सर विकल्पों का प्रतिनिधित्व करता है।                              |
+| `INTLAYER_CALLER_NAMES`           | मूल Intlayer कॉल करने वाले नामों की स्थिर सूची: `['useIntlayer', 'getIntlayer']`।                                                                         |
+
+---
+
+## उपयोग का उदाहरण
+
+```js
+// babel.config.js
+const {
+  intlayerExtractBabelPlugin,
+  intlayerPurgeBabelPlugin,
+  intlayerMinifyBabelPlugin,
+  intlayerOptimizeBabelPlugin,
+  getExtractPluginOptions,
+  getPurgePluginOptions,
+  getMinifyPluginOptions,
+  getOptimizePluginOptions,
+} = require("@intlayer/babel");
+
+module.exports = {
+  presets: ["next/babel"],
+  plugins: [
+    [intlayerExtractBabelPlugin, getExtractPluginOptions()],
+    [intlayerPurgeBabelPlugin, getPurgePluginOptions()],
+    [intlayerMinifyBabelPlugin, getMinifyPluginOptions()],
+    [intlayerOptimizeBabelPlugin, getOptimizePluginOptions()],
+  ],
+};
+```
+
+> **ध्यान दें:** `intlayerPurgeBabelPlugin` को `intlayerMinifyBabelPlugin` से **पहले** घोषित किया जाना चाहिए, क्योंकि बाद वाला पहले वाले द्वारा निर्मित नाम बदलने के मानचित्र को पढ़ता है। इसके अलावा, दोनों से पहले `intlayerOptimizeBabelPlugin` होना चाहिए ताकि यह `useIntlayer` कॉल के फिर से लिखे जाने से पहले शब्दकोश कुंजियों को देख सके।

package/docs/hi/packages/vite-intlayer/intlayerCompiler.md

@@ -0,0 +1,120 @@
+---
+createdAt: 2026-06-25
+updatedAt: 2026-06-25
+title: intlayerCompiler Vite प्लगइन दस्तावेज़ | vite-intlayer
+description: Vite प्लगइन जो घटक फ़ाइलों से इनलाइन Intlayer सामग्री घोषणाओं को निकालता है और उन्हें बिल्ड/ट्रांसफ़ॉर्म समय पर शब्दकोश JSON फ़ाइलों में लिखता है।
+keywords:
+  - intlayerCompiler
+  - vite
+  - प्लगइन
+  - कंपाइलर
+  - सामग्री
+  - शब्दकोश
+  - अंतर्राष्ट्रीयकरण
+  - i18n
+slugs:
+  - doc
+  - packages
+  - vite-intlayer
+  - intlayerCompiler
+history:
+  - version: 9.0.0
+    date: 2026-06-25
+    changes: "intlayer() में बंडल किया गया; दस्तावेज़ प्रारंभ"
+author: aymericzip
+---
+
+# intlayerCompiler
+
+`intlayerCompiler` एक Vite प्लगइन है जो घटक स्रोत फ़ाइलों को **इनलाइन Intlayer सामग्री घोषणाओं** — एक अलग `.content.ts` फ़ाइल के बजाय सीधे एक घटक के अंदर परिभाषित सामग्री — के लिए स्कैन करता है और उन्हें ट्रांसफ़ॉर्म चरण के दौरान शब्दकोश JSON फ़ाइलों में लिखता है।
+
+> **Intlayer v9 से** `intlayerCompiler` स्वचालित रूप से मुख्य [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/packages/vite-intlayer/intlayer.md) प्लगइन के अंदर शामिल होता है जब आपके Intlayer कॉन्फ़िगरेशन में `compiler.enabled` दोनों `true` और `compiler.output` सेट होते हैं। आपको इसे अलग से पंजीकृत करने की आवश्यकता केवल तब होती है जब आप कंपाइलर-विशिष्ट कॉन्फ़िगरेशन पर पूर्ण नियंत्रण चाहते हैं।
+
+## उपयोग
+
+### `intlayer()` के हिस्से के रूप में (अनुशंसित, v9+)
+
+अपने Intlayer कॉन्फ़िगरेशन के माध्यम से कंपाइलर को सक्षम करें:
+
+```ts
+// intlayer.config.ts
+import { defineConfig } from "intlayer";
+
+export default defineConfig({
+  compiler: {
+    enabled: true,
+    output: "./src/dictionaries", // जहां निकाली गई शब्दकोश लिखी जाती हैं
+  },
+});
+```
+
+फिर बिना किसी अतिरिक्त पंजीकरण के मानक प्लगइन का उपयोग करें:
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayer } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayer()],
+});
+```
+
+### स्टैंडअलोन (जब आवश्यकता हो)
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import { intlayerCompiler } from "vite-intlayer";
+
+export default defineConfig({
+  plugins: [intlayerCompiler()],
+});
+```
+
+## विकल्प
+
+```ts
+import type { IntlayerCompilerOptions } from "vite-intlayer";
+```
+
+| विकल्प           | प्रकार                    | विवरण                                                                                         |
+| ---------------- | ------------------------- | --------------------------------------------------------------------------------------------- |
+| `configOptions`  | `GetConfigurationOptions` | Intlayer कॉन्फ़िगरेशन ओवरराइड्स जो `getConfiguration()` को अग्रेषित किए जाते हैं।             |
+| `compilerConfig` | `Partial<CompilerConfig>` | कंपाइलर-विशिष्ट कॉन्फ़िगरेशन अनुभाग (जैसे `enabled`, `output`, `filesList`) के लिए ओवरराइड्स। |
+
+### उदाहरण
+
+```ts
+intlayerCompiler({
+  configOptions: { configFile: "./config/intlayer.config.ts" },
+  compilerConfig: { enabled: true, output: "./src/dictionaries" },
+});
+```
+
+## यह कैसे काम करता है
+
+### ट्रांसफ़ॉर्म चरण
+
+प्रत्येक स्रोत फ़ाइल के लिए जो `compiler.filesList` से मेल खाती है, कंपाइलर प्लगइन:
+
+1. फ़ाइल सामग्री को `@intlayer/babel` से `extractContent` के माध्यम से पास करता है।
+2. पाई गई प्रत्येक घोषणा के लिए `onExtract` को कॉल करता है, जो परिणामी शब्दकोश JSON को `compiler.output` में लिखता है।
+3. मानक `useIntlayer('key')` / `getIntlayer('key')` कॉल द्वारा प्रतिस्थापित इनलाइन घोषणाओं के साथ ट्रांसफ़ॉर्म किए गए स्रोत कोड को लौटाता है।
+
+समर्थित फ़ाइल प्रकार: `.ts`, `.tsx`, `.js`, `.jsx`, `.vue`, `.svelte`, `.astro`।
+
+### HMR (हॉट मॉड्यूल रिप्लेसमेंट)
+
+जब विकास मोड में एक घटक फ़ाइल सहेजी जाती है, तो कंपाइलर:
+
+1. Vite के `handleHotUpdate` हुक के माध्यम से फ़ाइल परिवर्तन का पता लगाता है।
+2. अपडेट की गई फ़ाइल से सामग्री को फिर से निकालता है।
+3. अपडेट किए गए शब्दकोश JSON को लिखता है।
+4. पूर्ण पृष्ठ पुनरारंभ (`server.ws.send({ type: 'full-reload' })`) को ट्रिगर करता है।
+
+500 ms का डिबाउंस शब्दकोश लिखने को स्वयं (जो एक फ़ाइल-परिवर्तन ईवेंट को भी ट्रिगर करता है) एक अनंत पुनः निष्कर्षण लूप पैदा करने से रोकता है।
+
+### डिडुप्लीकेशन
+
+`intlayerCompiler` अन्य बंडल प्लगइन्स की तरह ही `createPrimaryInstanceGuard` डिडुप्लीकेशन तंत्र का उपयोग करता है। जब `intlayer()` (जो कंपाइलर को बंडल करता है) और एक मैन्युअल `intlayerCompiler()` कॉल दोनों मौजूद होते हैं, तो केवल पहला पंजीकृत उदाहरण चलता है — कोई भी शब्दकोश दो बार नहीं लिखा जाता है।