@intlayer/docs 9.3.3 → 9.4.0

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

@@ -31,32 +31,6 @@ Hook `useIntlayer` memungkinkan Anda untuk mengambil konten terlokalisasi dari k
 
 ## Contoh Penggunaan di React
 
-Menunjukkan penggunaan hook `useIntlayer` dalam sebuah komponen 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";
-
-tsx 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>
-    </div>
-  );
-};
-```
-
 ## Sumber Daya Tambahan
 
 - **Intlayer Visual Editor**: Untuk pengalaman manajemen konten yang lebih intuitif, lihat dokumentasi editor visual [di sini](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/intlayer_visual_editor.md).

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

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize` bernilai `true` (atau `undefined`, yang secara default bernilai `true` untuk build).
 3. `build.minify` bernilai `true` dalam konfigurasi Intlayer Anda.
 
-Ini secara otomatis **dinonaktifkan** ketika `editor.enabled` bernilai `true` karena editor memerlukan konten kamus yang lengkap dan dapat dibaca manusia.
+Ketika `editor.enabled` bernilai `true`, plugin tetap berjalan tetapi **melewati penggantian nama field**: penggantian nama menulis ulang kunci konten yang dilalui interpreter, sehingga `keyPath` yang diterima Visual editor tidak lagi cocok dengan kamus yang belum digabung yang sedang diedit. Pemadatan whitespace dan penghapusan metadata tingkat atas tetap aktif.
 
 ## Apa yang diminifikasi
 

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

@@ -28,6 +28,8 @@ author: aymericzip
 
 Plugin Vite `intlayerPrune` digunakan untuk melakukan tree-shaking dan memangkas kamus yang tidak terpakai dari bundle aplikasi Anda. Ini membantu mengurangi ukuran bundle akhir dengan hanya menyertakan konten multibahasa yang diperlukan.
 
+> Plugin sudah disertakan dan dikonfigurasi secara otomatis ketika Anda menggunakan [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/id/packages/vite-intlayer/intlayer.md). Anda hanya perlu mendaftarkannya secara manual jika Anda menyusun plugin stack sendiri.
+
 ## Penggunaan
 
 ### Sebagai bagian dari `intlayer()` (direkomendasikan)
