@intlayer/docs 8.12.5-canary.0 → 9.0.0-canary.11

package/docs/it/self_hosting.md

@@ -0,0 +1,349 @@
+---
+createdAt: 2026-06-30
+updatedAt: 2026-06-30
+title: Self-Hosting Intlayer
+description: Esegui un'istanza Intlayer completa sulla tua infrastruttura con un singolo comando. Non è richiesto alcun account Intlayer Cloud.
+keywords:
+  - Self-Hosting
+  - Docker
+  - Docker Compose
+  - Intlayer
+  - CMS
+  - Installation
+  - Infrastructure
+slugs:
+  - doc
+  - self-hosting
+author: aymericzip
+---
+
+# Self-Hosting Intlayer
+
+Intlayer può essere eseguito interamente sulla tua infrastruttura — non è richiesto alcun account Intlayer Cloud. Un singolo comando avvia uno stack pronto per la produzione:
+
+```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`.
+
+## Indice dei Contenuti
+
+<TOC/>
+
+---
+
+## Architettura
+
+```
+                ┌─────────────────────────────┐
+ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐
+                └─────────────────────────────┘   │ VITE_BACKEND_URL
+                ┌─────────────────────────────┐   │
+                │  backend (Fastify/Bun)  :3100│ ◀─┘
+                └──────────────┬──────────────┘
+          ┌──────────┬─────────┼──────────┬───────────┐
+          ▼          ▼         ▼          ▼           ▼
+     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium
+     (1-node RS)             (S3 API)     (SMTP)        (in-image)
+                             minio:9001   mailpit:8025
+                             (console)    (web UI)
+```
+
+Chromium (utilizzato per la generazione di screenshot con Puppeteer) è incluso nell'immagine del backend — non è necessario un container separato.
+
+---
+
+## Prerequisiti
+
+- **Docker** ≥ 24 e **Docker Compose** ≥ v2. Se uno dei due manca, l'installer stampa il link di installazione ed esce.
+- Porte `3000`, `3100`, `8025`, `9000` e `9001` disponibili sull'host.
+- Un host Linux o macOS (o WSL2 su Windows).
+
+---
+
+## Avvio rapido
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | sh
+```
+
+Cosa fa l'installer:
+
+1.  Verifica che `docker` e `docker compose` siano presenti.
+2.  Scarica `docker-compose.yml` e `.env.example` in `./intlayer/`.
+3.  Se non esiste un `.env`, copia l'esempio e genera segreti casuali per `BETTER_AUTH_SECRET`, `S3_ACCESS_KEY_ID` e `S3_SECRET_ACCESS_KEY` tramite `openssl rand`.
+4.  Esegue `docker compose pull` + `docker compose up -d`.
+5.  Stampa gli URL: dashboard `:3000`, API `:3100`, interfaccia utente email `:8025`, console MinIO `:9001`.
+
+Dopo che lo stack è attivo, apri **http://localhost:3000** e crea il tuo primo account.
+
+---
+
+## Servizi
+
+| Servizio    | Immagine                             | Porta/e host                   | Scopo                                                         |
+| ----------- | ------------------------------------ | ------------------------------ | ------------------------------------------------------------- |
+| **app**     | built from `apps/app/Dockerfile`     | `3000`                         | Dashboard TanStack Start (UI del CMS)                         |
+| **backend** | built from `apps/backend/Dockerfile` | `3100`                         | API REST Fastify (endpoint `/health`)                         |
+| **mongo**   | `mongo:7`                            | internal                       | Replica set a nodo singolo (`rs0`)                            |
+| **redis**   | `redis:7-alpine`                     | internal                       | Code di lavoro (BullMQ) e caching (ioredis)                   |
+| **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`.
+
+---
+
+## Variabili d'ambiente
+
+L'installer genera un `.env` pronto all'uso. La tabella seguente descrive ogni variabile.
+
+### Obbligatorie (generate automaticamente o richieste)
+
+| Variabile              | Esempio                                         | Descrizione                                                             |
+| ---------------------- | ----------------------------------------------- | ----------------------------------------------------------------------- |
+| `NODE_ENV`             | `production`                                    | Ambiente di runtime                                                     |
+| `PORT`                 | `3100`                                          | Porta di ascolto del backend                                            |
+| `BACKEND_URL`          | `http://localhost:3100`                         | URL pubblico dell'API del backend                                       |
+| `APP_URL`              | `http://localhost:3000`                         | URL pubblico della dashboard                                            |
+| `DOMAIN`               | `localhost`                                     | Dominio del cookie                                                      |
+| `MONGODB_URI`          | `mongodb://mongo:27017/intlayer?replicaSet=rs0` | URI di connessione completo di MongoDB                                  |
+| `REDIS_URL`            | `redis://redis:6379`                            | URL di connessione di Redis                                             |
+| `BETTER_AUTH_SECRET`   | _(generated)_                                   | Segreto di 32 byte per la firma della sessione                          |
+| `MAIL_PROVIDER`        | `smtp`                                          | Trasporto email: `smtp` o `resend`                                      |
+| `MAIL_SMTP_HOST`       | `mailpit`                                       | Hostname SMTP (nome del container Mailpit)                              |
+| `MAIL_SMTP_PORT`       | `1025`                                          | Porta SMTP                                                              |
+| `MAIL_FROM`            | `Intlayer <no-reply@localhost>`                 | Indirizzo del mittente                                                  |
+| `S3_ENDPOINT`          | `http://minio:9000`                             | Endpoint compatibile con S3                                             |
+| `S3_PUBLIC_URL`        | `http://localhost:9000/intlayer`                | URL pubblico per il caricamento degli asset del browser                 |
+| `S3_BUCKET_NAME`       | `intlayer`                                      | Nome del bucket                                                         |
+| `S3_ACCESS_KEY_ID`     | _(generated)_                                   | Chiave di accesso MinIO                                                 |
+| `S3_SECRET_ACCESS_KEY` | _(generated)_                                   | Chiave segreta MinIO                                                    |
+| `VITE_BACKEND_URL`     | `http://localhost:3100`                         | URL del backend integrato nella dashboard al momento della compilazione |
+| `VITE_DOMAIN`          | `localhost`                                     | Dominio integrato nella dashboard al momento della compilazione         |
+
+### Opzionali (le funzionalità degradano elegantemente se assenti)
+
+| Variabile                                                | Funzionalità                                                              |
+| -------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`                                         | Traduzione assistita da AI e audit del contenuto                          |
+| `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`, `STRIPE_*` | Gestione della fatturazione e degli abbonamenti                           |
+| `RESEND_API_KEY`                                         | Email transazionali tramite Resend (sostituisce Mailpit quando impostato) |
+| `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET`               | Accesso OAuth di GitHub                                                   |
+| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`               | Accesso OAuth di Google                                                   |
+| `GITLAB_CLIENT_ID`, `GITLAB_CLIENT_SECRET`               | Accesso OAuth di GitLab                                                   |
+| `MICROSOFT_CLIENT_ID`, `MICROSOFT_CLIENT_SECRET`         | Accesso OAuth di Microsoft                                                |
+| `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | Accesso OAuth di LinkedIn                                                 |
+| `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Accesso OAuth di Atlassian                                                |
+
+---
+
+## Collegamento del tuo progetto Intlayer
+
+Una volta che lo stack è in esecuzione, punta il tuo progetto al backend e alla dashboard self-hosted invece di `intlayer.org`.
+
+### Configurazione del progetto
+
+```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,
+
+    /**
+     * URL della dashboard CMS self-hosted.
+     * Predefinito: https://app.intlayer.org
+     */
+    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000
+
+    /**
+     * URL dell'API del backend self-hosted.
+     * Predefinito: https://back.intlayer.org
+     */
+    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
+  },
+};
+
+export default config;
+```
+
+Imposta le variabili d'ambiente nel `.env` del tuo progetto:
+
+```sh
+INTLAYER_CMS_URL=http://localhost:3000
+INTLAYER_BACKEND_URL=http://localhost:3100
+INTLAYER_CLIENT_ID=<your-client-id>
+INTLAYER_CLIENT_SECRET=<your-client-secret>
+```
+
+Crea le credenziali di accesso nella tua dashboard self-hosted sotto **Progetti → Chiavi di accesso** all'indirizzo `http://localhost:3000/projects`.
+
+### SDK `@intlayer/api`
+
+Quando si utilizza l'SDK `@intlayer/api` in modo programmatico, passa `backendURL` esplicitamente:
+
+```typescript fileName="cms.ts" codeFormat="typescript"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+const cms = createIntlayerCMS({
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100
+  },
+});
+
+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
+```
+
+---
+
+## Backup e ripristino
+
+Tutti i dati persistenti risiedono in tre volumi Docker nominati.
+
+### Backup
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/mongo-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_redis-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/redis-data.tar.gz /data
+
+docker run --rm \
+  -v intlayer_minio-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar czf /backup/minio-data.tar.gz /data
+```
+
+### Ripristino
+
+```sh
+docker run --rm \
+  -v intlayer_mongo-data:/data \
+  -v "$(pwd)":/backup \
+  busybox tar xzf /backup/mongo-data.tar.gz -C /
+
+# Ripetere per redis-data e minio-data
+```
+
+---
+
+## Utilizzo di un reverse proxy (Nginx / Caddy)
+
+Per le implementazioni in produzione, posiziona un reverse proxy davanti ai container dell'app e del backend invece di esporli direttamente.
+
+### Esempio Nginx
+
+```nginx
+server {
+    listen 80;
+    server_name cms.example.com;
+
+    location / {
+        proxy_pass http://localhost:3000;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+
+server {
+    listen 80;
+    server_name api.example.com;
+
+    location / {
+        proxy_pass http://localhost:3100;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+Aggiorna le seguenti variabili `.env` per corrispondere ai tuoi domini pubblici:
+
+```sh
+BACKEND_URL=https://api.example.com
+APP_URL=https://cms.example.com
+DOMAIN=example.com
+VITE_BACKEND_URL=https://api.example.com
+VITE_DOMAIN=example.com
+```
+
+> Le variabili `VITE_*` sono integrate nell'immagine della dashboard al momento della compilazione. Se le modifichi dopo che l'immagine è stata compilata, devi ricostruire l'immagine `app` (`docker compose build app`) o utilizzare l'iniezione della configurazione a runtime.
+
+---
+
+## Risoluzione dei problemi
+
+### Il backend si riavvia in loop al primo avvio
+
+MongoDB e Redis devono essere sani prima che il backend si avvii. Il file compose utilizza `depends_on` con `condition: service_healthy`. Se vedi ripetuti riavvii del backend, verifica che i controlli di integrità di `mongo` e `redis` passino:
+
+```sh
+docker compose ps
+docker compose logs mongo
+docker compose logs redis
+```
+
+### 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
+```
+
+### Email non inviate
+
+Per impostazione predefinita, tutte le email in uscita vengono catturate da Mailpit. Apri `http://localhost:8025` per vedere i messaggi inviati. Per inviare email reali, imposta `MAIL_PROVIDER=resend` e `RESEND_API_KEY=<la-tua-chiave>` in `.env`, quindi riavvia il backend:
+
+```sh
+docker compose restart backend
+```
+
+### 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:
+
+```sh
+docker compose run --rm minio-init
+```
+
+---
+
+## Link utili
+
+- [Documentazione Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+- [Riferimento alla configurazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md)
+- [SDK CMS — `@intlayer/api`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md#programmatic-access-con-l-sdk-intlayerapi)

package/docs/ja/CI_CD.md

@@ -30,6 +30,10 @@ Intlayer は、コンテンツ宣言ファイルの翻訳を自動生成する
 
 Intlayer を使用すると、ローカルでは単一のロケールのみを宣言し、すべての翻訳は CMS を通じてリモートで管理するワークフローを採用できます。これにより、コンテンツと翻訳がコードベースから完全に切り離され、コンテンツ編集者にとってより柔軟性が提供され、ホットコンテンツリロード（変更を適用するためにアプリケーションを再ビルドする必要なし）が可能になります。
 
+## CMSを使用する
+
+Intlayerを使用すると、単一のロケールのみをローカルで宣言し、すべての翻訳をCMSを介してリモートで管理するワークフローを採用できます。これにより、コンテンツと翻訳をコードベースから完全に分離でき、コンテンツエディターに対しより高い柔軟性を提供し、Live Sync（アプリケーションを再構築することなく変更を適用）を有効にします。
+
 ### 設定例
 
 ```ts fileName="intlayer.config.ts"

package/docs/ja/autoFill.md

@@ -28,6 +28,53 @@ history:
 author: aymericzip
 ---
 
+# コンテンツ宣言ファイルの翻訳を自動入力
+
+**CI でのコンテンツ宣言ファイルの自動入力**は、開発ワークフローを高速化する方法です。
+
+## 動作の理解
+
+`fill` コマンドには2つのモードがあります：
+
+- **Complete**: 各ロケールのすべての欠落コンテンツを自動的に入力し、現在のファイルまたは指定された別のファイルを編集します。つまり、完全モードは既に翻訳されている既存コンテンツのスキップします。
+- **Review**: 各ロケールのすべてのコンテンツを自動的に入力し、特定のファイルまたは指定された別のファイルを生成します。
+
+`fill` コマンドはすべてのロケールコンテンツ宣言ファイルを処理します。つまり、CMSからのリモートコンテンツは処理しません。CMSは独自の翻訳管理を含んでいます。
+`@intlayer/sync-json-plugin` などのプラグインを使用する場合、Intlayerはこれらのファイルをロケールコンテンツ宣言ファイルに変換します。つまり、これらのファイルは `fill` コマンドによって処理されます。
+
+新しく生成されたファイルには、辞書メタデータとして `filled` 命令が含まれています。この命令は、Intlayerがファイルが自動入力されたかどうかを判定し、存在する場合はこのファイルを再度翻訳の対象からスキップするために使用されます。
+
+Intlayerは自動入力に関して以下の命令を考慮します：
+
+- `.content.{ts|js|json}` ファイルから → `fill` 命令
+- 設定ファイル `.intlayer.config.ts` から → `dictionary.fill` 命令
+- それ以外の場合はデフォルトで `true` に設定されます
+
+ロケール固有のコンテンツ宣言ファイルの場合、`true` 命令は `./{{fileName}}.fill.content.json` に置き換えられます。これは、ロケール固有のコンテンツ宣言ファイルが追加のローカライズされたコンテンツを受け取ることができないためです。そのため、既存のファイルを上書きしないために新しいファイルを生成します。
+
+## デフォルト動作
+
+デフォルトでは、`fill`はグローバルに`true`に設定されています。これは、Intlayerがすべてのコンテンツファイルを自動的に入力し、ファイル自体を編集することを意味します。この動作は、いくつかの方法でカスタマイズできます。
+
+### グローバル設定オプション
+
+1. **`fill: true` (デフォルト)** - すべてのロケールを自動的に埋め、現在のファイルを編集します
+2. **`fill: false`** - このコンテンツファイルの自動埋めを無効にします
+3. **`fill: "./relative/path/to/file"`** - 現在のファイルを編集せずに指定されたファイルを作成/更新します。相対パスは現在のファイルの場所に基づいて解決されます
+4. **`fill: "/absolute/path/to/file"`** - 現在のファイルを編集せずに指定されたファイルを作成/更新します。相対パスは基本ディレクトリの場所に基づいて解決されます（設定ファイル `.intlayer.config.ts` の `baseDir` フィールド）
+5. **`fill: "C:\\absolute\path\to\file"`** - 現在のファイルを編集せずに指定されたファイルを作成/更新します。絶対パスはお使いのオペレーティングシステムに基づいて解決されます
+6. **`fill: { [key in Locales]?: string }`** - 各ロケールについて指定されたファイルを作成/更新します
+
+### v7 の動作変更
+
+v7 では、`fill` コマンドの動作が更新されました：
+
+- **`fill: true`** - 現在のファイルを全ロケールの埋め込みコンテンツで上書きします
+- **`fill: "path/to/file"`** - 指定されたファイルを埋め込みますが、現在のファイルは変更しません
+- **`fill: false`** - 自動埋め込みを完全に無効にします
+
+別のファイルに書き込むためのパスオプションを使用する場合、埋め込みメカニズムはコンテンツ宣言ファイル間の _マスター・スレーブ_ 関係を通じて機能します。メインファイル（マスター）が情報源として機能し、更新されると、Intlayer はパスで指定されたスレーブの宣言ファイルに変更を自動的に適用します。
+
 # 自動入力コンテンツ宣言ファイルの翻訳
 
 **自動入力コンテンツ宣言ファイル**は、開発ワークフローを高速化する方法です。
@@ -88,6 +135,40 @@ Intlayer は、メインファイルにまだ宣言されていないすべて
 
 その後、両方の宣言ファイルは単一の辞書にマージされ、標準の `useIntlayer("example")` フック（React）/ コンポーザブル（Vue）を使ってアクセス可能になります。
 
+## グローバル設定
+
+`intlayer.config.ts` ファイルでグローバル自動入力設定を構成できます。
+
+```ts fileName="intlayer.config.ts"
+import { type IntlayerConfig, Locales } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
+  },
+  dictionary: {
+    // すべての辞書に対して欠落している翻訳を自動生成します
+    fill: "./{{fileName}}Filled.content.ts",
+    //
+    // fill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
+    //
+    // fill: true, // "./{{fileName}}.content.json" を使用しているようなすべての辞書に対して欠落している翻訳を自動生成します
+    //
+    // fill: {
+    //   en: "./{{fileName}}.en.content.json",
+    //   fr: "./{{fileName}}.fr.content.json",
+    //   es: "./{{fileName}}.es.content.json",
+    // },
+  },
+};
+
+export default config;
+```
+
+コンテンツファイルの `fill` フィールドを使用して、辞書ごとに細かく調整することもできます。Intlayer は最初に辞書ごとの設定を検討し、その後グローバル設定にフォールバックします。
+
 ## 自動補完されたファイル形式
 
 自動補完された宣言ファイルに推奨される形式は **JSON** であり、これによりフォーマットの制約を回避できます。ただし、Intlayer は `.ts`、`.js`、`.mjs`、`.cjs` などの他の形式もサポートしています。

package/docs/ja/benchmark/solid.md

@@ -118,6 +118,28 @@ i18nリークの問題を素早く特定するために、無料のスキャナ
 - **名前空間付き静的（Scoped static）**: 複雑な追加リクエストなしで、コードを整理（論理的分離）した状態に保つ。
 - **名前空間付き動的（Scoped dynamic）**: コード分割とパフォーマンスのための最善のアプローチ。現在のビューとアクティブなロケールに必要なものだけをロードし、メモリ使用量を最小限に抑える。
 
+### 測定内容:
+
+実際のブラウザで各スタック向けに同じ多言語アプリを実行し、実際にどのようなデータが送信されたか、処理にどのくらい時間がかかったかを記録しました。サイズは**通常のウェブ圧縮後**に報告されています。これは生のソースコードのサイズよりも、実際にユーザーがダウンロードするものに近いためです。
+
+- **国際化ライブラリサイズ**: バンドリング、ツリーシェイキング、およびミニフィケーション後、i18nライブラリのサイズは、空のコンポーネント内のプロバイダー + フック/プリミティブコードのサイズです。翻訳ファイルの読み込みは含まれていません。コンテンツが入る前に、ライブラリがどのくらい高コストかを示します。
+
+- **ページごとのJavaScript**: 各ベンチマークルートについて、そのアクセス時にブラウザが引き込むスクリプトの量。スイート内のページ間で平均化されます（レポートがロールアップする場合はロケール間でも）。ヘビーページは遅いページです。
+
+- **他のロケールからのリーク**: 監査対象ページで誤って読み込まれるはずの、別の言語の同じページのコンテンツです。このコンテンツは不要であり、回避すべきです。（例: `/en/about`ページバンドル内の`/fr/about`ページコンテンツ）
+
+- **他のルートからのリーク**: **他の画面**についても同じ考え方です。1つのページを開いたときに、その他のページのコピーが一緒に読み込まれるかどうかです。（例: `/en/contact`ページバンドル内の`/en/about`ページコンテンツ）。スコアが高いことは、弱い分割またはバンドルが過度に広いことを示唆しています。
+
+- **平均コンポーネントバンドルサイズ**: 一般的なUIピースは、1つの巨大なアプリ番号の内部に隠れるのではなく、**1つずつ**測定されます。国際化が日常的なコンポーネントを静かに膨張させているかどうかを示します。例えば、コンポーネントが再レンダリングされる場合、メモリからすべてのデータを読み込みます。巨大なJSONを任意のコンポーネントに添付することは、コンポーネントのパフォーマンスを低下させる大量の未使用データを接続するようなものです。
+
+- **言語切り替えの応答性**: アプリ自身のコントロールを使って言語を切り替え、ページが明確に切り替わるまでにかかる時間を測定します。これは実験室のマイクロステップではなく、訪問者が気付くものです。
+
+- **言語変更後のレンダリング作業**: より狭いフォローアップです。切り替えが実行されている間に、新しい言語のために、インターフェイスの再描画にどのくらいの労力がかかったかです。「感じられた」時間とフレームワークのコストが異なる場合に役立ちます。
+
+- **初期ページ読み込み時間**: ナビゲーションからブラウザがテストしたシナリオのページが完全に読み込まれたと判断するまで。コールドスタートの比較に適しています。
+
+- **ハイドレーション時間**: アプリがそれを公開する場合、クライアントがサーバーHTMLを実際にクリック可能な状態に変えるのにかかる時間です。表の中のダッシュは、その実装がこのベンチマークで信頼できるハイドレーション数値を提供しなかったことを意味します。
+
 ## GitHubのスター
 
 GitHubのスターは、プロジェクトの普及度、コミュニティの信頼、および長期的な関連性を示す強力な指標です。技術的な品質を直接測定するものではありませんが、どれだけの開発者がプロジェクトを有用だと感じ、その進捗をフォローし、採用する可能性があるかを反映しています。プロジェクトの価値を見積もる際、スターは代替案との勢いの比較を助け、エコシステムの成長に関する洞察を提供します。

package/docs/ja/benchmark/svelte.md

@@ -116,6 +116,28 @@ i18nリークの問題を素早く特定するために、無料のスキャナ
 - **名前空間付き静的（Scoped static）**: 複雑な追加リクエストなしで、コードを整理（論理的分離）した状態に保つ。
 - **名前空間付き動的（Scoped dynamic）**: コード分割とパフォーマンスのための最善のアプローチ。現在のビューとアクティブなロケールに必要なものだけをロードし、メモリ使用量を最小限に抑える。
 
+### 測定内容：
+
+実際のブラウザで各スタックの同じ多言語アプリを実行し、実際にネットワークに送信されたものと処理時間を記録しました。サイズは**通常のウェブ圧縮後**に報告されています。これはユーザーがダウンロードする実際のサイズに近いため、生のソースコード数よりも適切です。
+
+- **国際化ライブラリのサイズ**: バンドリング、ツリーシェイキング、ミニフィケーション後の i18n ライブラリのサイズは、空のコンポーネント内のプロバイダー + ストアコードのサイズです。翻訳ファイルの読み込みは含まれていません。これはコンテンツが含まれる前にライブラリにかかるコストを示します。
+
+- **ページごとの JavaScript**: 各ベンチマークルートについて、そのアクセス時にブラウザが取得するスクリプトの量。スイート内のページとロケール全体で平均化されています（レポートにまとめられている場合）。重いページは遅いページです。
+
+- **他のロケールからのリーク**: 監査対象ページに誤って読み込まれる、別の言語での同じページのコンテンツです。このコンテンツは不要であり、避けるべきです。（例：`/en/about` ページバンドル内の `/fr/about` ページコンテンツ）
+
+- **他のルートからのリーク**: **他の画面**についても同じ考え方です。1 つのページを開いただけなのに、そのコピーが一緒に読み込まれるかどうかです。（例：`/en/contact` ページバンドル内の `/en/about` ページコンテンツ）。高いスコアは分割が弱いか、バンドルが広すぎることを示唆しています。
+
+- **コンポーネントバンドルサイズの平均**: 一般的な UI パーツは 1 つずつ測定され、1 つの巨大なアプリ数に隠れていません。これは国際化がいかに日常的なコンポーネントを静かに膨張させるかを示しています。例えば、コンポーネントが再レンダリングされる場合、メモリからそのすべてのデータを読み込みます。巨大な JSON をコンポーネントに接続することは、コンポーネントのパフォーマンスを低下させる大量の未使用データストアに接続するようなものです。
+
+- **言語切り替えの応答性**: アプリの独自のコントロールを使用して言語を切り替え、ページが明らかに切り替わるまでにかかる時間を計測します。これは訪問者が気付く、ラボのマイクロステップではありません。
+
+- **言語変更後のレンダリング作業**: より狭い範囲のフォローアップです。スイッチが実行中になった後、新しい言語に対して再描画するためにインターフェースがどれだけの労力を費やしたかです。「体感」時間とフレームワークのコストが異なる場合に役立ちます。
+
+- **初期ページ読み込み時間**: ナビゲーションからブラウザがテストシナリオのページが完全に読み込まれたと判断するまで。コールドスタートを比較するのに最適です。
+
+- **ハイドレーション時間**: アプリが公開している場合、クライアントがサーバー HTML を実際にクリックできるものに変える際にかかる時間です。テーブル内のダッシュは、その実装がこのベンチマークで信頼できるハイドレーション数値を提供しなかったことを意味します。
+
 ## GitHubのスター
 
 GitHubのスターは、プロジェクトの普及度、コミュニティの信頼、および長期的な関連性を示す強力な指標です。技術的な品質を直接測定するものではありませんが、どれだけの開発者がプロジェクトを有用だと感じ、その進捗をフォローし、採用する可能性があるかを反映しています。プロジェクトの価値を見積もる際、スターは代替案との勢いの比較を助け、エコシステムの成長に関する洞察を提供します。

package/docs/ja/benchmark/tanstack.md

@@ -124,6 +124,28 @@ i18nのリーク問題を素早く特定するために、無料のスキャナ
 - **Scoped static**: 複雑な追加ネットワークリクエストなしで、コードを整理（論理的な分離）できる。
 - **Scoped dynamic**: コード分割とパフォーマンスにおいて最良のアプローチ。現在のビューとアクティブなロケールが必要なものだけをロードすることで、メモリ使用量を最小限に抑える。
 
+### 測定内容:
+
+私は、すべてのスタックに対して同じ多言語アプリを実際のブラウザで実行し、実際にネットワークを通じて何が表示されたか、どのくらい時間がかかったかを記録しました。サイズは**通常のウェブ圧縮後**に報告されています。これは生ソースコード数よりも、人々が実際にダウンロードするものに近いためです。
+
+- **国際化ライブラリサイズ**: バンドリング、ツリーシェイキング、ミニファイ後の i18n ライブラリのサイズは、空のコンポーネント内のプロバイダー（例：`NextIntlClientProvider`）+ フック（例：`useTranslations`）コードのサイズです。翻訳ファイルの読み込みは含まれません。これにより、コンテンツが入る前にライブラリがどの程度コストがかかるかが分かります。
+
+- **ページごとの JavaScript**: 各ベンチマークルートについて、その訪問時にブラウザが取得するスクリプトの量を、スイート内のページ全体にわたり、またレポートがロールアップする場所のロケール全体にわたって平均化したものです。重いページは遅いページです。
+
+- **他のロケールからのリーク**: 同じページであっても、別の言語であり、監査されたページに誤って読み込まれるコンテンツです。このコンテンツは不要であり、回避する必要があります。（例：`/en/about` ページバンドルの `/fr/about` ページコンテンツ）
+
+- **他のルートからのリーク**: アプリ内の**他の画面**についても同じ考え方です。1 つのページのみを開いたときに、そのコピーが一緒に読み込まれるかどうかです。（例：`/en/contact` ページバンドルの `/en/about` ページコンテンツ）。スコアが高い場合は、分割が弱いか、バンドルが過度に広いことを示唆しています。
+
+- **平均コンポーネントバンドルサイズ**: 一般的な UI コンポーネントは、1 つの巨大なアプリ番号内に隠れるのではなく、**1 つずつ**測定されます。国際化が日常的なコンポーネントを静かに膨張させているかどうかを示します。例えば、コンポーネントが再レンダリングされる場合、メモリからすべてのデータを読み込みます。巨大な JSON をコンポーネントに添付することは、コンポーネントのパフォーマンスを低下させる、使用されていない大量のデータストアに接続するようなものです。
+
+- **言語切り替えレスポンシビティ**: アプリ独自の制御を使用して言語を切り替え、ページが明確に切り替わるまでにかかる時間を計測します。訪問者が気付くこと、ラボの微視的なステップではありません。
+
+- **言語変更後のレンダリング作業**: より狭い追跡です。スイッチが実行中になった後、新しい言語のために、インターフェイスが再描画するのに要した努力がどの程度であるかです。「感じられた」時間とフレームワークコストが異なる場合に役立ちます。
+
+- **初期ページロード時間**: ナビゲーションから、テストしたシナリオについてページが完全に読み込まれたと見なすブラウザまで。コールドスタートを比較するのに適しています。
+
+- **ハイドレーション時間**: アプリが公開している場合、クライアントがサーバー HTML を実際にクリックできるものに変換するのにかかる時間です。テーブルのダッシュ記号は、その実装がこのベンチマークで信頼性の高いハイドレーション数値を提供しなかったことを意味します。
+
 ## GitHubのスター
 
 GitHubのスターは、プロジェクトの普及度、コミュニティの信頼、および長期的な関連性を示す強力な指標です。技術的な品質を直接測定するものではありませんが、どれだけの開発者がプロジェクトを有用だと感じ、その進捗をフォローし、採用する可能性があるかを反映しています。プロジェクトの価値を見積もる際、スターは代替案との勢いの比較を助け、エコシステムの成長に関する洞察を提供します。

package/docs/ja/cli/ci.md

@@ -140,6 +140,28 @@ steps:
     run: npx intlayer ci fill
 ```
 
+## スキャフォルドされた GitHub Actions
+
+`intlayer init` を実行すると、Intlayer はパッケージマネージャー (npm、yarn、pnpm、または bun) を検出し、`.github/workflows/` の下に 2 つの GitHub Actions ワークフローをスキャフォルドします。コマンドはそのパッケージマネージャーに対応します:
+
+- **`intlayer-fill.yml`** — すべてのプルリクエストで、辞書をビルドし `intlayer fill --git-diff --mode complete` を実行して、変更された辞書の欠落している翻訳を生成し、結果を PR ブランチにコミットします。
+- **`intlayer-test.yml`** — すべてのプルリクエストで、辞書をビルドし `intlayer test` を実行し、必要なロケールの翻訳が不足している場合はチェックを失敗させます。
+
+既存のワークフローファイルが上書きされることはありません。スキャフォルディングをスキップするには、以下を実行します:
+
+```bash
+npx intlayer init --no-github-actions
+```
+
+### fill workflowへのAIアクセスの提供
+
+スキャフォルドされた `intlayer-fill.yml` はAIアクセスが必要です。2つのオプションが利用可能です（workflowの `env` ブロックで設定）:
+
+1. **独自のAIプロバイダーキー** — リポジトリ設定（Settings → Secrets and variables → Actions）に `AI_API_KEY` シークレットを追加します。workflowは `--provider`、`--model`、`--api-key` 経由でそれを転送します。
+2. **Intlayer CMSアクセスキー** — `INTLAYER_CLIENT_ID` と `INTLAYER_CLIENT_SECRET` シークレットを追加し、`intlayer.config` の `editor` セクションに接続します。CMSアクセスキーはIntlayer backendを通じてAIアクセスを許可します。
+
+`intlayer-test.yml` workflowはAIアクセスを必要としません。
+
 ## エラーハンドリング
 
 - `INTLAYER_PROJECT_CREDENTIALS`が設定されていない場合、コマンドはエラーで終了します。