@intlayer/docs 9.3.3 → 9.4.0-canary.0

package/docs/it/mcp_server.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-06-07
-updatedAt: 2026-03-03
+updatedAt: 2026-08-21
 title: Documentazione del Server MCP
 description: Esplora le funzionalità e la configurazione del Server MCP per ottimizzare la gestione e le operazioni del tuo server.
 keywords:
@@ -15,6 +15,9 @@ slugs:
   - doc
   - mcp-server
 history:
+  - version: 9.3.3
+    date: 2026-08-21
+    changes: "Group the platform setup sections into tabs"
   - version: 5.5.12
     date: 2025-07-11
     changes: "Aggiunta configurazione di ChatGPT"
@@ -113,13 +116,18 @@ Questo comando permetterà di:
 
 ---
 
-## Configurazione in Cursor
+## Configurazione manuale
+
+<Tabs defaultTab="cursor">
+  <Tab label="Cursor" value="cursor">
+
+### Configurazione in Cursor
 
 Segui la [documentazione ufficiale](https://docs.cursor.com/context/mcp) per configurare il server MCP in Cursor.
 
 Nella radice del tuo progetto, aggiungi il seguente file di configurazione `.cursor/mcp.json`:
 
-### Server locale (stdio) (consigliato)
+#### Server locale (stdio) (consigliato)
 
 ```json fileName=".cursor/mcp.json"
 {
@@ -132,7 +140,7 @@ Nella radice del tuo progetto, aggiungi il seguente file di configurazione `.cur
 }
 ```
 
-### Server remoto (Streamable HTTP)
+#### Server remoto (Streamable HTTP)
 
 Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (Streamable HTTP), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
 
@@ -149,15 +157,16 @@ Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (
 
 Questo indica al tuo IDE di avviare il server MCP Intlayer usando `npx`, assicurandosi che utilizzi sempre l'ultima versione disponibile a meno che non venga bloccata.
 
----
+  </Tab>
+  <Tab label="VS Code" value="vscode">
 
-## Configurazione in VS Code
+### Configurazione in VS Code
 
 Segui la [documentazione ufficiale](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) per configurare il server MCP in VS Code.
 
 Per utilizzare il server MCP Intlayer con VS Code, devi configurarlo nelle impostazioni del tuo workspace o utente.
 
-### Server locale (stdio) (consigliato)
+#### Server locale (stdio) (consigliato)
 
 Crea un file `.vscode/mcp.json` nella radice del tuo progetto:
 
@@ -173,7 +182,7 @@ Crea un file `.vscode/mcp.json` nella radice del tuo progetto:
 }
 ```
 
-### Server remoto (Streamable HTTP)
+#### Server remoto (Streamable HTTP)
 
 Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (Streamable HTTP), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
 
@@ -188,11 +197,12 @@ Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (
 }
 ```
 
----
+  </Tab>
+  <Tab label="ChatGPT" value="chatgpt">
 
-## Configurazione in ChatGPT
+### Configurazione in ChatGPT
 
-### Server remoto (Streamable HTTP)
+#### Server remoto (Streamable HTTP)
 
 Segui la [documentazione ufficiale](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) per configurare il server MCP in ChatGPT.
 
@@ -209,9 +219,10 @@ Segui la [documentazione ufficiale](https://platform.openai.com/docs/mcp#test-an
 
 7. Clicca su `Save`
 
----
+  </Tab>
+  <Tab label="Claude Desktop" value="claude-desktop">
 
-## Configurazione in Claude Desktop
+### Configurazione in Claude Desktop
 
 Segui la [documentazione ufficiale](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) per configurare il server MCP in Claude Desktop.
 
@@ -220,7 +231,7 @@ Percorso del file di configurazione:
 - macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
-### Server locale (stdio) (consigliato)
+#### Server locale (stdio) (consigliato)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -233,7 +244,7 @@ Percorso del file di configurazione:
 }
 ```
 