@@ -115,4 +117,4 @@ Ketika pruning berhasil, `intlayerPrune` juga menulis `pruneContext.dictionaryKe
 2. `build.optimize` adalah `true` (atau `undefined`, yang secara default adalah `true` untuk build).
 3. `build.purge` adalah `true` dalam konfigurasi Intlayer Anda.
 
-Secara otomatis **dinonaktifkan** ketika `editor.enabled` adalah `true` karena editor memerlukan konten kamus lengkap.
+Proses ini tetap aktif ketika `editor.enabled` bernilai `true`: Visual editor menyelesaikan setiap pengeditan melalui `dictionaryKey` + `keyPath` terhadap kamus yang belum digabung, yang tidak pernah disentuh oleh plugin ini, dan field yang dipangkas adalah field yang tidak dibaca oleh komponen mana pun — sehingga tidak pernah dirender maupun dapat dipilih di halaman.

package/docs/id/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.id.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "id", // Penting
+  "content": {
+    "multilingualContent": "Judul komponen saya",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > Direkomendasikan: Format ini paling baik digunakan saat memakai editor visual Intlayer atau mengelola terjemahan langsung di dalam kode.
 
+> Catatan: Dalam kedua kasus, file deklarasi konten harus mengikuti pola penamaan `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` untuk dikenali oleh Intlayer. Akhiran `.[locale]` bersifat opsional dan hanya digunakan sebagai konvensi penamaan.
+
 ### Konfigurasi Global untuk File Per-Locale
 
 Anda dapat mengonfigurasi konfigurasi global untuk file per-locale dengan menambahkan hal berikut ke file `intlayer.config.ts` Anda:
@@ -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", // Penting
-  "content": {
-    "multilingualContent": "Judul komponen saya",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > Penting: Pastikan field locale didefinisikan. Ini memberitahu Intlayer bahasa apa yang diwakili oleh file tersebut.
 
-> Catatan: Dalam kedua kasus, file deklarasi konten harus mengikuti pola penamaan `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` agar dikenali oleh Intlayer. Sufiks `.[locale]` bersifat opsional dan hanya digunakan sebagai konvensi penamaan.
-
 ## Menggabungkan Format
 
 Anda dapat menggabungkan kedua pendekatan deklarasi untuk kunci konten yang sama. Sebagai contoh:

package/docs/id/readme.md

@@ -225,8 +225,8 @@ Jelajahi dokumentasi lengkap kami untuk memulai dengan Intlayer dan pelajari car
   <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 @@ Jelajahi dokumentasi lengkap kami untuk memulai dengan Intlayer dan pelajari car
       <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/id/self_hosting.md

@@ -21,12 +21,16 @@ author: aymericzip
 
 Intlayer dapat berjalan sepenuhnya di infrastruktur Anda sendiri — tidak memerlukan akun Intlayer Cloud. Satu perintah akan mem-boot stack yang siap produksi:
 
+Satu perintah menginstal semuanya:
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
 Installer mengunduh `docker-compose.yml` dan `.env`, membuat secret yang diperlukan secara otomatis, dan memulai semua kontainer dengan `docker compose up -d`.
 
+Satu-satunya dependensi eksternal adalah **MongoDB**: backend terhubung ke cluster MongoDB **Atlas**, yang Anda sediakan. Semua yang lain berjalan di dalam container.
+
 ## Daftar Isi
 
 <TOC/>
@@ -60,40 +64,82 @@ Chromium (digunakan untuk pembuatan screenshot Puppeteer) dibundel di dalam imag
 - Port `3000`, `3100`, `8025`, `9000`, dan `9001` tersedia di host.
 - Host Linux atau macOS (atau WSL2 di Windows).
 
+Semuanya — Bun, Redis, MinIO, Chromium — dikirimkan di dalam image.
+
 ---
 
-## Mulai Cepat
+## Memulai dengan cepat
+
+### 1. Jalankan installer
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Installer memverifikasi bahwa Docker terinstall dan berjalan, menulis `./intlayer.env` dengan `BETTER_AUTH_SECRET` dan `S3_SECRET_ACCESS_KEY` yang sudah digenerate, dan menarik image. Installer tidak memulai container — backend tidak dapat boot tanpa kredensial database Anda.
+
+Menjalankan installer kembali aman: `intlayer.env` yang sudah ada tidak akan pernah ditimpa, jadi ini juga berfungsi sebagai jalur upgrade.
 
-Pull dan jalankan image yang dipublikasikan, dengan menyediakan kredensial dan secrets MongoDB Atlas Anda:
+### 2. Isi kredensial Anda
+
+Buka `intlayer.env` dan lengkapi nilai-nilai yang ditandai `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>
+```
+
+File ini juga berisi blok yang dikomentari untuk fitur-fitur opsional — [SMTP mailer](#global-mailer), `OPENAI_API_KEY`, dan penyedia OAuth. Uncomment yang Anda butuhkan.
+
+> File dibaca oleh `docker run --env-file`, yang tidak menghapus tanda kutip dan menganggap semua yang setelah `=` sebagai nilai. Tulis nilai tanpa tanda kutip, dan simpan komentar di baris terpisah.
+
+### 3. Mulai container
+
+Ini adalah perintah yang dicetak oleh installer ketika selesai:
 
 ```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
 ```
 
-Kemudian buka **http://localhost:3000**.
+Kemudian buka **http://localhost:3000**. Boot pertama menginisialisasi datastores, jadi tunggu sebentar.
 
-> Dashboard disajikan di `localhost`. Lihat [Batasan](#batasan) — domain kustom tidak didukung oleh image yang dipublikasikan.
+> Dashboard disajikan di `localhost`. Lihat [Limitations](#limitations) — domain kustom tidak didukung oleh image yang dipublikasikan.
 
----
+### Pengaturan Installer
 
-## Memulai Cepat
+Installer membaca beberapa variabel environment. Karena di-pipe ke `sh`, teruskan ke shell daripada ke `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` | Image to pull                   |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | Where to write the env file     |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | Container name                  |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | Named volume mounted at `/data` |
+| `INTLAYER_APP_PORT`       | `3000`                                        | Host port for the dashboard     |
+| `INTLAYER_API_PORT`       | `3100`                                        | Host port for the API           |
+| `INTLAYER_S3_PORT`        | `9000`                                        | Host port for the MinIO S3 API  |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | Host port for the MinIO console |
+
+> Keempat variabel port hanya mengubah sisi **host** dari mapping yang dicetak dalam perintah `docker run`. Image yang dipublikasikan memiliki `http://localhost:3000`, `http://localhost:3100` dan `http://localhost:9000` dikompilasi ke dalam bundle dashboard pada saat build, jadi remapping mereka membuat browser tetap menunjuk ke port lama. Pertahankan default kecuali Anda membangun image Anda sendiri — lihat [Limitations](#limitations).
+
+---
+
+## Memulai Cepat
+
 Apa yang dilakukan installer:
 
 1.  Memeriksa bahwa `docker` dan `docker compose` ada.
