@intlayer/docs 9.3.3 → 9.4.0

package/docs/it/packages/react-intlayer/useI18n.md

@@ -77,6 +77,34 @@ Tutte le chiavi del dizionario devono essere dichiarate all'interno dei file di
 
 Esempi di utilizzo dell'hook `useI18n` all'interno di componenti React:
 
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
+import type { FC } from "react";
+import { ClientComponentExample, ServerComponentExample } from "@components";
+import { IntlayerProvider } from "react-intlayer";
+import { useI18n } from "react-intlayer/server";
+import { Locales } from "intlayer";
+
+const App: FC<{ locale: Locales }> = ({ locale }) => {
+  const t = useI18n("home-page", locale);
+
+  return (
+    <>
+      <p>{t("introduction")}</p>
+      <IntlayerProvider locale={locale}>
+        <ClientComponentExample />
+      </IntlayerProvider>
+      <ServerComponentExample />
+    </>
+  );
+};
+```
+
+ </Tab>
+ <Tab label='Intlayer <9.4' value='<9.4'>
+
 ```tsx fileName="src/App.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { ClientComponentExample, ServerComponentExample } from "@components";
@@ -101,6 +129,9 @@ const App: FC<{ locale: Locales }> = ({ locale }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useI18n } from "react-intlayer";

package/docs/it/packages/react-intlayer/useIntlayer.md

@@ -31,32 +31,6 @@ Questa sezione fornisce una guida dettagliata sull'uso dell'hook `useIntlayer` a
 
 ## Esempio di utilizzo in React
 
-Dimostrazione dell'hook `useIntlayer` all'interno di un componente React:
-
-```tsx fileName="src/app.tsx" codeFormat={["typescript", "esm"]}
-import type { FC } from "react";
-import { ClientComponentExample, ServerComponentExample } from "@components";
-import { IntlayerProvider } from "react-intlayer";
-import { useIntlayer, IntlayerServerProvider } from "react-intlayer/server";
-import { Locales } from "intlayer";
-
-const App: FC<{ locale: Locales }> = ({ locale }) => {
-  const content = useIntlayer("homepage", locale);
-
-  return (
-    <>
-      <p>{content.introduction}</p>
-      <IntlayerProvider locale={locale}>
-        <ClientComponentExample />
-      </IntlayerProvider>
-      <IntlayerServerProvider locale={locale}>
-        <ServerComponentExample />
-      </IntlayerServerProvider>
-    </>
-  );
-};
-```
-
 ```tsx fileName="src/components/ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useIntlayer } from "react-intlayer";
@@ -73,24 +47,6 @@ const ComponentExample: FC = () => {
 };
 ```
 
-```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat={["typescript", "esm"]}
-import { useIntlayer } from "react-intlayer/server";
-
-jsx fileName="src/components/ServerComponentExample.tsx" codeFormat="typescript"
-import { useIntlayer } from "react-intlayer/server";
-
-const ServerComponentExample = () => {
-  const content = useIntlayer("server-component");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p> {/* descrizione del contenuto */}
-    </div>
-  );
-};
-```
-
 ## Risorse Aggiuntive
 
 - **Intlayer Visual Editor**: Per un'esperienza di gestione dei contenuti più intuitiva, fare riferimento alla documentazione dell'editor visuale [qui](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md).

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

@@ -28,6 +28,8 @@ author: aymericzip
 
 Il plugin Vite `intlayerPrune` viene utilizzato per eseguire tree-shaking ed eliminare i dizionari non utilizzati dal bundle della tua applicazione. Questo aiuta a ridurre la dimensione finale del bundle includendo solo i contenuti multilingua necessari.
 
+> Il plugin è già incluso e configurato automaticamente quando utilizzi [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/vite-intlayer/intlayer.md). Devi registrarlo manualmente solo se stai componendo lo stack di plugin da solo.
+
 ## Utilizzo
 
 ### As part of `intlayer()` (recommended)