-### Server remoto (Streamable HTTP)
+#### Server remoto (Streamable HTTP)
 
 ```json fileName="claude_desktop_config.json"
 {
@@ -246,13 +257,14 @@ Percorso del file di configurazione:
 }
 ```
 
----
+  </Tab>
+  <Tab label="Claude Code (CLI)" value="claude-code">
 
-## Configurazione in Claude Code (CLI)
+### Configurazione in Claude Code (CLI)
 
 Segui la [documentazione ufficiale](https://modelcontextprotocol.io/quickstart/user) per configurare il server MCP in Claude Code.
 
-### Server locale (stdio) (consigliato)
+#### Server locale (stdio) (consigliato)
 
 Per connettere il server Intlayer MCP a Claude Code utilizzando stdio:
 
@@ -260,7 +272,7 @@ Per connettere il server Intlayer MCP a Claude Code utilizzando stdio:
 claude mcp add intlayer npx -y @intlayer/mcp
 ```
 
-### Server remoto (Streamable HTTP)
+#### Server remoto (Streamable HTTP)
 
 Per connettere il server MCP di Intlayer a Claude Code utilizzando Streamable HTTP (SSE):
 
@@ -268,6 +280,9 @@ Per connettere il server MCP di Intlayer a Claude Code utilizzando Streamable HT
 claude mcp add intlayer https://mcp.intlayer.org -t http
 ```
 
+  </Tab>
+</Tabs>
+
 ---
 
 ## Utilizzo del Server MCP tramite CLI
@@ -281,5 +296,3 @@ npm install -g @intlayer/mcp
 # Oppure usa direttamente con npx (consigliato)
 npx @intlayer/mcp
 ```
-
----

package/docs/it/migration_from_i18next_to_intlayer.md

@@ -44,7 +44,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_next-i18next_to_intlayer.md

@@ -47,7 +47,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_next-intl_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_react-i18next_to_intlayer.md

@@ -46,7 +46,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/migration_from_vue-i18n_to_intlayer.md

@@ -45,7 +45,7 @@ Intlayer è anche la soluzione con lo **sviluppo più attivo** nell'ecosistema i
 
 <Accordion header="Agenti IA">
 
-La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Skill per Agenti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
+La co-localizzazione dei contenuti **riduce il contesto necessario** per i Modelli Linguistici di Grandi Dimensioni (LLM). Intlayer offre inoltre una suite di strumenti, come una **CLI** per testare le traduzioni mancanti, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/mcp_server.md)**, e **[Agent Skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/agent_skills.md)**, per rendere l'Esperienza Sviluppatore (DX) per gli agenti IA ancora più fluida.
 
 </Accordion>
 

package/docs/it/packages/intlayer/getLocalizedPath.md

@@ -128,6 +128,20 @@ getLocalizedPath("/contact", Locales.FRENCH, manualRules);
 
 ---
 
+### Omissione della Locale
+
+Quando non viene fornita alcuna locale, il percorso viene localizzato per la locale predefinita configurata:
+
+```typescript codeFormat="typescript"
+import { getLocalizedPath } from "intlayer";
+
+// Configuration: defaultLocale = Locales.ENGLISH, { '/about': { en: '/about', fr: '/a-propos' } }
+getLocalizedPath("/about");
+// Output: "/about"
+```
+
+---
+
 ## Funzioni correlate
 
 - [`getCanonicalPath`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/intlayer/getCanonicalPath.md): Risolve un percorso localizzato nel suo path canonico interno.

package/docs/it/packages/vite-intlayer/intlayerMinify.md

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` è `true` (o `undefined`, che per impostazione predefinita è `true` per le build).
 3. `build.minify` è `true` nella tua configurazione Intlayer.
 
-Viene automaticamente **disattivato** quando `editor.enabled` è `true` perché l'editor ha bisogno del contenuto del dizionario completo e leggibile dall'uomo.
+Quando `editor.enabled` è `true`, il plugin viene comunque eseguito ma **salta la rinomina dei campi**: la rinomina riscrive le chiavi di contenuto che l'interprete attraversa, quindi il `keyPath` ricevuto dall'editor visuale non corrisponderebbe più ai dizionari non uniti che modifica. La compattazione degli spazi bianchi e la rimozione dei metadati di primo livello restano attive.
 
 ## Cosa viene minificato
 

package/docs/it/packages/vite-intlayer/intlayerPrune.md

@@ -115,4 +115,4 @@ Quando la potatura ha successo, `intlayerPrune` scrive anche `pruneContext.dicti
 2. `build.optimize` è `true` (oppure `undefined`, che di default è `true` per i build).
 3. `build.purge` è `true` nella tua configurazione Intlayer.
 
-È automaticamente **disabilitato** quando `editor.enabled` è `true` perché l'editor necessita del contenuto completo del dizionario.
+Rimane attivo quando `editor.enabled` è `true`: l'editor visuale risolve ogni modifica tramite `dictionaryKey` + `keyPath` rispetto ai dizionari non uniti, che questo plugin non tocca mai, e un campo eliminato è un campo che nessun componente legge — quindi non viene mai renderizzato né selezionabile nella pagina.

package/docs/ja/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: エージェントスキル (Agent Skills)
+title: Agent Skills
 description: Intlayer Agent Skills を利用して、AI エージェントによるプロジェクトの理解を向上させる方法を学びます。メタデータ、サイトマップ、サーバーアクションの包括的なセットアップガイドも含まれています。
 keywords:
   - Intlayer
-  - エージェントスキル
+  - Agent Skills
   - AI エージェント
   - 国際化
   - ドキュメント
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# エージェントスキル (Agent Skills)
+# Agent Skills
 
 ## セットアップ
 
 ### CLI を使用する
 
-`intlayer init skills` コマンドは、プロジェクトにエージェントスキルをセットアップする最も簡単な方法です。環境を検出し、好みのプラットフォームに必要な設定ファイルをインストールします。
+`intlayer init skills` コマンドは、プロジェクトに Agent Skills をセットアップする最も簡単な方法です。環境を検出し、好みのプラットフォームに必要な設定ファイルをインストールします。
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. コマンドパレットを開きます (Ctrl+Shift+P または Cmd+Shift+P)。
 2. `Intlayer: Setup AI Agent Skills` と入力します。
 3. 使用しているプラットフォームを選択します (例: `VS Code`、`Cursor`、`Windsurf`、`OpenCode`、`Claude Code`、`GitHub Copilot Workspace` など)。
-4. インストールしたいスキルを選択します (例: `Next.js`、`React`、`Vite`、`Compiler`、`Configuration`)。
+4. インストールしたい Agent Skills を選択します (例: `Next.js`、`React`、`Vite`、`Compiler`、`Configuration`)。
 5. Enter キーを押します。
 
-## スキル一覧
+## Agent Skills 一覧
 
 **intlayer-config**
 

package/docs/ja/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | コンテンツ露出の追跡とA/Bテストの実行
 description: "@intlayer/analyticsがページ/ロケールビューとコンテンツ露出をどのように追跡するか、そしてそれを活用してIntlayerコンテンツでA/Bテストを実行する方法について説明します。"
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "`@intlayer/analytics` がインストールされている場合、アナリティクスをデフォルトで有効化"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — @intlayer/analytics パッケージ、プロバイダ/ノードレベルのトラッキング、A/Bテスト、ダッシュボード"
@@ -57,7 +60,7 @@ Intlayerでは、すでにコンテンツの[バリアント (Variants)](https:/
 
 ## インストール
 
-`@intlayer/analytics`は**ピア（peer）、オプション**の依存関係です。フレームワークパッケージによって自動的にインストールされることはありません。`intlayer`と一緒に追加してください：
+`@intlayer/analytics` は各フレームワークパッケージ（`react-intlayer`、`next-intlayer`、`vue-intlayer` など）の**オプショナル依存関係**であるため、ほとんどのプロジェクトにはすでに含まれています。オプショナル依存関係をスキップする構成（`npm install --no-optional` など）の場合は、明示的にインストールしてください:
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-インストールしない場合、すべての統合ポイントはNo-Op（何もしない処理）として解決されます — 以下の[未インストール時のゼロコスト](#未インストール時のゼロコスト)を参照してください。
+アナリティクスを有効にするにはパッケージをインストールするだけで十分です。`analytics.enabled` のデフォルトは `true` で、パッケージがプロジェクト内に見つからない場合は `@intlayer/config` が `false` に解決します。インストールしない場合、すべての統合ポイントはNo-Op（何もしない処理）として解決されます — 以下の[未インストール時のゼロコスト](#未インストール時のゼロコスト)を参照してください。
 
 ## 設定
 
-Analyticsは**既存の`editor`設定ブロックを再利用**します。入力する個別の`analytics`設定スキーマはありません：
+アナリティクスは設定なしで動作します。**デフォルトで有効**であり、送信先とプロジェクトキーには**既存の `editor` 設定ブロックをそのまま再利用**します。
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 Intlayerをセルフホスト（self-host）している場合、`editor.backendURL`を共有しているため、アナリティクスは自動的にご自身のインスタンスを指します。
 
+### オプトアウトする
+
+任意の `analytics` ブロックで収集を調整、または停止できます:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // デフォルト: true — 統合全体をバンドルから除外します
+    flushInterval: 20_000, // 2 回のバッチ送信の間隔（ミリ秒）
+    sampleRate: 1, // 記録するセッションの割合。0（なし）から 1（すべて）
+  },
+};
+
+export default config;
+```
+
+`@intlayer/analytics` をアンインストールすることは `enabled: false` と同じ効果があります。全フィールドの一覧は[設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)を参照してください。
+
 ## フレームワークのサポート
 
 Analyticsは`react-intlayer`からの共有`IntlayerProvider`に組み込まれているため、そのプロバイダが使用されている場所であればどこでも今日から利用できます：
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics`は、`@intlayer/editor`とまったく同じオプション依存関係パターンに従っています：
 
 - 各統合ポイントは、**`try/catch`でラップされた動的`import()`**を介してパッケージをロードします。`@intlayer/analytics`をインストールしないアプリでは、バンドルサイズやランタイムコストが発生することはなく、エラーが表示されることもありません。
-- コンパイル時の環境変数（`INTLAYER_ANALYTICS_ENABLED`）は、`editor.clientId`が設定されていない場合に`@intlayer/config`によって自動的に`'false'`に設定されます。これにより、バンドラーが統合全体を**デッドコードとして削除（dead-code-eliminate）**できるようになります。
+- コンパイル時の環境変数（`INTLAYER_ANALYTICS_ENABLED`）は、パッケージがインストールされていない場合、`analytics.enabled` が `false` の場合、または `editor.clientId` が設定されていない場合に、`@intlayer/config` によって自動的に `'false'` に設定されます。これにより、バンドラーが統合全体を**デッドコードとして削除（dead-code-eliminate）**できるようになります。
 - Intlayerエディタ/CMSプレビューのiframe内ではアナリティクスが無効になっているため、エディタセッションが実際のトラフィックとしてカウントされることはありません。
 
 ## ダッシュボード：アナリティクスページ

package/docs/ja/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> `optimize` が `false` の場合、または `editor.enabled` が `true` の場合（ビジュアルエディタでは編集を可能にするために元のフィールド名が必要なため）、最小化はスキップされます。
+> `optimize` が `false` の場合、最小化はスキップされます。`editor.enabled` が `true` の場合でも実行されますが、フィールドのリネーム処理は行われません — ビジュアルエディタは `keyPath` で編集内容を解決するため、元のフィールド名を維持する必要があります。
 
 > Next.js では、`@intlayer/swc` がインストールされていない、または読み込めない場合（16.1.0 未満の Next.js）にもミニファイはスキップされます。ソース側のアクセスを書き換えるのはこのプラグインなので、これなしで辞書をリネームすると、コードが存在しないフィールド名を読むことになります。
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> `optimize` が `false` の場合、または `editor.enabled` が `true` の場合、パージはスキップされます。 Next.js では、さらに `@intlayer/swc` が利用できない場合、および互換アダプターの呼び出し元が設定されている場合にもスキップされます。
+> `optimize` が `false` の場合、パージはスキップされます。`editor.enabled` が `true` の場合でも有効なままです — パージされたフィールドはどのコンポーネントからも読み取られないため、エディタがそれを描画することはありません。Next.js では、さらに `@intlayer/swc` が利用できない場合、および互換アダプターの呼び出し元が設定されている場合にもスキップされます。
 
 > ソースファイルが解析できない場合、または `useIntlayer` の結果が変数に割り当てられ、静的アナライザーが追跡できない方法（例：オブジェクトへのスプレッド、分割代入せずにプロップとして渡すなど）で渡された場合も、パージは保守的にスキップされます。このような場合は、完全な辞書が保持されます。
 

package/docs/ja/configuration.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-13
-updatedAt: 2026-08-06
+updatedAt: 2026-08-22
 title: 設定 (Configuration)
 description: アプリケーションにIntlayerを設定する方法について説明します。ニーズに合わせてIntlayerをカスタマイズするためのさまざまな設定とオプションを理解してください。
 keywords:
@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "`@intlayer/analytics` がインストールされている場合、アナリティクスをデフォルトで有効化"
   - version: 9.1.3
     date: 2026-08-06
     changes: "`routing.enableProxy` を三状態化: 未設定 (auto)、`true`、`false`"
@@ -380,8 +383,8 @@ const config: IntlayerConfig = {
   analytics: {
     /**
      * アナリティクス収集を有効にするかどうか（ページビュー、コンテンツの露出、A/Bイベント）。
-     * 帰属（attribution）のために `editor.clientId` の設定が必要です。
-     * デフォルト: false
+     * `@intlayer/analytics` がインストールされ、帰属（attribution）のために `editor.clientId` が設定されている必要があります。
+     * デフォルト: true
      */
     enabled: true,
 
@@ -734,13 +737,13 @@ export default config;
 
 Intlayerアナリティクスに関する設定を定義します。ユーザーに実際に表示されたコンテンツ（ページビュー、コンテンツの露出）を収集し、コンテンツのA/Bテストを可能にします。
 
-アナリティクスは厳密にオプトイン方式です。`analytics.enabled` が明示的に `true` に設定され、**かつ** 帰属のためのプロジェクトキー（`editor.clientId`）が設定されない限り、何も収集されません。無効の場合（デフォルト）、アナリティクスの統合全体がアプリケーションのバンドルから削除されます（デッドコード除去）。
+アナリティクスはオプトアウト方式です。デフォルトで有効であり、`@intlayer/analytics` パッケージがインストールされ、**かつ** 帰属のためのプロジェクトキー（`editor.clientId`）が設定されるとすぐに収集を開始します。`analytics.enabled` を `false` にする（またはパッケージをインストールしない）と、アナリティクスの統合全体がアプリケーションのバンドルから削除されます（デッドコード除去）。
 
-| フィールド      | 説明                                                                              | 型        | デフォルト | 例      | 備考                                                                                                                                       |
-| --------------- | --------------------------------------------------------------------------------- | --------- | ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
-| `enabled`       | アナリティクス収集を有効にします（ページビュー、コンテンツの露出、A/Bイベント）。 | `boolean` | `false`    | `true`  | 帰属のために `editor.clientId` の設定が必要です。設定されていない場合、`enabled` が `true` でもアナリティクスは無効のままです。            |
-| `flushInterval` | バックエンドへの自動バッチ送信間のミリ秒数。                                      | `number`  | `20000`    | `10000` |                                                                                                                                            |
-| `sampleRate`    | 記録するセッションの割合。`0`（なし）から`1`（すべて）まで。                      | `number`  | `1`        | `0.5`   | サンプリングはセッションごとに決定的であるため、記録されたセッションはそのすべてのイベントを報告します（部分的なファネルにはなりません）。 |
+| フィールド      | 説明                                                                              | 型        | デフォルト | 例      | 備考                                                                                                                                                                              |
+| --------------- | --------------------------------------------------------------------------------- | --------- | ---------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enabled`       | アナリティクス収集を有効にします（ページビュー、コンテンツの露出、A/Bイベント）。 | `boolean` | `true`     | `false` | `@intlayer/analytics` がインストールされ、帰属のために `editor.clientId` が設定されている必要があります。そうでない場合、`enabled` が `true` でもアナリティクスは無効のままです。 |
+| `flushInterval` | バックエンドへの自動バッチ送信間のミリ秒数。                                      | `number`  | `20000`    | `10000` |                                                                                                                                                                                   |
+| `sampleRate`    | 記録するセッションの割合。`0`（なし）から`1`（すべて）まで。                      | `number`  | `1`        | `0.5`   | サンプリングはセッションごとに決定的であるため、記録されたセッションはそのすべてのイベントを報告します（部分的なファネルにはなりません）。                                        |
 
 ---
 

package/docs/ja/interest_of_intlayer.md

@@ -48,7 +48,7 @@ author: aymericzip
 
 **AIエージェント**
 
-コンテンツを同じ場所に配置（コローケーション）することで、大規模言語モデル（LLM）に必要な**コンテキストが削減**されます。Intlayerには、翻訳漏れをテストするための**CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)**、**[エージェントスキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)**などのツールスイートも付属しており、AIエージェントの開発体験（DX）をさらにスムーズにします。
+コンテンツを同じ場所に配置（コローケーション）することで、大規模言語モデル（LLM）に必要な**コンテキストが削減**されます。Intlayerには、翻訳漏れをテストするための**CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/mcp_server.md)**、**[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)**などのツールスイートも付属しており、AIエージェントの開発体験（DX）をさらにスムーズにします。
 
 **機能性**
 