@@ -117,8 +163,6 @@ Setelah stack aktif, buka **http://localhost:3000** dan buat akun pertama Anda.
 | **minio**   | `minio/minio`                         | `9000` (S3), `9001` (konsol)   | Penyimpanan objek yang kompatibel dengan S3 untuk avatar dan screenshot |
 | **mailpit** | `axllent/mailpit`                     | `1025` (SMTP), `8025` (UI web) | Sink email transaksional lokal                                          |
 
-Port internal (mongo, redis) tidak terekspos ke host secara default.
-
 > Port MinIO `9000` harus dapat dijangkau oleh browser karena aset yang diunggah (avatar, screenshot) dimuat langsung dari `S3_PUBLIC_URL=http://localhost:9000/intlayer`.
 
 ---
@@ -174,8 +218,6 @@ Port internal (mongo, redis) tidak terekspos ke host secara default.
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Login LinkedIn OAuth                                          |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Login Atlassian OAuth                                         |
 
----
-
 ### Global mailer
 
 Secara default, semua email transaksional dikirim melalui Resend menggunakan `RESEND_API_KEY`. Deployment yang self-hosted dapat mengarahkan **setiap** email — termasuk email non-organisasi seperti reset password dan magic links — melalui global mailer yang dikonfigurasi dengan environment variables.
@@ -261,16 +303,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## Peningkatan
 
-Menjalankan ulang installer pada deployment yang ada akan melakukan rolling upgrade:
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 Ini menarik image terbaru dan memulai ulang kontainer dengan `docker compose pull && docker compose up -d`. Volume yang sudah ada (`mongo-data`, `redis-data`, `minio-data`) dipertahankan — tidak ada kehilangan data.
 
-Untuk meningkatkan secara manual dari dalam direktori `./intlayer/`:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -334,15 +368,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+Cari `MongoDB connection error` di bagian atas log.
+
 ### Dashboard tidak dapat mencapai API
 
 Verifikasi bahwa `VITE_BACKEND_URL` cocok dengan URL di mana backend dapat dijangkau dari **browser** (bukan jaringan Docker). Jika Anda mengubah port backend atau menambahkan reverse proxy, bangun ulang image dashboard:
 
-```sh
-docker compose build app
-docker compose up -d app
-```
-
 ### Bucket MinIO hilang
 
 Jika layanan one-shot `minio-init` tidak berjalan (atau berjalan sebelum MinIO siap), buat bucket secara manual:

package/docs/it/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: Competenze dell'Agente
+title: Agent Skills
 description: Scopri come utilizzare le Intlayer Agent Skills per migliorare la comprensione del tuo progetto da parte del tuo agente AI, inclusi i manuali completi di configurazione per Metadati, Sitemap e Azioni del Server.
 keywords:
   - Intlayer
-  - Competenze dell'Agente
+  - Agent Skills
   - Agente AI
   - Internazionalizzazione
   - Documentazione
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# Competenze dell'Agente
+# Agent Skills
 
 ## Configurazione
 
 ### Utilizzo della CLI
 