@@ -115,4 +117,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/it/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.it.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "it", // Importante
+  "content": {
+    "multilingualContent": "Titolo del mio componente",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Consigliato: questo formato è il migliore quando si utilizza l'editor visuale di Intlayer o si gestiscono le traduzioni direttamente nel codice.
 
+> Nota: In entrambi i casi, il file di dichiarazione del contenuto deve seguire il pattern di denominazione `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` per essere riconosciuto da Intlayer. Il suffisso `.[locale]` è opzionale e utilizzato solo come convenzione di denominazione.
+
 ### Configurazione globale per i file per-locale
 
 Puoi configurare la configurazione globale per i file per-locale aggiungendo quanto segue al tuo file `intlayer.config.ts`:
@@ -146,17 +159,6 @@ const helloWorldContent = {
 export default helloWorldContent;
 ```
 
-```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
-{
-  "$schema": "https://intlayer.org/schema.json",
-  "key": "hello-world",
-  "locale": "en", // Importante
-  "content": {
-    "multilingualContent": "Titolo del mio componente",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Importante: Assicurati che il campo locale sia definito. Indica a Intlayer quale lingua rappresenta il file.
 
-> Nota: In entrambi i casi, il file di dichiarazione del contenuto deve seguire il modello di denominazione `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` per essere riconosciuto da Intlayer. Il suffisso `.[locale]` è opzionale ed è usato solo come convenzione di denominazione.
-
 ## Mescolare Formati
 
 Puoi combinare entrambi gli approcci di dichiarazione per la stessa chiave di contenuto. Per esempio:

package/docs/it/readme.md

@@ -225,8 +225,8 @@ Esplora la nostra documentazione esaustiva per iniziare con Intlayer e imparare
   <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
   <li><a href="https://intlayer.org/doc/environment/nuxt-and-vue" rel=''>Vite + Nuxt</a></li>
   <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
-  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
-  <li>
+  <li><a href="https://intlayer.org/doc/environment/solid-start" rel=''>Solid Start</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>  <li>
      <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Esplora la nostra documentazione esaustiva per iniziare con Intlayer e imparare
       <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
       <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
       <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+      <li><a href="https://intlayer.org/doc/environment/elysia" rel=''>Elysia</a></li>
     </ul>
   </li>
 </ul>

package/docs/it/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 Puoi ancora perfezionare per dizionario utilizzando il campo `autoFill` nei file di contenuto. Consulta la documentazione completa in `doc/autoFill` e `doc/dictionary/content_file`.
 
+Puoi comunque affinare per dizionario utilizzando il campo `autoFill` nei file di contenuto. Intlayer considererà prima la configurazione per dizionario e poi farà un fallback alla configurazione globale. Consulta il riferimento completo in [Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/autoFill.md) e [Riferimento file di contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md).
+
 ---
 
 ## Comando fill: impostazioni predefinite più sicure
@@ -175,6 +177,20 @@ Consulta i dettagli nella documentazione della [Estensione Ufficiale per VS Code
 
 ---
 
+Aggiornato il server MCP per supportare le nuove funzionalità.
+
+- Compilazione automatica
+- Test delle traduzioni mancanti
+- Aggiornamenti in tempo reale
+- Logging
+- Validazione
+- Note sulla migrazione
+- Documentazione
+
+> Il server MCP aiuta nell'automazione dei progetti che utilizzano Intlayer. Verifica le traduzioni mancanti per il codice autogenerato. Aiuta a comprendere la tua configurazione e incorpora la documentazione di Intlayer nel tuo IDE.
+
+---
+
 ## Prestazioni: 10× più veloce
 
 - Risoluzione parallela dei dizionari locali e remoti
@@ -296,8 +312,6 @@ Note:
 
 Vedi [CMS e Live Sync](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md) e [Configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md) per una guida completa.
 
----
-
 ## Processo parallelo per monitorare i file su turbopack
 
 Quando si utilizza Turbopack su Next.js 14 e versioni successive come server di sviluppo con il comando `next dev --turbopack`, le modifiche al dizionario non verranno rilevate automaticamente per impostazione predefinita.

package/docs/it/releases/v8.md

@@ -763,8 +763,6 @@ export default {
   </Tab>
 </Tabs>
 
----
-
 ## Regole di Pluralizzazione Unicode CLDR (v8.8.0)
 
 È stato introdotto un nuovo helper per nodi `plural` basato sulle regole di pluralizzazione definite dal Progetto Unicode CLDR, migliorando il supporto per le lingue complesse.
@@ -1121,7 +1119,7 @@ Intlayer v8 include un nuovo layer di caching per il compilatore Markdown e HTML
 
 <Tabs group='bundler'>
   <Tab label="Next.js" value="nextjs">
-  
+
     ```typescript fileName="babel.config.js"
       const {
       intlayerExtractBabelPlugin,
@@ -1143,7 +1141,7 @@ Intlayer v8 include un nuovo layer di caching per il compilatore Markdown e HTML
 
   </Tab>
   <Tab label="Vite" value="vite">
-   
+
     ```typescript fileName="vite.config.js"
     import { defineConfig } from 'vite';
     import { intlayer, intlayerCompiler } from "vite-intlayer";

package/docs/it/releases/v9.md

@@ -374,6 +374,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 Il programma di installazione scarica un `docker-compose.yml` e un `.env`, genera automaticamente i secret necessari ed esegue `docker compose up -d`. Tutto — il dashboard, l'API, il database, l'archiviazione di oggetti e le email transazionali — viene eseguito localmente nei container.
 
+---
+
 ## Note di migrazione da v8
 
 Se stai eseguendo l'aggiornamento da v8, nota che la v9 non include breaking changes. Ma ecco le modifiche chiave:

package/docs/it/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer può essere eseguito interamente sulla tua infrastruttura — non è richiesto alcun account Intlayer Cloud. Un singolo comando avvia uno stack pronto per la produzione:
 
+Un comando installa tutto:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 L'installer scarica un `docker-compose.yml` e un `.env`, genera automaticamente i segreti richiesti e avvia tutti i container con `docker compose up -d`.
 
+L'unica dipendenza esterna è **MongoDB**: il backend si connette a un cluster MongoDB **Atlas**, che fornisci tu. Tutto il resto viene eseguito all'interno del container.
+
 ## Indice dei Contenuti
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (utilizzato per la generazione di screenshot con Puppeteer) è incluso
 - Porte `3000`, `3100`, `8025`, `9000` e `9001` disponibili sull'host.
 - Un host Linux o macOS (o WSL2 su Windows).
 
+Tutto il resto — Bun, Redis, MinIO, Chromium — è incluso nell'immagine.
+
 ---
 
-## Avvio rapido
+## Quick start
+
+### 1. Eseguire l'installer
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Verifica che Docker sia installato e in esecuzione, scrive `./intlayer.env` con `BETTER_AUTH_SECRET` e `S3_SECRET_ACCESS_KEY` già generati, e scarica l'immagine. Non avvia il container — il backend non può avviarsi senza le credenziali del database.
 
-Scarica ed esegui l'immagine pubblicata, fornendo le tue credenziali e i segreti di MongoDB Atlas:
+Rieseguire l'installer è sicuro: un `intlayer.env` esistente non viene mai sovrascritto, quindi funge anche da percorso di aggiornamento.
+
+### 2. Compila le tue credenziali
+
+Apri `intlayer.env` e completa i valori contrassegnati come `TODO`:
+
+```sh fileName="intlayer.env"
+DB_ID=<atlas-user>
+DB_MDP=<atlas-password>
+DB_CLUSTER=<cluster>.xxxxx.mongodb.net
+RESEND_API_KEY=<your-resend-key>
+```
+
+Il file contiene anche blocchi commentati per le funzionalità opzionali — [SMTP mailer](#global-mailer), `OPENAI_API_KEY` e i provider OAuth. Decommentali secondo le tue necessità.
+
+> Il file viene letto da `docker run --env-file`, che non rimuove le virgolette e tratta tutto ciò che segue `=` come valore. Scrivi valori senza virgolette e mantieni i commenti su righe separate.
+
+### 3. Avvia il container
+
+Questo è il comando che l'installer stampa quando termina:
 
 ```sh
 docker run -d --name intlayer \
+  --restart unless-stopped \
   -p 3000:3000 \
   -p 3100:3100 \
   -p 9000:9000 \
   -p 9001:9001 \
   -v intlayer-data:/data \
-  -e DB_ID="<atlas-user>" \
-  -e DB_MDP="<atlas-password>" \
-  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \
-  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \
-  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \
-  -e RESEND_API_KEY="<your-resend-key>" \
-  aymericzip/intlayer-selfhost
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
 ```
 
-Quindi apri **http://localhost:3000**.
+Quindi apri **http://localhost:3000**. Il primo avvio inizializza i datastore, quindi concedi un minuto.
 
 > La dashboard è servita su `localhost`. Vedi [Limitazioni](#limitations) — i domini personalizzati non sono supportati dall'immagine pubblicata.
 
----
+### Impostazioni del installer
 
-## Avvio rapido
+Il installer legge alcune variabili d'ambiente. Poiché viene piped in `sh`, passale alla shell piuttosto che a `curl`:
 
 ```sh
-curl -fsSL https://intlayer.org/install.sh | sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
 ```
 
+| Variable                  | Default                                       | Description                          |
+| ------------------------- | --------------------------------------------- | ------------------------------------ |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | Immagine da scaricare                |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Dove scrivere il file env            |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Nome del container                   |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Volume denominato montato su `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Porta host per il dashboard          |
+| `INTLAYER_API_PORT`       | `3100`                                        | Porta host per l'API                 |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Porta host per l'API S3 MinIO        |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Porta host per la console MinIO      |
+
+> Le quattro variabili di porta cambiano solo il lato **host** del mapping stampato nel comando `docker run`. L'immagine pubblicata ha `http://localhost:3000`, `http://localhost:3100` e `http://localhost:9000` compilati nel bundle dashboard al momento della compilazione, quindi rimappare i porta lascia il browser che punta alle porte vecchie. Mantieni i valori predefiniti a meno che non stai costruendo la tua immagine — vedi [Limitations](#limitations).
+
+---
+
+## Avvio rapido
+
 Cosa fa l'installer:
 
 1.  Verifica che `docker` e `docker compose` siano presenti.
@@ -117,8 +163,6 @@ Dopo che lo stack è attivo, apri **http://localhost:3000** e crea il tuo primo
 | **minio**   | `minio/minio`                        | `9000` (S3), `9001` (console)  | Storage di oggetti compatibile con S3 per avatar e screenshot |
 | **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (web UI) | Sink di email transazionali locale                            |
 
-Le porte interne (mongo, redis) non sono esposte all'host per impostazione predefinita.
-
 > La porta `9000` di MinIO deve essere raggiungibile dal browser perché gli asset caricati (avatar, screenshot) vengono caricati direttamente da `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ Le porte interne (mongo, redis) non sono esposte all'host per impostazione prede
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Accesso OAuth di LinkedIn                                                 |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Accesso OAuth di Atlassian                                                |
 
----
-
 ### Mailer globale
 
 Per impostazione predefinita, tutti i messaggi email transazionali vengono inviati tramite Resend utilizzando `RESEND_API_KEY`. I deploy self-hosted possono invece instradare **ogni** email — incluse le email non organizzative come i reset delle password e i magic link — attraverso un mailer globale configurato con variabili di ambiente.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Aggiornamento
 
-Eseguire nuovamente l'installer su un'implementazione esistente esegue un aggiornamento rolling:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Questo scarica le immagini più recenti e riavvia i container con `docker compose pull && docker compose up -d`. I volumi esistenti (`mongo-data`, `redis-data`, `minio-data`) vengono preservati — nessuna perdita di dati.
 
-Per aggiornare manualmente dalla directory `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Cerca `MongoDB connection error` vicino alla parte superiore del log.
+
 ### La dashboard non riesce a raggiungere l'API
 
 Verifica che `VITE_BACKEND_URL` corrisponda all'URL dove il backend è raggiungibile dal **browser** (non dalla rete Docker). Se hai cambiato la porta del backend o aggiunto un reverse proxy, ricostruisci l'immagine della dashboard:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Bucket MinIO mancante
 
 Se il servizio one-shot `minio-init` non è stato eseguito (o è stato eseguito prima che MinIO fosse pronto), crea il bucket manualmente:

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,16 +103,25 @@ export default config;
 
 Intlayerをセルフホスト（self-host）している場合、`editor.backendURL`を共有しているため、アナリティクスは自動的にご自身のインスタンスを指します。
 
-## フレームワークのサポート
+### オプトアウトする
 
-Analyticsは`react-intlayer`からの共有`IntlayerProvider`に組み込まれているため、そのプロバイダが使用されている場所であればどこでも今日から利用できます：
+任意の `analytics` ブロックで収集を調整、または停止できます:
 
-| フレームワーク                                           | ステータス                                                                                           |
-| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| React                                                    | ✅ 利用可能                                                                                          |
-| Next.js (`next-intlayer`)                                | ✅ 利用可能 (`react-intlayer` 経由)                                                                  |
-| React Native / Expo (`react-native-intlayer`)            | ✅ 利用可能 (`react-intlayer` 経由)                                                                  |
-| Vue, Svelte, Angular, Solid, Preact, Lit, Astro, Vanilla | 🚧 計画中 — 同一クライアント、`@intlayer/editor`の展開パターンに従うプロバイダレベルのバインディング |
+```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)を参照してください。
 
 ## 使用方法
 
@@ -154,6 +166,34 @@ const CTAButton = () => {
 
 ### クライアント側でのバリアント解決
 
+  </Tab>
+</Tabs>
+
+Weights はオプションです — スプリットを調整するために、バリアントごとに 1 つ渡します。例えば、`useExperiment("homepage-hero", ["default", "black_friday"], [9, 1])` のようにします。
+
+子は、一致する辞書の[Variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/variants.md)を読みます：
+
+```tsx fileName="HeroBanner.tsx"
+import { useIntlayer } from "react-intlayer";
+
+export const HeroBanner = ({ variant }: { variant: string }) => {
+  const { headline, cta } = useIntlayer("hero-banner", { variant });
+
+  return (
+    <section>
+      <h1>{headline}</h1>
+      <a>{cta}</a>
+    </section>
+  );
+};
+```
+
+> **子コンポーネント**でバリアントを読み込むことが、React の外でも機能する理由です。Vue、Svelte、Solid、Angular では、`useIntlayer` に渡されるセレクタはコンポーネントがセットアップされるときにキャプチャされるため、読み込みはバリアントが既知の後にのみマウントされるコンポーネント内で発生する必要があります。
+
+実験が単一の辞書ではなくページ全体をカバーする場合は、variant をプロバイダーにホイストしてください — [Ambient variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/variants.md#ambient-variant) を参照してください。以下のすべての `useIntlayer` は、呼び出しサイトの変更なしでそれに対して解決されます。
+
+コンポーネント外で生の割り当てが必要な場合は、クライアントに直接アクセスしてください：
+
 ```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
 import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
 
@@ -164,6 +204,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant` は割り当てるだけで、exposure を記録しません。`useExperiment()` を使用することをお勧めします。そうしないと、コンバージョン率の分母がありません。
+
 ## プライバシーとパフォーマンス
 
 - **設計上の匿名性**: セッションは回転するIDによって識別されます。バックエンドはそのIDの**SHA-256ハッシュ**のみを保存し、生のIDやIPアドレスは決して保存しません。
@@ -177,7 +219,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内ではアナリティクスが無効になっているため、エディタセッションが実際のトラフィックとしてカウントされることはありません。
 
 ## ダッシュボード：アナリティクスページ
@@ -213,6 +255,8 @@ const cms = createIntlayerCMS();
 const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
 ```
 
+> **サーバーサイドのみ。** `createIntlayerCMS()` は `clientId` + `clientSecret` で認証され、シークレットはブラウザで利用できません — このスニペットがそこで実行されると、認証されていないリクエストが発行されます。ルートハンドラー、サーバーアクション、またはスクリプトに保つようにしてください。
+
 ## 便利なリンク
 
 - [ダイナミック辞書 - コレクションとバリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)