@intlayer/docs 7.5.11 → 7.5.13

package/docs/zh/plugins/sync-json.md

@@ -108,17 +108,21 @@ syncJSON({
   source: ({ key, locale }) => string, // 必填
   location?: string, // 可选标签，默认值："plugin"
   priority?: number, // 可选优先级，用于冲突解决，默认值：0
-  format?: 'intlayer' | 'icu' | 'i18next', // 可选格式化器，默认值：'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // 可选格式化器，用于 Intlayer 运行时兼容性
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-指定在同步 JSON 文件时用于字典内容的格式化器。这允许使用与各种 i18n 库兼容的不同消息格式化语法。
+指定在同步 JSON 文件时用于字典内容的格式化器。这允许使用与 Intlayer 运行时兼容的不同消息格式化语法。
 
-- `'intlayer'`: 默认的 Intlayer 格式化器（默认值）。
-- `'icu'`: 使用 ICU 消息格式化（与 react-intl、vue-i18n 等库兼容）。
-- `'i18next'`: 使用 i18next 消息格式化（与 i18next、next-i18next、Solid-i18next 兼容）。
+- `undefined`：不使用格式化器，JSON 内容将按原样使用。
+- `'intlayer'`：默认的 Intlayer 格式化器（默认值）。
+- `'icu'`：使用 ICU 消息格式化（与 react-intl、vue-i18n 等库兼容）。
+- `'i18next'`：使用 i18next 消息格式化（与 i18next、next-i18next、Solid-i18next 兼容）。
+
+> 请注意，使用格式化器会转换您的 JSON 内容的输入和输出。对于复杂的 JSON 规则（如 ICU 复数），解析可能无法确保输入和输出之间的 1 对 1 映射。
+> 如果您不使用 Intlayer 运行时，您可能更倾向于不设置格式化器。
 
 **示例：**
 

package/frequent_questions/ar/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # هل من الممكن استخدام Intlayer مع Next.js بدون `[locale]` في مسار الصفحة؟

package/frequent_questions/ar/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` و Intlayer – خطأ رفض زائف `node:fs`
+description: لماذا تبلغ vite-env-only عن رفض استيراد `node:fs` عند استخدام Intlayer + React-Router + Vite وماذا تفعل.
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - رفض الاستيراد
+  - alias
+  - حزمة العميل
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only يرفض `node:fs` مع Intlayer
+
+إذا استخدمت الإضافة **vite-env-only** (كما ذُكر في اقتراحات React-Router v7 الأقدم) ورأيت:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…على الرغم من أنه **لا يوجد `node:fs` في حزمة العميل الخاصة بك**، إلا أن هذا هو **إيجابي كاذب**.
+
+## ما الذي يسببه
+
+`vite-env-only` يقوم بفحص يعتمد على Babel **في وقت مبكر أثناء حل مخطط الاعتماديات في Vite**، _قبل_:
+
+- aliasing (بما في ذلك خرائط Intlayer بين المتصفح وNode),
+- إزالة الشيفرة غير المُستخدمة (dead-code elimination),
+- حل SSR مقابل العميل،
+- الوحدات الافتراضية مثل تلك في React-Router.
+
+حزم Intlayer تحتوي على شيفرة يمكن أن تعمل على كل من Node والمتصفح. في مرحلة _وسيطة_، قد يظهر مكوّن مدمج في Node مثل `node:fs` في المخطط **قبل** أن يزيله Vite من بناء العميل. `vite-env-only` يلاحظ ذلك ويُطلق الخطأ فورًا، حتى وإن كانت الحزمة النهائية لا تحتوي عليه.
+
+## React-Router ووحدات الخادم
+
+في وثائق React-Router حول **اتفاقيات وحدات الخادم**
+(https://reactrouter.com/api/framework-conventions/server-modules)، يقترح الفريق **بشكل صريح استخدام `vite-env-only`** لمنع استيرادات الخادم فقط من التسرب إلى حزمة العميل.
+
+ومع ذلك، تعتمد تلك الاتفاقيات على aliasing الخاص بـ Vite، و conditional exports، و tree-shaking لإزالة كود الخادم فقط. بينما يتم تطبيق aliasing و conditional exports بالفعل، تظل بعض الأدوات المعتمدة على Node موجودة في حزم مثل `@intlayer/core` في تلك المرحلة (حتى وإن لم تُستورد على العميل). وبما أن عملية tree-shaking لم تُنفَّذ بعد، تُحلل تلك الدوال بواسطة Babel، ويكتشف `vite-env-only` استيرادات `node:` ويرفع نتيجة إيجابية كاذبة — على الرغم من أنها تُزال بشكل صحيح من حزمة العميل النهائية.
+
+## كيفية الإصلاح / حلول بديلة
+
+### موصى به: إزالة `vite-env-only`
+
+ببساطة احذف الإضافة. في العديد من الحالات لست بحاجة إليها — Vite يتعامل بالفعل مع استيرادات العميل مقابل الخادم عبر آلية الحل الخاصة به.
+
+هذا يصلح خطأ رفض `node:fs` الزائف دون أي تغييرات في Intlayer.
+
+### تحقق من البناء النهائي بدلاً من ذلك
+
+إذا رغبت مع ذلك بالتأكد من عدم وجود مكونات مدمجة من Node في جانب العميل، فافعل ذلك **بعد عملية البناء**، مثلاً:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+إذا لم تُرجع نتائج، فإن حزم العميل نظيفة.
+
+## ملخص
+
+- قد يُخطئ `vite-env-only` بشأن `node:fs` لأنه يتحقق مبكرًا جدًا.
+- عادةً ما تزيل Vite + Intlayer + إرشادات وحدات الخادم في React-Router المراجع الخاصة بالخادم بشكل صحيح.
+- إزالة الإضافة أو التحقق من _المخرجات النهائية_ هو عادةً الحل الأفضل.

package/frequent_questions/de/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # Ist es möglich, Intlayer mit Next.js ohne `[locale]` im Seitenpfad zu verwenden?

package/frequent_questions/de/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: "`vite-env-only` & Intlayer – falsch-positiver `node:fs`-Verweigerungsfehler"
+description: Warum vite-env-only einen verweigerten `node:fs`-Import mit Intlayer + React-Router + Vite meldet und was zu tun ist.
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - Import verweigert
+  - Alias
+  - Client-Bundle
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only verweigert `node:fs` mit Intlayer
+
+Wenn du das **vite-env-only**-Plugin verwendet hast (wie in älteren Empfehlungen von React-Router v7 erwähnt) und Folgendes siehst:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…auch wenn sich **kein `node:fs` in deinem Client-Bundle** befindet, handelt es sich um ein **false positive**.
+
+## Was verursacht es
+
+`vite-env-only` führt eine Babel-basierte Prüfung **früh während der Vite-Graphauflösung** durch, _bevor_:
+
+- aliasing (einschließlich Intlayer’s browser vs node mappings),
+- Dead-Code-Elimination,
+- SSR- vs. Client-Auflösung,
+- virtuelle Module wie die von React-Router.
+
+Intlayer-Pakete enthalten Code, der sowohl in Node als auch im Browser funktionieren kann. In einem _zwischenzeitlichen_ Stadium kann ein Node-Builtin wie `node:fs` im Graph erscheinen, **bevor** Vite es aus dem Client-Build entfernt. `vite-env-only` erkennt das und löst sofort einen Fehler aus, obwohl das finale Bundle es nicht enthält.
+
+## React-Router und Server-Module
+
+In der React-Router-Dokumentation zu den **Konventionen für Server-Module**
+(https://reactrouter.com/api/framework-conventions/server-modules), das Team **empfiehlt ausdrücklich die Verwendung von `vite-env-only`**, um zu verhindern, dass serverseitige Importe in das Client-Bundle gelangen.
+
+Diese Konventionen beruhen jedoch auf Vites Aliasing, conditional exports und tree-shaking, um serverseitigen Code zu entfernen. Während Aliasing und conditional exports bereits angewendet werden, sind einige Node-basierte Hilfsfunktionen zu diesem Zeitpunkt in Paketen wie `@intlayer/core` noch vorhanden (obwohl sie im Client niemals importiert werden). Da das tree-shaking noch nicht ausgeführt wurde, werden diese Funktionen weiterhin von Babel geparst, und `vite-env-only` erkennt deren `node:`-Importe und meldet einen False Positive — obwohl sie im finalen Client-Bundle korrekt entfernt werden.
+
+## Wie man das behebt / umgeht
+
+### Empfehlung: `vite-env-only` entfernen
+
+Entfernen Sie einfach das Plugin. In vielen Fällen ist es nicht nötig — Vite unterscheidet bereits über seine eigene Auflösung zwischen Client- und Server-Imports.
+
+Damit wird die fälschliche `node:fs`-Ablehnung behoben, ohne Änderungen an Intlayer.
+
+### Stattdessen den finalen Build prüfen
+
+Wenn Sie dennoch sicherstellen möchten, dass keine Node-Built-ins im Client landen, prüfen Sie dies **nach dem Build**, z. B.:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+Wenn es keine Ergebnisse gibt, sind Ihre Client-Bundles sauber.
+
+## Zusammenfassung
+
+- `vite-env-only` kann bei `node:fs` einen Fehler melden, weil es zu früh prüft.
+- Vite + Intlayer + die Server-Module-Konventionen von React-Router entfernen normalerweise Server-only-Referenzen korrekt.
+- Das Entfernen des Plugins oder die Überprüfung der _finalen Ausgabe_ ist in der Regel die beste Lösung.

package/frequent_questions/en/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # Is it possible to use Intlayer with Next.js without `[locale]` in the page path?

package/frequent_questions/en/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` & Intlayer – false positive `node:fs` denied error
+description: Why vite-env-only reports a denied `node:fs` import with Intlayer + React-Router + Vite and what to do.
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - import denied
+  - alias
+  - client bundle
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only denies `node:fs` with Intlayer
+
+If you used the **vite-env-only** plugin (as mentioned in older React-Router v7 suggestions) and see:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…even though there’s **no `node:fs` in your client bundle**, this is a **false positive**.
+
+## What causes it
+
+`vite-env-only` runs a Babel-based check **early in the Vite graph resolution**, _before_:
+
+- aliasing (including Intlayer’s browser vs node mappings),
+- dead-code elimination,
+- SSR vs client resolution,
+- virtual modules like React-Router’s.
+
+Intlayer packages contain code that can work on both Node and browser. At an _intermediate_ stage, a Node built-in like `node:fs` may appear in the graph **before** Vite removes it from the client build. `vite-env-only` sees that and errors immediately, even though the final bundle doesn’t contain it.
+
+## React-Router and Server Modules
+
+In the React-Router documentation about **server module conventions**  
+(https://reactrouter.com/api/framework-conventions/server-modules), the team **explicitly suggests using `vite-env-only`** to prevent server-only imports from leaking into the client bundle.
+
+However, those conventions rely on Vite’s aliasing, conditional exports, and tree-shaking to remove server-only code. While aliasing and conditional exports are already applied, some Node-based utilities are still present in packages like `@intlayer/core` at that stage (even though they are never imported on the client). Because tree-shaking has not run yet, those functions are still parsed by Babel, and `vite-env-only` detects their `node:` imports and raises a false positive — even though they are correctly purged from the final client bundle.
+
+## How to fix / work around
+
+### Recommended: Drop `vite-env-only`
+
+Simply remove the plugin. In many cases you don’t need it — Vite already handles client vs server imports via its own resolution.
+
+This fixes the false `node:fs` denial without changes to Intlayer.
+
+### Validate the final build instead
+
+If you still want to ensure no Node built-ins in the client, do it **after build**, e.g.:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+If no results, your client bundles are clean.
+
+## Summary
+
+- `vite-env-only` can error on `node:fs` because it checks too early.
+- Vite + Intlayer + React-Router’s server modules conventions normally remove server-only references correctly.
+- Removing the plugin or verifying the _final output_ is usually the best solution.

package/frequent_questions/en-GB/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # Is it possible to use Intlayer with Next.js without `[locale]` in the page path?

package/frequent_questions/en-GB/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` & Intlayer – false positive `node:fs` denied import error
+description: Why vite-env-only reports a denied `node:fs` import with Intlayer + React-Router + Vite, and what to do about it.
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - import denied
+  - alias
+  - client bundle
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only denies `node:fs` with Intlayer
+
+If you've used the **vite-env-only** plugin (as suggested in older React-Router v7 guidance) and see:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…even though there’s **no `node:fs` in your client bundle**, this is a **false positive**.
+
+## What causes this
+
+`vite-env-only` runs a Babel-based check early in the Vite graph resolution, _before_:
+
+- aliasing (including Intlayer’s browser vs node mappings),
+- dead-code elimination,
+- SSR vs client resolution,
+- virtual modules like React-Router’s.
+
+Intlayer packages contain code that can work on both Node and the browser. At an _intermediate_ stage, a Node built-in like `node:fs` may appear in the graph **before** Vite removes it from the client build. `vite-env-only` sees that and errors immediately, even though the final bundle doesn’t contain it.
+
+## React-Router and Server Modules
+
+In the React-Router documentation about **server module conventions**  
+(https://reactrouter.com/api/framework-conventions/server-modules), the team **explicitly recommends using `vite-env-only`** to prevent server-only imports from leaking into the client bundle.
+
+However, those conventions rely on Vite’s aliasing, conditional exports, and tree-shaking to remove server-only code. While aliasing and conditional exports are already applied, some Node-based utilities are still present in packages like `@intlayer/core` at that stage (even though they are never imported on the client). Because tree-shaking has not run yet, those functions are still parsed by Babel, and `vite-env-only` detects their `node:` imports and flags a false positive — even though they are correctly removed from the final client bundle.
+
+## How to fix / work around
+
+### Recommended: Remove `vite-env-only`
+
+Simply remove the plugin. In many cases you don’t need it — Vite already handles client vs server imports via its own resolution.
+
+This fixes the false `node:fs` denial without any changes to Intlayer.
+
+### Validate the final build instead
+
+If you still want to ensure there are no Node built-ins in the client, do it **after the build**, e.g.:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+If there are no results, your client bundles are clean.
+
+## Summary
+
+- `vite-env-only` can error on `node:fs` because it checks too early.
+- Vite + Intlayer + React-Router’s server modules conventions normally remove server-only references correctly.
+- Removing the plugin or verifying the _final output_ is usually the best solution.

package/frequent_questions/es/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # ¿Es posible usar Intlayer con Next.js sin `[locale]` en la ruta de la página?

package/frequent_questions/es/error-vite-env-only.md

@@ -0,0 +1,76 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` y Intlayer – error falso positivo `node:fs` import denegado
+description: Por qué vite-env-only informa una importación `node:fs` denegada con Intlayer + React-Router + Vite y qué hacer.
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - import denied
+  - alias
+  - client bundle
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# `vite-env-only` deniega `node:fs` con Intlayer
+
+Si usaste el plugin **vite-env-only** (como se menciona en sugerencias antiguas de React-Router v7) y ves:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…aunque **no haya `node:fs` en tu client bundle**, esto es un **falso positivo**.
+
+## Qué lo causa
+
+`vite-env-only` ejecuta una comprobación basada en Babel **temprano en la resolución del grafo de Vite**, _antes de_:
+
+- aliasing (incluyendo los mappings browser vs node de Intlayer),
+- dead-code elimination,
+- SSR vs client resolution,
+- módulos virtuales como los de React-Router.
+
+Los paquetes de Intlayer contienen código que puede funcionar tanto en Node como en el navegador. En una etapa _intermedia_, una API integrada de Node como `node:fs` puede aparecer en el grafo **antes** de que Vite la elimine del client build. `vite-env-only` detecta eso y lanza un error de inmediato, aunque el bundle final no lo incluya.
+
+## React-Router y convenciones de módulos del servidor
+
+(https://reactrouter.com/api/framework-conventions/server-modules), el equipo **sugiere explícitamente usar `vite-env-only`** para evitar que las importaciones exclusivas del servidor se filtren en el bundle del cliente.
+
+Sin embargo, esas convenciones dependen del aliasing de Vite, las exportaciones condicionales y el tree-shaking para eliminar el código exclusivo del servidor. Aunque el aliasing y las exportaciones condicionales ya se aplican, algunas utilidades basadas en Node aún están presentes en paquetes como `@intlayer/core` en esa etapa (aunque nunca se importan en el cliente). Como el tree-shaking no se ha ejecutado todavía, esas funciones todavía son parseadas por Babel, y `vite-env-only` detecta sus importaciones `node:` y produce un falso positivo — aunque se purgan correctamente del bundle final del cliente.
+
+## Cómo solucionarlo / soluciones alternativas
+
+### Recomendado: Eliminar `vite-env-only`
+
+Simplemente elimina el plugin. En muchos casos no lo necesitas — Vite ya gestiona las importaciones cliente vs servidor mediante su propia resolución.
+
+Esto soluciona la denegación falsa de `node:fs` sin cambios en Intlayer.
+
+### Valida la compilación final en su lugar
+
+Si aún quieres asegurarte de que no haya módulos integrados de Node en el cliente, hazlo **después del build**, p. ej.:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+Si no hay resultados, tus bundles del cliente están limpios.
+
+## Resumen
+
+- `vite-env-only` puede arrojar un error sobre `node:fs` porque comprueba demasiado pronto.
+- Vite + Intlayer + las convenciones de server modules de React-Router normalmente eliminan correctamente las referencias exclusivas del servidor.
+- Eliminar el plugin o verificar el _resultado final_ suele ser la mejor solución.

package/frequent_questions/fr/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # Est-il possible d'utiliser Intlayer avec Next.js sans `[locale]` dans le chemin de la page ?

package/frequent_questions/fr/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` & Intlayer – faux positif : import `node:fs` refusé
+description: Pourquoi vite-env-only signale un import `node:fs` refusé avec Intlayer + React-Router + Vite et que faire.
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - import refusé
+  - alias
+  - client bundle
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only refuse `node:fs` avec Intlayer
+
+Si vous avez utilisé le plugin **vite-env-only** (comme mentionné dans d'anciennes suggestions pour React-Router v7) et que vous voyez :
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…même s'il n'y a **aucun `node:fs` dans votre bundle client**, il s'agit d'un **faux positif**.
+
+## Quelle en est la cause
+
+`vite-env-only` effectue une vérification basée sur Babel **tôt dans la résolution du graphe Vite**, _avant_ :
+
+- les alias (y compris les mappages browser vs node d'Intlayer),
+- l'élimination du code mort,
+- la résolution SSR vs client,
+- les modules virtuels comme ceux de React-Router.
+
+Les packages Intlayer contiennent du code pouvant s'exécuter à la fois sur Node et dans le navigateur. À un stade _intermédiaire_, un module natif Node comme `node:fs` peut apparaître dans le graphe **avant** que Vite ne l'élimine du build client. `vite-env-only` le détecte et génère immédiatement une erreur, même si le bundle final ne le contient pas.
+
+## React-Router et les modules serveur
+
+Dans la documentation de React-Router au sujet des **conventions des modules serveur**
+(https://reactrouter.com/api/framework-conventions/server-modules), l'équipe **suggère explicitement d'utiliser `vite-env-only`** pour empêcher que des imports réservés au serveur ne fuient dans le bundle client.
+
+Cependant, ces conventions s'appuient sur l'aliasing de Vite, les exports conditionnels et le tree-shaking pour éliminer le code réservé au serveur. Alors que l'aliasing et les exports conditionnels sont déjà appliqués, certains utilitaires basés sur Node sont encore présents dans des packages comme `@intlayer/core` à ce stade (même s'ils ne sont jamais importés côté client). Comme le tree-shaking n'a pas encore été exécuté, ces fonctions sont toujours analysées par Babel, et `vite-env-only` détecte leurs imports `node:` et génère un faux positif — alors qu'ils sont correctement purgés du bundle client final.
+
+## Comment corriger / contourner
+
+### Recommandation : Supprimer `vite-env-only`
+
+Supprimez simplement le plugin. Dans de nombreux cas, vous n'en avez pas besoin — Vite gère déjà les imports client vs serveur via sa propre résolution.
+
+Cela corrige la fausse erreur sur `node:fs` sans modification d'Intlayer.
+
+### Valider la build finale à la place
+
+Si vous souhaitez toujours vous assurer qu'aucune API Node intégrée ne se retrouve dans le client, faites-le **après la compilation**, par ex. :
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+S'il n'y a aucun résultat, vos bundles client sont propres.
+
+## Résumé
+
+- `vite-env-only` peut générer une erreur sur `node:fs` car il vérifie trop tôt.
+- Vite + Intlayer + les conventions des server modules de React-Router suppriment normalement correctement les références réservées au serveur.
+- Supprimer le plugin ou vérifier la _sortie finale_ est généralement la meilleure solution.

package/frequent_questions/hi/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # क्या Next.js के साथ पेज पाथ में `[locale]` के बिना Intlayer का उपयोग करना संभव है?

package/frequent_questions/hi/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` और Intlayer – false positive `node:fs` अस्वीकृत त्रुटि
+description: vite-env-only यह क्यों रिपोर्ट करता है कि Intlayer + React-Router + Vite के साथ `node:fs` आयात अस्वीकृत है और इस स्थिति में क्या करना चाहिए।
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - आयात अस्वीकृत
+  - एलियास
+  - क्लाइंट बंडल
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only Intlayer के साथ `node:fs` को अस्वीकार कर देता है
+
+यदि आपने **vite-env-only** प्लगइन का उपयोग किया है (जैसा कि पुराने React-Router v7 सुझावों में उल्लेख है) और आप देखते हैं:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…हालाँकि आपके क्लाइंट बंडल में **कोई `node:fs` नहीं है**, यह एक **false positive** है।
+
+## कारण
+
+`vite-env-only` Vite ग्राफ़ रिज़ॉल्यूशन के आरंभिक चरण में एक Babel-आधारित जाँच चलाता है, _इसके पहले_:
+
+- अलायसिंग (Intlayer के browser बनाम node मैपिंग्स सहित),
+- dead-code elimination,
+- SSR बनाम क्लाइंट रिज़ॉल्यूशन,
+- React-Router जैसे वर्चुअल मॉड्यूल।
+
+Intlayer पैकेजों में ऐसा कोड होता है जो Node और ब्राउज़र दोनों पर काम कर सकता है। एक _मध्यवर्ती_ चरण में, `node:fs` जैसा Node बिल्ट-इन ग्राफ़ में दिखाई दे सकता है **पहले** कि Vite इसे क्लाइंट बिल्ड से हटा दे। `vite-env-only` यह देखकर तुरंत त्रुटि देता है, हालांकि अंतिम बंडल में यह मौजूद नहीं होता।
+
+## React-Router और सर्वर मॉड्यूल
+
+React-Router के दस्तावेज़ में **server module conventions**  
+(https://reactrouter.com/api/framework-conventions/server-modules), टीम **स्पष्ट रूप से `vite-env-only` का उपयोग करने का सुझाव देती है** ताकि server-only imports क्लाइंट बंडल में लीक न हों।
+
+हालाँकि, ये कन्वेंशन्स Vite की aliasing, conditional exports, और tree-shaking पर निर्भर करते हैं ताकि server-only कोड हटाया जा सके। जबकि aliasing और conditional exports पहले से लागू हैं, कुछ Node-आधारित utilities उस चरण में अभी भी पैकेजेज़ जैसे `@intlayer/core` में मौजूद रहते हैं (हालाँकि वे क्लाइंट पर कभी import नहीं होते)। क्योंकि tree-shaking अभी तक नहीं चला है, वे फ़ंक्शंस अभी भी Babel द्वारा पार्स किए जाते हैं, और `vite-env-only` उनके `node:` imports का पता लगा कर एक false positive उठाता है — भले ही वे अंतिम क्लाइंट बंडल से सही तरीके से हटाए जा चुके हों।
+
+## कैसे ठीक करें / वर्कअराउंड
+
+### अनुशंसित: `vite-env-only` हटाएँ
+
+सिर्फ़ प्लगइन को हटा दें। कई मामलों में इसकी आवश्यकता नहीं होती — Vite अपने resolution के माध्यम से क्लाइंट बनाम सर्वर इम्पोर्ट्स को पहले से ही संभालता है।
+
+यह Intlayer में किसी बदलाव के बिना `node:fs` पर दिखने वाली false positive को ठीक कर देता है।
+
+### इसके बजाय अंतिम बिल्ड को सत्यापित करें
+
+अगर आप फिर भी यह सुनिश्चित करना चाहते हैं कि क्लाइंट में कोई Node built-ins न हो, तो इसे **बिल्ड के बाद** करें, उदाहरण के लिए:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+यदि कोई परिणाम नहीं मिलता है, तो आपके क्लाइंट बंडल्स साफ़ हैं।
+
+## सारांश
+
+- `vite-env-only` `node:fs` पर त्रुटि दे सकता है क्योंकि यह बहुत जल्दी जाँच करता है।
+- Vite + Intlayer + React-Router के server modules conventions सामान्यतः server-only संदर्भों को सही ढंग से हटा देते हैं।
+- प्लगइन को हटाना या _final output_ की जाँच करना आम तौर पर सबसे अच्छा समाधान होता है।

package/frequent_questions/id/SSR_Next_no_[locale].md

@@ -16,7 +16,7 @@ keywords:
   - noPrefix
 slugs:
   - frequent-questions
-  - ssr-next-no-[locale]
+  - next-no-locale-path
 ---
 
 # Apakah mungkin menggunakan Intlayer dengan Next.js tanpa `[locale]` di jalur halaman?