-Il comando `intlayer init skills` è il modo più semplice per configurare le competenze dell'agente nel tuo progetto. Rileva il tuo ambiente e installa i file di configurazione necessari per le tue piattaforme preferite.
+Il comando `intlayer init skills` è il modo più semplice per configurare le Agent Skills nel tuo progetto. Rileva il tuo ambiente e installa i file di configurazione necessari per le tue piattaforme preferite.
 
 ```bash packageManager="npm"
 npx intlayer init skills
@@ -54,10 +54,10 @@ npx skills add aymericzip/intlayer-skills
 1. Apri la Tavolozza dei Comandi (Ctrl+Shift+P o Cmd+Shift+P).
 2. Digita `Intlayer: Setup AI Agent Skills`.
 3. Scegli la piattaforma che utilizzi (es. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, ecc.).
-4. Scegli le competenze che desideri installare (es. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
+4. Scegli le Agent Skills che desideri installare (es. `Next.js`, `React`, `Vite`, `Compiler`, `Configuration`).
 5. Premi Invio.
 
-## Elenco delle competenze
+## Elenco delle Agent Skills
 
 **intlayer-config**
 

package/docs/it/analytics.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-07-08
-updatedAt: 2026-07-08
+updatedAt: 2026-08-22
 title: Intlayer Analytics | Traccia l'esposizione dei contenuti ed esegui test A/B
 description: Scopri come @intlayer/analytics traccia le visualizzazioni di pagine/lingue e l'esposizione dei contenuti, e come usarlo per eseguire test A/B sui tuoi contenuti Intlayer.
 keywords:
@@ -18,6 +18,9 @@ slugs:
   - concept
   - analytics
 history:
+  - version: 9.3.3
+    date: 2026-08-22
+    changes: "Abilitare gli analytics per impostazione predefinita quando `@intlayer/analytics` è installato"
   - version: 9.0.0
     date: 2026-07-08
     changes: "Init doc — pacchetto @intlayer/analytics, tracciamento a livello provider/nodo, test A/B, dashboard"
@@ -57,7 +60,7 @@ Intlayer ti permette già di dichiarare le [Varianti](https://github.com/aymeric
 
 ## Installazione
 
-`@intlayer/analytics` è una dipendenza **peer e opzionale** — non viene mai installata automaticamente da un pacchetto del framework. Aggiungila assieme a `intlayer`:
+`@intlayer/analytics` è una **dipendenza opzionale** di ogni pacchetto di framework (`react-intlayer`, `next-intlayer`, `vue-intlayer`, …), quindi la maggior parte dei progetti la possiede già. Installala esplicitamente se la tua configurazione salta le dipendenze opzionali (`npm install --no-optional`, …):
 
 ```bash packageManager="npm"
 npm install @intlayer/analytics
@@ -75,11 +78,11 @@ pnpm add @intlayer/analytics
 bun add @intlayer/analytics
 ```
 
-Se non la installi, ogni punto di integrazione si risolve in una no-op (nessuna operazione) — vedi [Costo zero quando non installato](#costo-zero-quando-non-installato) di seguito.
+Installare il pacchetto è tutto ciò che serve per attivare gli analytics: `analytics.enabled` vale `true` per impostazione predefinita e `@intlayer/config` lo risolve a `false` ogni volta che il pacchetto non viene trovato nel progetto. Se non la installi, ogni punto di integrazione si risolve in una no-op (nessuna operazione) — vedi [Costo zero quando non installato](#costo-zero-quando-non-installato) di seguito.
 
 ## Configurazione
 
-Analytics **riutilizza il blocco di configurazione `editor` esistente** — non c'è uno schema di configurazione `analytics` separato da compilare:
+Gli analytics non richiedono alcuna configurazione per partire: sono **abilitati per impostazione predefinita** e **riutilizzano il blocco di configurazione `editor` esistente** per l'endpoint e la chiave di progetto.
 
 ```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
 import type { IntlayerConfig } from "intlayer";
@@ -100,6 +103,26 @@ export default config;
 
 Se gestisci Intlayer in self-hosting, le analytics puntano automaticamente alla tua istanza poiché condivide `editor.backendURL`.
 