package/docs/ja/intlayer_with_analog.md

@@ -75,7 +75,7 @@ Intlayer は、**多言語ルーティング**、**SSR サポート**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_angular_19.md

@@ -53,7 +53,7 @@ Intlayer は、**コンポーネント レベルのコンテンツ スコープ*
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_angular_21.md

@@ -55,7 +55,7 @@ Intlayer は、**コンポーネント レベルのコンテンツ スコープ*
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_astro.md

@@ -79,7 +79,7 @@ Intlayer は、**多言語ルーティング**、**サイトマップ**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_astro_lit.md

@@ -78,7 +78,7 @@ Intlayer は、**多言語ルーティング**、**サイトマップ**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_astro_preact.md

@@ -77,7 +77,7 @@ Intlayer は、**多言語ルーティング**、**サイトマップ**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_astro_react.md

@@ -80,7 +80,7 @@ Intlayer は、**多言語ルーティング**、**サイトマップ**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_astro_solid.md

@@ -77,7 +77,7 @@ Intlayer は、**多言語ルーティング**、**サイトマップ**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_astro_svelte.md

@@ -77,7 +77,7 @@ Intlayer は、**多言語ルーティング**、**サイトマップ**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**
 

package/docs/ja/intlayer_with_astro_vanilla.md

@@ -77,7 +77,7 @@ Intlayer は、**多言語ルーティング**、**サイトマップ**、およ
 
 **AI エージェント**
 
-コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[エージェント スキル](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
+コンテンツを同じ場所に配置すると、大規模言語モデル (LLM) によって **必要なコンテキストが削減**されます。 Intlayer には、翻訳の欠落をテストする **CLI**、**[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/lsp.md)**、**[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)** などのツール スイートも付属しています。および **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/agent_skills.md)** により、AI エージェントの開発者エクスペリエンス (DX) がさらにスムーズになります。
 
 **オートメーション**