@intlayer/docs 7.5.12 → 7.5.14

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

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` e Intlayer – falso positivo errore `node:fs` negato
+description: Perché vite-env-only segnala un import `node:fs` negato con Intlayer + React-Router + Vite e cosa fare.
+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 nega `node:fs` con Intlayer
+
+Se hai usato il plugin **vite-env-only** (come suggerito nelle vecchie indicazioni di React-Router v7) e vedi:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…anche se non c’è **`node:fs` nel tuo bundle client**, questo è un **falso positivo**.
+
+## Cosa lo causa
+
+`vite-env-only` esegue un controllo basato su Babel **all'inizio della risoluzione del grafo di Vite**, _prima_ di:
+
+- aliasing (inclusi i mapping browser vs node di Intlayer),
+- dead-code elimination,
+- risoluzione SSR vs client,
+- moduli virtuali come quelli di React-Router.
+
+I pacchetti Intlayer contengono codice che può funzionare sia su Node sia sul browser. In una fase _intermedia_, un modulo built-in di Node come `node:fs` può apparire nel grafo **prima** che Vite lo rimuova dal build client. `vite-env-only` lo rileva e genera un errore immediato, anche se il bundle finale non lo contiene.
+
+## React-Router e le convenzioni sui moduli lato server
+
+Nella documentazione di React-Router sulle **convenzioni per i moduli lato server**  
+(https://reactrouter.com/api/framework-conventions/server-modules), il team **suggerisce esplicitamente di usare `vite-env-only`** per evitare che import specifici del server trapelino nel bundle client.
+
+Tuttavia, quelle convenzioni si basano su aliasing di Vite, conditional exports e tree-shaking per rimuovere il codice server-only. Sebbene aliasing e conditional exports siano già applicati, alcune utilità basate su Node sono ancora presenti in pacchetti come `@intlayer/core` in quella fase (anche se non vengono mai importate nel client). Poiché il tree-shaking non è ancora stato eseguito, quelle funzioni vengono comunque analizzate da Babel, e `vite-env-only` rileva i loro import `node:` e segnala un falso positivo — anche se vengono correttamente eliminati dal bundle client finale.
+
+## Come risolvere / aggirare
+
+### Consigliato: Rimuovere `vite-env-only`
+
+Rimuovi semplicemente il plugin. In molti casi non ti serve — Vite gestisce già le importazioni client vs server tramite la propria risoluzione.
+
+Questo risolve il falso errore su `node:fs` senza modifiche a Intlayer.
+
+### Verificare il build finale invece
+
+Se vuoi comunque assicurarti che non ci siano built-in di Node nel client, falla **dopo la build**, per esempio:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+Se non ci sono risultati, i tuoi bundle client sono puliti.
+
+## Riepilogo
+
+- `vite-env-only` può generare un errore su `node:fs` perché esegue il controllo troppo presto.
+- Le convenzioni sui server modules di Vite + Intlayer + React-Router normalmente rimuovono correttamente i riferimenti server-only.
+- Rimuovere il plugin o verificare l'_output finale_ è generalmente la soluzione migliore.

package/frequent_questions/ja/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: Intlayer + React-Router + Vite 環境で vite-env-only が `node:fs` のインポートを拒否すると報告する理由と、その対処法。
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - インポート拒否
+  - エイリアス
+  - クライアントバンドル
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# Intlayer 環境で `vite-env-only` が `node:fs` を拒否する
+
+古い React-Router v7 の提案で言及されているような **vite-env-only** プラグインを使用していて、以下のようなエラーが表示される場合:
+
+```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 のマッピングを含む）、
+- デッドコード削除、
+- 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` の使用を推奨しています\*\*。
+
+しかし、これらの規約はサーバー専用コードを除去するために Vite のエイリアス、条件付きエクスポート、そしてツリーシェイキングに依存しています。エイリアスと条件付きエクスポートは既に適用されているものの、`@intlayer/core` のようなパッケージにはその段階でまだ一部の Node ベースのユーティリティが存在します（クライアントでは実際にはインポートされません）。ツリーシェイキングがまだ実行されていないため、それらの関数は Babel によって解析され続け、`vite-env-only` がそれらの `node:` インポートを検出して誤検出（false positive）を引き起こします — 最終的なクライアントバンドルからは正しく削除されているにもかかわらず。
+
+## 修正方法 / 回避策
+
+### 推奨: `vite-env-only` を削除する
+
+単純にそのプラグインを削除してください。多くの場合不要です — Vite は独自の解決でクライアントとサーバーのインポートを既に処理します。
+
+これにより Intlayer を変更することなく `node:fs` による誤検出が解消します。
+
+### 代わりに最終ビルドを検証する
+
+それでもクライアントに Node の組み込みがないことを確認したい場合は、**ビルド後に**行ってください。例:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+結果が何も返らなければ、クライアントバンドルはクリーンです。
+
+## まとめ
+
+- `vite-env-only` はチェックが早すぎるため `node:fs` でエラーになることがある。
+- Vite + Intlayer + React-Router の server modules の慣習は通常、サーバー専用の参照を正しく除去する。
+- プラグインを削除するか、_最終出力_ を検証することが通常は最良の解決策です。

package/frequent_questions/ko/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: Intlayer + React-Router + Vite 환경에서 vite-env-only가 `node:fs` import를 거부한다고 보고하는 이유와 해결 방법.
+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
+---
+
+# Intlayer에서 vite-env-only가 `node:fs`를 거부함
+
+이전 React-Router v7 권장사항에서 언급된 것처럼 **vite-env-only** 플러그인을 사용하고 있고 다음과 같은 메시지가 표시된다면:
+
+```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`는 Babel 기반 검사를 **Vite 그래프 해석 초기에** 실행하며, _다음보다 먼저_:
+
+- aliasing (Intlayer의 browser vs node 매핑을 포함),
+- dead-code 제거,
+- SSR vs 클라이언트 해석,
+- 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), 팀은 클라이언트 번들로 서버 전용 import가 유출되는 것을 방지하기 위해 **명시적으로 `vite-env-only` 사용을 권장합니다**.
+
+하지만 이러한 규칙들은 서버 전용 코드를 제거하기 위해 Vite의 aliasing, conditional exports, 그리고 tree-shaking에 의존합니다. aliasing과 conditional exports는 이미 적용되더라도, 해당 단계에서는 `@intlayer/core` 같은 패키지에 Node 기반 유틸리티가 여전히 존재할 수 있습니다(클라이언트에서 실제로는 가져오지 않더라도). 아직 tree-shaking이 실행되지 않았기 때문에 이러한 함수들은 여전히 Babel에 의해 파싱되고, `vite-env-only`가 그들의 `node:` import를 감지하여 오탐을 발생시킵니다 — 최종 클라이언트 번들에서는 올바르게 제거되었음에도 불구하고.
+
+## 수정 / 우회 방법
+
+### 권장: `vite-env-only` 제거
+
+플러그인을 단순히 제거하세요. 대부분의 경우 필요하지 않습니다 — Vite는 자체 모듈 해석으로 클라이언트와 서버 임포트를 이미 처리합니다.
+
+이렇게 하면 Intlayer를 변경하지 않고도 잘못된 `node:fs` 차단이 해결됩니다.
+
+### 대신 최종 빌드를 검증하세요
+
+클라이언트에 Node 내장 모듈이 포함되지 않았는지 여전히 확인하려면, **빌드 후**에 검사하세요. 예:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+결과가 없으면 클라이언트 번들은 깨끗합니다.
+
+## 요약
+
+- `vite-env-only`는 너무 일찍 검사하기 때문에 `node:fs`에서 에러를 발생시킬 수 있습니다.
+- Vite + Intlayer + React-Router의 서버 모듈 규약은 일반적으로 서버 전용 참조를 올바르게 제거합니다.
+- 플러그인을 제거하거나 *최종 출력*을 검증하는 것이 일반적으로 최선의 해결책입니다.

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

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` i Intlayer – fałszywy pozytyw: odmowa importu `node:fs`
+description: Dlaczego vite-env-only zgłasza odmowę importu `node:fs` przy Intlayer + React-Router + Vite i co z tym zrobić.
+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 odrzuca `node:fs` w Intlayer
+
+Jeśli używasz wtyczki **vite-env-only** (jak wspomniano w starszych sugestiach React-Router v7) i widzisz:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…mimo że **w twoim pakiecie klienckim nie ma `node:fs`**, jest to **fałszywy alarm**.
+
+## Co to powoduje
+
+`vite-env-only` wykonuje sprawdzenie oparte na Babel **wcześnie w fazie rozwiązywania grafu Vite**, _zanim_:
+
+- aliasowanie (w tym mapowania Intlayer dla przeglądarki vs node),
+- eliminacja martwego kodu,
+- rozwiązywanie SSR vs klienta,
+- moduły wirtualne, takie jak te z React-Routera.
+
+Pakiety Intlayer zawierają kod, który może działać zarówno na Node, jak i w przeglądarce. Na etapie _pośrednim_ w grafie może pojawić się wbudowany moduł Node, taki jak `node:fs`, **zanim** Vite usunie go z kompilacji dla klienta. `vite-env-only` to wykrywa i natychmiast zgłasza błąd, mimo że finalny bundle go nie zawiera.
+
+## React-Router i moduły serwerowe
+
+W dokumentacji React-Router dotyczącej **konwencji modułów serwerowych**  
+(https://reactrouter.com/api/framework-conventions/server-modules), zespół **wyraźnie sugeruje użycie `vite-env-only`**, aby zapobiec przedostawaniu się importów tylko dla serwera do bundle'a klienta.
+
+Jednakże te konwencje opierają się na aliasingu Vite, conditional exports oraz tree-shaking, aby usunąć kod tylko dla serwera. Chociaż aliasing i conditional exports są już stosowane, niektóre narzędzia oparte na Node nadal występują w pakietach takich jak `@intlayer/core` na tym etapie (nawet jeśli nigdy nie są importowane po stronie klienta). Ponieważ tree-shaking jeszcze się nie uruchomił, te funkcje są nadal parsowane przez Babel, a `vite-env-only` wykrywa ich importy `node:` i zgłasza false positive — mimo że są poprawnie usuwane z ostatecznego bundle'a klienta.
+
+## Jak naprawić / obejść
+
+### Zalecane: Usuń `vite-env-only`
+
+Po prostu usuń wtyczkę. W wielu przypadkach nie jest ona potrzebna — Vite sam obsługuje rozróżnienie importów dla klienta i serwera poprzez własne rozwiązywanie.
+
+To naprawia fałszywy błąd dotyczący `node:fs` bez konieczności wprowadzania zmian w Intlayer.
+
+### Zamiast tego zweryfikuj końcowy build
+
+Jeśli nadal chcesz upewnić się, że żadne wbudowane moduły Node nie trafiają do klienta, sprawdź to **po buildzie**, np.:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+Jeśli brak wyników, twoje client bundles są czyste.
+
+## Podsumowanie
+
+- `vite-env-only` może zgłaszać błąd dotyczący `node:fs`, ponieważ sprawdza zbyt wcześnie.
+- Vite + Intlayer + konwencje modułów serwerowych React-Routera zwykle poprawnie usuwają odwołania przeznaczone wyłącznie dla serwera.
+- Usunięcie wtyczki lub weryfikacja _końcowego wyniku_ zwykle jest najlepszym rozwiązaniem.

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

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: `vite-env-only` e Intlayer – falso positivo: erro `node:fs` negado
+description: Por que o vite-env-only reporta uma importação `node:fs` negada com Intlayer + React-Router + Vite e o que fazer.
+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 nega `node:fs` com Intlayer
+
+Se você usou o plugin **vite-env-only** (conforme mencionado em sugestões antigas do React-Router v7) e vir:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…mesmo que não haja **`node:fs` no bundle do cliente**, isto é um **falso positivo**.
+
+## O que causa
+
+`vite-env-only` executa uma verificação baseada em Babel **cedo na resolução do grafo do Vite**, _antes de_:
+
+- aliasing (incluindo os mapeamentos browser vs node do Intlayer),
+- eliminação de código morto,
+- resolução SSR vs client,
+- módulos virtuais como os do React-Router.
+
+Os pacotes do Intlayer contêm código que pode funcionar tanto no Node como no browser. Numa fase _intermédia_, um builtin do Node como `node:fs` pode aparecer no grafo **antes** do Vite o remover do build do cliente. O `vite-env-only` vê isso e gera um erro imediatamente, mesmo que o bundle final não o contenha.
+
+## React-Router e Módulos de Servidor
+
+Na documentação do React-Router sobre as **convenções de módulos de servidor**
+(https://reactrouter.com/api/framework-conventions/server-modules), a equipe **sugere explicitamente usar `vite-env-only`** para evitar que importações exclusivas do servidor vazem para o bundle do cliente.
+
+Porém, essas convenções dependem do aliasing do Vite, das conditional exports e do tree-shaking para remover o código exclusivo do servidor. Embora o aliasing e as conditional exports já estejam aplicados, alguns utilitários baseados em Node ainda estão presentes em pacotes como `@intlayer/core` nessa fase (mesmo que nunca sejam importados pelo cliente). Como o tree-shaking ainda não foi executado, essas funções ainda são analisadas pelo Babel, e o `vite-env-only` detecta suas importações `node:` e gera um falso positivo — mesmo que elas sejam corretamente purgadas do bundle final do cliente.
+
+## Como corrigir / contornar
+
+### Recomendado: Remover `vite-env-only`
+
+Simplesmente remova o plugin. Em muitos casos você não precisa dele — o Vite já lida com importações cliente vs servidor através da sua própria resolução.
+
+Isto corrige o erro falso de `node:fs` sem alterações no Intlayer.
+
+### Validar o build final em vez disso
+
+Se ainda quiser garantir que não há built-ins do Node no cliente, faça isso **após o build**, por exemplo:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+Se não houver resultados, os bundles do cliente estão limpos.
+
+## Resumo
+
+- `vite-env-only` pode gerar erro sobre `node:fs` porque verifica cedo demais.
+- O Vite + Intlayer + as convenções de server modules do React-Router normalmente removem corretamente as referências server-only.
+- Remover o plugin ou verificar o _final output_ normalmente é a melhor solução.

package/frequent_questions/ru/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
+  - отклонённый импорт
+  - алиас
+  - клиентский бандл
+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**, _до_:
+
+- алиасинга (включая маппинги Intlayer для browser vs node),
+- удаления неиспользуемого кода (dead-code elimination),
+- разрешения различий между SSR и клиентской сборкой,
+- виртуальных модулей, например у React-Router’а.
+
+Пакеты Intlayer содержат код, который может работать как в Node, так и в браузере. На _промежуточном_ этапе встроенный модуль Node, такой как `node:fs`, может появиться в графе **до того**, как Vite удалит его из клиентской сборки. `vite-env-only` видит это и сразу же генерирует ошибку, даже если в итоговом бандле этого нет.
+
+## React-Router и серверные модули
+
+В документации React-Router о **sоrver module conventions**  
+(https://reactrouter.com/api/framework-conventions/server-modules), команда **явно предлагает использовать `vite-env-only`**, чтобы предотвратить утечку импортов, предназначенных только для сервера, в клиентский бандл.
+
+Однако эти соглашения опираются на алиасы Vite, условные экспорты и tree-shaking для удаления серверного кода. Хотя алиасы и условные экспорты уже применяются, некоторые утилиты на базе 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/tr/error-vite-env-only.md

@@ -0,0 +1,77 @@
+---
+createdAt: 2026-01-11
+updatedAt: 2026-01-11
+title: "`vite-env-only` & Intlayer – yanlış pozitif `node:fs` reddedildi hatası"
+description: "vite-env-only'nin Intlayer + React-Router + Vite ile `node:fs` importunu neden reddettiğini ve yapılması gerekenleri."
+keywords:
+  - intlayer
+  - vite
+  - react-router
+  - vite-env-only
+  - node:fs
+  - import reddedildi
+  - alias
+  - client bundle
+slugs:
+  - frequent-questions
+  - vite-env-only-node-fs-false-positive
+---
+
+# vite-env-only Intlayer ile `node:fs`'i reddediyor
+
+Eğer **vite-env-only** eklentisini kullandıysanız (eski React-Router v7 önerilerinde belirtildiği gibi) ve şu hatayı görüyorsanız:
+
+```bash
+
+Error: [vite-env-only] Import denied
+
+* Denied by specifier pattern: /^node:/
+* Importer: index.html
+* Import: "node:fs"
+
+```
+
+…istemci paketinizde **`node:fs` olmasa bile**, bu bir **yanlış pozitif**.
+
+## Buna ne sebep oluyor
+
+`vite-env-only`, Vite grafik çözümlemesinin **erken aşamasında** Babel tabanlı bir kontrol çalıştırır, _şundan önce_:
+
+- aliasing (Intlayer’ın tarayıcı vs node eşlemeleri dahil),
+- kullanılmayan kodun kaldırılması (dead-code elimination),
+- SSR ile istemci çözümlemesi,
+- React-Router gibi sanal modüller.
+
+Intlayer paketleri hem Node hem tarayıcı üzerinde çalışabilecek kod içerir. Bir _ara_ aşamada, `node:fs` gibi bir Node yerleşiği grafikte Vite bunun istemci derlemesinden kaldırmasından **önce** görünebilir. `vite-env-only` bunu görür ve nihai paket bunu içermese bile hemen hata verir.
+
+## React-Router ve Sunucu Modülleri
+
+React-Router dokümantasyonunda **sunucu modülü konvansiyonları** ile ilgili olarak
+(https://reactrouter.com/api/framework-conventions/server-modules), ekip, sunucuya özel importların istemci paketine sızmasını önlemek için **açıkça `vite-env-only` kullanmayı önerir**.
+
+Ancak bu konvansiyonlar, sunucuya özel kodu kaldırmak için Vite’in aliasing’ine, conditional exports'ına ve tree-shaking’ine dayanır. Alias’lama ve conditional exports zaten uygulanmış olsa da, bazı Node tabanlı yardımcılar bu aşamada `@intlayer/core` gibi paketlerde hâlâ mevcut olabilir (istemcide hiç import edilmemiş olsalar bile). Çünkü tree-shaking henüz çalışmadığından, bu fonksiyonlar hâlâ Babel tarafından parse edilir ve `vite-env-only` onların `node:` importlarını tespit edip yanlış pozitif bir hata verir — oysa bunlar nihai istemci paketinden doğru şekilde temizlenir.
+
+## Nasıl düzeltilecek / geçici çözümler
+
+### Önerilen: `vite-env-only`'ı kaldırın
+
+Eklentiyi basitçe kaldırın. Birçok durumda buna gerek yok — Vite kendi çözümlemesiyle istemci ve sunucu importlarını zaten yönetir.
+
+Bu, Intlayer'da değişiklik yapmadan yanlış `node:fs` reddini düzeltir.
+
+### Bunun yerine son yapıyı doğrulayın
+
+İstemci paketlerinde Node yerleşiklerinin bulunmadığından hâlâ emin olmak istiyorsanız, bunu **build sonrası** yapın, örn:
+
+```bash
+pnpm build
+grep -R "node:" dist/
+```
+
+Eğer sonuç yoksa, istemci bundle'larınız temizdir.
+
+## Özet
+
+- `vite-env-only` çok erken kontrol ettiği için `node:fs` üzerinde hata verebilir.
+- Vite + Intlayer + React-Router'ın server modules konvansiyonları genellikle yalnızca sunucuya ait referansları doğru şekilde kaldırır.
+- Eklentiyi kaldırmak veya _nihai çıktıyı_ doğrulamak genellikle en iyi çözümdür.

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

@@ -0,0 +1,104 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: Чи можна використовувати Intlayer з Next.js без `[locale]` у шляху сторінки?
+description: Дізнайтеся, як використовувати Intlayer з Next.js без `[locale]` у шляху сторінки.
+keywords:
+  - locale
+  - path
+  - intlayer
+  - next.js
+  - vite
+  - framework
+  - middleware
+  - configuration
+  - prefixDefault
+  - noPrefix
+slugs:
+  - frequent-questions
+  - next-no-locale-path
+---
+
+# Чи можна використовувати Intlayer з Next.js без `[locale]` у шляху сторінки?
+
+Так — можна використовувати Intlayer з Next.js без `[locale]` у шляху сторінки. Однак цього не рекомендується робити, оскільки розділення сторінок по локалях дозволяє підвищити видимість за більшою кількістю ключових слів у пошукових системах. Крім того, це може вплинути на ваш SSR.
+
+Якщо ви хочете це зробити, дотримуйтеся тих самих кроків, що описані в керівництві [Intlayer with Next.js](https://intlayer.org/doc/environment/nextjs),
+
+- без `src/middleware.ts`
+- без `generateStaticParams`
+
+```tsx fileName="src/app/layout.tsx"
+import type { FC, PropsWithChildren } from "react";
+
+const LocaleLayout: FC<PropsWithChildren> = ({ children }) => (
+  <html lang={undefined} dir={undefined}>
+    <body className={inter.className}>{children}</body>
+  </html>
+);
+
+export default LocaleLayout;
+```
+
+```tsx fileName="src/app/page.tsx"
+import type { FC } from "react";
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { PageContent } from "@components/pageContent";
+import { type NextPageIntlayer, IntlayerClientProvider } from "next-intlayer";
+import { IntlayerServerProvider } from "next-intlayer/server";
+
+const Page: FC = () => {
+  return (
+    <IntlayerServerProvider>
+      <PageContent />
+      <ServerComponentExample />
+
+      <IntlayerClientProvider>
+        <ClientComponentExample />
+      </IntlayerClientProvider>
+    </IntlayerServerProvider>
+  );
+};
+
+export default Page;
+```
+
+```tsx fileName="src/component/pageContent.ts"
+"use client";
+
+import { type FC } from "react";
+import { useIntlayer } from "next-intlayer";
+import { useHTMLLanguage } from "@hooks/htmlTextDir";
+
+const PageContent: FC = () => {
+  useHTMLLanguage();
+  const content = useIntlayer("page");
+
+  return (
+    <>
+      <p>{content.getStarted.main}</p>
+      <code>{content.getStarted.pageLink}</code>
+    </>
+  );
+};
+```
+
+```tsx fileName="src/hooks/htmlTextDir.ts"
+"use client";
+
+import { useEffect } from "react";
+import { getHTMLTextDir } from "intlayer";
+import { useLocale } from "next-intlayer";
+
+export const useHTMLLanguage = () => {
+  const { locale } = useLocale();
+
+  useEffect(() => {
+    if (!document) return;
+
+    document.documentElement.lang = locale;
+    document.documentElement.dir = getHTMLTextDir(locale);
+  }, [locale]);
+};
+```