+### Come disattivarli
+
+Il blocco opzionale `analytics` regola — o disattiva — la raccolta:
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  analytics: {
+    enabled: false, // Predefinito: true — esclude l'intera integrazione dal bundle
+    flushInterval: 20_000, // Millisecondi tra due invii in batch
+    sampleRate: 1, // Frazione di sessioni da registrare, da 0 (nessuna) a 1 (tutte)
+  },
+};
+
+export default config;
+```
+
+Disinstallare `@intlayer/analytics` ha lo stesso effetto di `enabled: false`. Consulta il [riferimento di configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md) per l'elenco completo dei campi.
+
 ## Supporto Framework
 
 L'Analytics è cablata nel `IntlayerProvider` condiviso di `react-intlayer`, quindi è disponibile oggi ovunque venga utilizzato quel provider:
@@ -177,7 +200,7 @@ const variant = client?.getVariant("homepage-hero", [
 `@intlayer/analytics` segue esattamente lo stesso pattern di dipendenza opzionale di `@intlayer/editor`:
 
 - ogni punto di integrazione carica il pacchetto tramite un **`import()` dinamico racchiuso in `try/catch`** — un'app che non installa mai `@intlayer/analytics` non paga un costo in termini di bundle-size o runtime, e non vede mai un errore;
-- una variabile d'ambiente a tempo di compilazione (`INTLAYER_ANALYTICS_ENABLED`), impostata automaticamente su `'false'` da `@intlayer/config` qualora `editor.clientId` non sia configurato, permette ai bundler di **eliminare tramite dead-code** l'intera integrazione;
+- una variabile d'ambiente in fase di compilazione (`INTLAYER_ANALYTICS_ENABLED`), impostata automaticamente a `'false'` da `@intlayer/config` quando il pacchetto non è installato, `analytics.enabled` è `false` oppure `editor.clientId` non è configurato, consente ai bundler di **eliminare come codice morto (dead-code-eliminate)** l'intera integrazione;
 - le analytics sono disabilitate all'interno dell'iframe di anteprima di Intlayer editor/CMS, in modo che le sessioni dell'editor non contino mai come vero traffico.
 
 ## Dashboard: Pagina Analytics

package/docs/it/benchmark/tanstack.md

@@ -194,6 +194,8 @@ L'idea alla base di `Wuchale` è interessante ma non ancora una soluzione pratic
 
 `Tolgee` affronta molti dei problemi menzionati in precedenza. L'ho trovato più difficile da avviare rispetto ad altri strumenti con approcci simili. Non fornisce type safety, il che rende anche molto difficile individuare le chiavi mancanti a compile time. Ho dovuto avvolgere le API di Tolgee con le mie per aggiungere il rilevamento delle chiavi mancanti.
 
+Il package è abbastanza pesante (~11.1kb, che è più di 2× `react-intlayer`).
+
 Su TanStack Start ho avuto anche problemi di reattività: al cambio di lingua, dovevo forzare il provider a rieseguire il rendering e sottoscrivermi agli eventi di cambio lingua in modo che il caricamento in un'altra lingua si comportasse correttamente.
 
 **(use-intl)** (`use-intl@4.9.1`):
@@ -208,6 +210,8 @@ Su TanStack Start eviti le trappole specifiche di Next.js (`setRequestLocale`, r
 
 Tuttavia, condivide gli stessi svantaggi principali degli stack basati su `t('a.b.c')`: le ottimizzazioni sono possibili ma richiedono molto tempo, e i grandi progetti rischiano cattive pratiche (namespace + caricamento dinamico + tipi).
 
+Il package è particolarmente pesante (~17.3kb, che è circa 3.5× `react-intlayer`).
+
 I formati dei messaggi divergono inoltre: `use-intl` usa ICU MessageFormat, mentre `i18next` usa il proprio formato - il che complica il tooling o le migrazioni se li mescoli.
 
 **(Lingui)** (`@lingui/core@5.3.0`):
@@ -218,6 +222,8 @@ I formati dei messaggi divergono inoltre: `use-intl` usa ICU MessageFormat, ment
 
 `react-intl` è un'implementazione performante del team Format.js. La DX rimane prolissa: `const intl = useIntl()` + `intl.formatMessage({ id: "xx.xx" })` aggiunge complessità, lavoro extra JavaScript e lega l'istanza globale i18n a molti nodi nell'albero React.
 
+Il package è anche pesante (~14.4kb, che è circa 3× `react-intlayer`).
+
 ### 4 - Raccomandazioni
 
 Questo benchmark su TanStack Start non ha un equivalente diretto di `next-translate` (plugin Next.js + `getStaticProps`). Per i team che vogliono davvero un'API `t()` con un ecosistema maturo, `react-i18next` e `use-intl` rimangono scelte "ragionevoli", ma preparatevi a investire molto tempo nell'ottimizzazione per evitare leakage.

package/docs/it/bundle_optimization.md

@@ -476,7 +476,7 @@ const config: IntlayerConfig = {
 export default config;
 ```
 
-> La minificazione viene saltata quando `optimize` è `false` o quando `editor.enabled` è `true` (l'editor visuale richiede il nome completo della proprietà per consentire la modifica).
+> La minificazione viene saltata quando `optimize` è `false`. Quando `editor.enabled` è `true`, viene comunque eseguita, ma senza il passaggio di rinomina dei campi — l'editor visuale risolve le modifiche tramite `keyPath`, quindi i nomi dei campi originali devono essere preservati.
 
 > Su Next.js la minificazione viene saltata anche quando `@intlayer/swc` non è installato o non può essere caricato (Next.js sotto la 16.1.0). Il plugin è la metà che riscrive gli accessi nel sorgente, quindi rinominare i dizionari senza di esso lascerebbe il tuo codice a leggere nomi di campi che non esistono più.
 
@@ -508,7 +508,7 @@ export default config;
 { "title": "…", "subtitle": "…" }
 ```
 
-> Il purge viene saltato se `optimize` è `false` o quando `editor.enabled` è `true`. Su Next.js viene inoltre saltato quando `@intlayer/swc` non è disponibile e quando sono configurati chiamanti degli adattatori di compatibilità.
+> Il purge viene saltato quando `optimize` è `false`. Rimane attivo quando `editor.enabled` è `true` — un campo eliminato non viene letto da alcun componente, quindi l'editor non lo renderizza mai. Su Next.js viene inoltre saltato quando `@intlayer/swc` non è disponibile e quando sono configurati chiamanti degli adattatori di compatibilità.
 
 > Il purge viene saltato per precauzione qualora un file non riesca a essere analizzato, oppure se l'oggetto `useIntlayer` viene riversato in altri valori usando parametri dinamici non analizzabili (come distruggere parti non strutturate, assegnazioni generiche ai props ecc.). In questi scenari viene conservato l'intero dizionario.
 

package/docs/it/cli/ci.md

@@ -128,6 +128,8 @@ bun x intlayer ci fill --verbose --mode complete
 
 ### Utilizzare nelle pipeline CI/CD
 
+Eseguendo `intlayer init` viene creato automaticamente un set di due flussi di lavoro GitHub Actions pronti all'uso (vedi [GitHub Actions creati automaticamente](#scaffolded-github-actions) di seguito). L'esempio qui mostrato illustra la configurazione equivalente utilizzando il comando `ci` per un monorepo, dove le credenziali vengono iniettate per progetto da `INTLAYER_PROJECT_CREDENTIALS`.
+
 Nella tua configurazione CI/CD (ad esempio, GitHub Actions, GitLab CI), imposta `INTLAYER_PROJECT_CREDENTIALS` come segreto:
 
 ```yaml

package/docs/it/cli/doc-review.md

@@ -91,7 +91,15 @@ Per la maggior parte dei casi d'uso,
 
 - **`--log`**: Modalità solo log. Non traduce con l'IA; registra invece i blocchi che richiedono attenzione (con numeri di riga e contenuto) per i locali base e target, per aiutare un altro agente a generare le traduzioni.
 
-  > Esempio: `npx intlayer doc review --log`
+- **BLOCK 1 of 3** (il contenuto in English)
+- **BLOCK 2 of 3** (il contenuto in Italian da auditare)
+- **BLOCK 3 of 3** (la modalità: `apply`, `report`, o `synthesis`)
+
+> Esempio: `npx intlayer doc review --mode report`
+
+> Esempio: `npx intlayer doc review --log`
+
+Qualunque sia la modalità, l'esecuzione termina con una sintesi che elenca i documenti allineati con il loro documento base e quelli che hanno ancora blocchi da modificare.
 
 **Opzioni di output delle voci:**
 

package/docs/it/cli/fill.md

@@ -39,14 +39,6 @@ bun x intlayer fill
 
 Questo comando analizza i tuoi file di dichiarazione dei contenuti per potenziali problemi come traduzioni mancanti, incoerenze strutturali o discrepanze di tipo. Se trova problemi, **intlayer fill** proporrà o applicherà aggiornamenti per mantenere i tuoi dizionari coerenti e completi.
 
-Punti chiave:
-
-- Divide i file JSON grandi in parti per rimanere entro i limiti della finestra di contesto del modello AI.
-- Riprova la traduzione se il formato di output è errato.
-- Incorpora il contesto specifico dell'applicazione e del file per migliorare l'accuratezza della traduzione.
-- Preserva le traduzioni esistenti non sovrascrivendole.
-- Elabora file, parti e locali in parallelo utilizzando un sistema di code per aumentare la velocità.
-
 ## Punti Chiave:
 
 - Divide i file JSON di grandi dimensioni in chunk per rispettare i limiti della finestra di contesto del modello di IA.

package/docs/it/cli/index.md

@@ -127,6 +127,8 @@ Per vedere come configurare le lingue disponibili o altri parametri, fai riferim
 
 - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/login.md)** - Autenticati con l'Intlayer CMS e ottieni le credenziali di accesso
 
+> `intlayer login` rilascia una **chiave di accesso** (`clientId` / `clientSecret`) che ogni comando autenticato utilizza. Il secret è una credenziale lato server e non raggiunge mai il tuo client bundle — vedi [Keeping the access key safe](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/login.md#keeping-the-access-key-safe).
+
 ### Comandi principali
 
 - **[Costruisci Dizionari](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/build.md)** - Costruisci i tuoi dizionari dai file di dichiarazione dei contenuti

package/docs/it/cli/list_projects.md

@@ -52,8 +52,6 @@ Questo comando cerca ed elenca tutti i progetti Intlayer trovando le directory c
 
   > Esempio: `npx intlayer projects list --base-dir /path/to/workspace`
 
-  > Esempio: `npx intlayer projects list --base-dir /path/to/workspace`
-
 - **`--git-root`**: Effettua la ricerca dalla root del repository git invece che dalla directory base. Questo è utile per trovare tutti i progetti Intlayer in un monorepo o in un repository git.
 
   > Esempio: `npx intlayer projects list --git-root`

package/docs/it/cli/login.md

@@ -118,6 +118,34 @@ INTLAYER_CLIENT_SECRET=your_client_secret
 }
 ```
 
+## Mantenere la chiave di accesso al sicuro
+
+`intlayer login` rilascia una **chiave di accesso**: una coppia `clientId` / `clientSecret` che ogni comando autenticato (`push`, `pull`, `fill`, `configuration push`, `live`, …) utilizza per autenticarsi.
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+};
+
+export default config;
+```
+
+> **`clientSecret` è una credenziale lato server.** Concede accesso API completo nell'ambito del progetto — lettura e scrittura dei tuoi dizionari, del tuo progetto e della tua organizzazione. Conservala in `.env` (ignorato da git) o nel tuo archivio di secret CI, e non inserirla mai inline nel file di configurazione.
+
+Intlayer lo applica piuttosto che solo documentarlo:
+
+- `clientSecret` è **rimossa dalla configurazione che il tuo bundler incorpora**, quindi non può raggiungere un bundle del browser indipendentemente dall'integrazione del framework che utilizzi. Viene letta solo lato server, a runtime, dall'ambiente.
+- `clientId` è diverso: è la **chiave pubblica** del progetto, sicura da distribuire, ed è utilizzato da [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/analytics.md#how-events-are-authenticated) per ottenere un token di breve durata, solo per l'inserimento.
+
+Commentare `clientId` è sufficiente per disabilitare ogni comportamento autenticato — recupero di dizionari remoti, accesso CMS, analytics — anche quando le variabili di ambiente sono ancora definite.
+
+Per le pipeline CI, preferisci il comando [`ci`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/ci.md), che inietta le credenziali per la durata di una singola esecuzione invece di farle persistere.
+
 ## Configurazione Manuale
 
 Se il browser non si apre automaticamente, puoi visitare manualmente l'URL mostrato nel terminale.

package/docs/it/cli/watch.md

@@ -48,5 +48,3 @@ Questo comando è l'equivalente di `npx intlayer build --watch --skip-prepare`.
 - **`--with`**: Avvia un comando in parallelo con l'osservazione.
 
   > Esempio: `npx intlayer watch --with "next dev --turbopack"`
-
-  > Esempio: `npx intlayer watch --with "next dev --turbopack"`

package/docs/it/compiler.md

@@ -40,6 +40,12 @@ Il **Intlayer Compiler** è uno strumento potente progettato per automatizzare i
 
 ## Perché Usare Intlayer Compiler?
 
+- **Automation**: Elimina la necessità di copiare manualmente i contenuti nei dizionari.
+
+- **Speed**: Estrazione ottimizzata dei contenuti per garantire che il tuo processo di build rimanga veloce.
+
+- **Developer Experience**: Mantieni le dichiarazioni di contenuto esattamente dove vengono utilizzate, migliorando la manutenibilità.
+
 - **Automazione**: Elimina il copia-incolla manuale dei contenuti nei dizionari.
 - **Velocità**: Estrazione dei contenuti ottimizzata per garantire che il processo di build rimanga veloce.
 - **Esperienza Sviluppatore**: Mantieni le dichiarazioni di contenuto esattamente dove vengono utilizzate, migliorando la manutenibilità.
@@ -54,6 +60,8 @@ Sebbene il compiler offra un'esperienza eccellente "funziona subito", introduce
 - **Ambiguità euristica**: Il compiler deve indovinare cosa è contenuto orientato all'utente rispetto alla logica dell'applicazione (ad esempio, `className="active"`, codici di stato, ID prodotto). In codebase complesse, questo può portare a falsi positivi o stringhe mancate che richiedono annotazioni manuali ed eccezioni.
 - **Estrazione solo statica**: L'estrazione basata sul compiler si basa sull'analisi statica. Le stringhe che esistono solo in fase di esecuzione (codici di errore API, campi CMS, ecc.) non possono essere scoperte o tradotte dal compiler da solo, quindi hai ancora bisogno di una strategia i18n di runtime complementare.
 
+- **Estrazione statica esclusivamente**: L'estrazione basata su compiler si affida all'analisi statica. Le stringhe che esistono solo a runtime (codici di errore API, campi CMS, ecc.) non possono essere scoperte o tradotte dal compiler da solo, quindi hai ancora bisogno di una strategia i18n complementare a runtime.
+
 Per un confronto architetturale più approfondito, consulta il post sul blog [Compiler vs. Declarative i18n](https://github.com/aymericzip/intlayer/blob/main/docs/blog/it/compiler_vs_declarative_i18n.md).
 
 Come alternativa, per automatizzare il tuo processo i18n mantenendo il pieno controllo del tuo contenuto, Intlayer fornisce anche un comando di auto-estrazione `intlayer extract` (vedi [documentazione CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/extract.md)), o il comando `Intlayer: extract content to Dictionary` dall'estensione Intlayer VS Code (vedi [documentazione estensione VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/vs_code_extension.md)).
@@ -94,12 +102,18 @@ export default defineConfig({
 });
 ```
 
+> Il plugin standalone `intlayerCompiler()` è ancora esportato per configurazioni avanzate. Registrarlo insieme a `intlayer()` è sicuro — il compilatore si deduplica automaticamente ed esegue una sola volta.
+
 See complete tutorial: [Intlayer Compiler with Vite+React](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_vite+react_compiler.md)
 
 #### Supporto per Framework
 
 Il plugin Vite rileva e gestisce automaticamente diversi tipi di file:
 
+- **React / JSX / TSX**: Gestiti nativamente.
+
+- **Vue**: Richiede `@intlayer/vue-compiler`.
+
 - **React / JSX / TSX**: Gestito nativamente.
 - **Vue**: Richiede `@intlayer/vue-compiler`.
 - **Svelte**: Richiede `@intlayer/svelte-compiler`.