@intlayer/docs 9.3.3 → 9.4.0

package/docs/ja/packages/next-intlayer/useIntlayer.md

@@ -77,6 +77,34 @@ Next.js アプリケーションでクライアントサイドコンポーネン
 
 ## Next.jsでの使用例
 
+`useIntlayer` フックを Next.js ページ内に実装して、アプリケーションの現在のロケールに基づいて動的にローカライズされたコンテンツを読み込む方法を以下に示します:
+
+<Tabs>
+ <Tab label='Intlayer >=9.4' value='>=9.4'>
+
+```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
+import { ClientComponentExample } from "@components/ClientComponentExample";
+import { ServerComponentExample } from "@components/ServerComponentExample";
+import { type NextPageIntlayer } from "next-intlayer";
+import { useIntlayer } from "next-intlayer";
+import { IntlayerProvider } from "next-intlayer/server";
+
+const HomePage: NextPageIntlayer = async ({ params }) => {
+  const { locale } = await params;
+
+  // ホームページのコンテンツを取得
+  const content = useIntlayer("homepage", locale);
+
+  return (
+    <IntlayerProvider locale={locale}>
+      <p>{content.introduction}</p>
+      <ClientComponentExample />
+      <ServerComponentExample />
+    </IntlayerProvider>
+  );
+};
+```
+
 以下は、Next.jsのページ内で`useIntlayer`フックを実装し、アプリケーションの現在のロケールに基づいてローカライズされたコンテンツを動的に読み込む方法です。
 
 ```tsx fileName="src/pages/[locale]/index.tsx" codeFormat={["typescript", "esm"]}
@@ -104,6 +132,9 @@ const HomePage: NextPageIntlayer = async ({ params }) => {
 };
 ```
 
+ </Tab>
+</Tabs>
+
 ```tsx fileName="src/components/ClientComponentExample.tsx" codeFormat={["typescript", "esm"]}
 "use-client";
 

package/docs/ja/packages/next-intlayer/useLocale.md

@@ -104,6 +104,8 @@ const LocaleSwitcher: FC = () => {
 
 ## 戻り値
 
+`useLocale` フックを呼び出すと、以下のプロパティを含むオブジェクトが返されます:
+
 - **`locale`**: React コンテキストで設定されている現在のロケール。
 - **`defaultLocale`**: 設定で定義された主要なロケール。
 - **`availableLocales`**: 設定で定義された利用可能なすべてのロケールのリスト。

package/docs/ja/packages/react-intlayer/useDictionary.md

@@ -30,8 +30,6 @@ author: aymericzip
 
 ## Reactでの使用例
 
-以下は、Reactコンポーネントで`useDictionary`フックを使用する例です：
-
 ```tsx fileName="./ComponentExample.tsx" codeFormat={["typescript", "esm"]}
 import type { FC } from "react";
 import { useDictionary } from "react-intlayer";

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

@@ -77,6 +77,34 @@ author: aymericzip
 
 Reactコンポーネント内で`useI18n`フックを使用する例：
 
+<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/ja/packages/react-intlayer/useIntlayer.md

@@ -31,48 +31,6 @@ author: aymericzip
 
 ## Reactでの使用例
 
-Reactコンポーネント内での`useIntlayer`フックの使用例：
-
-```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";
-
-const ComponentExample: FC = () => {
-  const content = useIntlayer("component-example");
-
-  return (
-    <div>
-      <h1>{content.title}</h1>
-      <p>{content.description}</p>
-    </div>
-  );
-};
-```
-
 ```tsx fileName="src/components/ServerComponentExample.tsx" codeFormat="typescript"
 import { useIntlayer } from "react-intlayer/server";
 

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

@@ -56,7 +56,7 @@ export default defineConfig({
 2. `build.optimize`が`true`である（または`undefined`であり、ビルド時のデフォルトである`true`になる）。
 3. Intlayer設定で`build.minify`が`true`である。
 
-エディタは完全で人間が読める辞書コンテンツを必要とするため、`editor.enabled`が`true`の場合、プラグインは自動的に**無効**になります。
+`editor.enabled` が `true` の場合、プラグインは引き続き実行されますが、**フィールドのリネームはスキップされます**。リネームはインタープリタが辿るコンテンツキーを書き換えるため、ビジュアルエディタが受け取る `keyPath` が、編集対象であるマージ前の辞書と一致しなくなってしまいます。空白の圧縮とトップレベルのメタデータ削除は引き続き有効です。
 
 ## 圧縮される対象
 

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

@@ -28,6 +28,8 @@ author: aymericzip
 
 `intlayerPrune` Vite プラグインは、アプリケーションのバンドルから未使用の辞書をツリーシェイクおよびプルーニングするために使用します。これにより、必要な多言語コンテンツのみを含めることで、最終的なバンドルサイズを削減できます。
 
+> このプラグインは [`intlayer()`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/packages/vite-intlayer/intlayer.md) を使用する際に、自動的に含まれ設定されます。プラグインスタックを自分で構成する場合にのみ、手動で登録する必要があります。
+
 ## 使用法
 
 ### `intlayer()` の一部として（推奨）
@@ -115,4 +117,4 @@ Pruning が成功すると、`intlayerPrune` は `pruneContext.dictionaryKeyToFi
 2. `build.optimize` が `true` である (または `undefined` で、ビルドではデフォルトで `true`)。
 3. Intlayer の設定で `build.purge` が `true` である。
 
-`editor.enabled` が `true` の場合、エディターが完全な辞書コンテンツを必要とするため、自動的に**無効化**されます。
+`editor.enabled` が `true` の場合でも有効なままです。ビジュアルエディタはマージ前の辞書に対して `dictionaryKey` と `keyPath` を通じて各編集を解決しますが、このプラグインはその辞書に一切触れません。また、パージされたフィールドはどのコンポーネントからも読み取られないフィールドであるため、レンダリングされることも、ページ上で選択できることもありません。

package/docs/ja/per_locale_file.md

@@ -77,6 +77,17 @@ const helloWorldContent = {
 module.exports = helloWorldContent;
 ```
 
+```json5 fileName="hello-world.ja.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "ja", // 重要
+  "content": {
+    "multilingualContent": "私のコンポーネントのタイトル",
+  },
+}
+```
+
 ```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -95,6 +106,8 @@ module.exports = helloWorldContent;
 
 > 推奨: このフォーマットは、Intlayerのビジュアルエディターを使用する場合や、コード内で直接翻訳を管理する場合に最適です。
 
+> 注: どちらの場合でも、コンテンツ宣言ファイルは Intlayer に認識されるために `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` の命名パターンに従う必要があります。`.[locale]` サフィックスはオプションで、命名規則としてのみ使用されます。
+
 ### ロケールごとのファイルのグローバル設定
 
 `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", // 重要
-  "content": {
-    "multilingualContent": "私のコンポーネントのタイトル",
-  },
-}
-```
-
 ```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
 {
   "$schema": "https://intlayer.org/schema.json",
@@ -170,8 +172,6 @@ export default helloWorldContent;
 
 > 重要: locale フィールドが定義されていることを確認してください。これは Intlayer にファイルがどの言語を表しているかを伝えます。
 
-> 注意: どちらの場合も、コンテンツ宣言ファイルは Intlayer に認識されるために `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` という命名パターンに従う必要があります。`.[locale]` のサフィックスは任意で、命名規則としてのみ使用されます。
-
 ## フォーマットの混在
 
 同じコンテンツキーに対して、両方の宣言方法を組み合わせることができます。例えば：

package/docs/ja/readme.md

@@ -225,8 +225,8 @@ Intlayer の包括的なドキュメントを探索し、Intlayer の使い始
   <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=''>バックエンド</a>
      <ul>
       <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
@@ -234,6 +234,7 @@ Intlayer の包括的なドキュメントを探索し、Intlayer の使い始
       <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/ja/releases/v6.md

@@ -118,6 +118,8 @@ export default config;
 
 コンテンツファイルの `autoFill` フィールドを使用して、辞書ごとに微調整を行うことも可能です。詳細は `doc/autoFill` および `doc/dictionary/content_file` を参照してください。
 
+`autoFill`フィールドを使用して、コンテンツファイル内の辞書ごとに微調整することもできます。Intlayerはまず辞書ごとの設定を考慮し、その後グローバル設定にフォールバックします。完全なリファレンスは[Auto-fill](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/autoFill.md)と[Content file reference](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dictionary/content_file.md)を参照してください。
+
 ---
 
 ## fill コマンド: より安全なデフォルト設定
@@ -175,6 +177,20 @@ CIの例は[CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja
 
 ---
 
+MCP サーバーを新しい機能に対応するように更新しました。
+
+- 自動入力
+- 欠落している翻訳のテスト
+- ライブアップデート
+- ロギング
+- 検証
+- マイグレーションノート
+- ドキュメンテーション
+
+> MCP server は Intlayer を使用するプロジェクトの自動化に役立ちます。自動生成されたコードの欠落している翻訳をテストします。config を理解し、IDE に Intlayer のドキュメントを組み込むのに役立ちます。
+
+---
+
 ## パフォーマンス: 10倍高速化
 
 - ローカルおよびリモート辞書の並列解決
@@ -296,8 +312,6 @@ bun x intlayer live --with 'vite preview'
 
 完全なガイダンスについては、[CMSとライブ同期](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)および[設定](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)を参照してください。
 
----
-
 ## Turbopackでファイルを監視するための並列プロセス
 
 `next dev --turbopack`コマンドを使用してNext.js 14以上でTurbopackを開発サーバーとして使用する場合、辞書の変更はデフォルトでは自動的に検出されません。

package/docs/ja/self_hosting.md

@@ -19,6 +19,8 @@ author: aymericzip
 
 # Intlayerのセルフホスティング
 
+Intlayerはあなた自身のインフラストラクチャ上で実行できます。Intlayer Cloudアカウントは必要ありません。単一のオールインワンDockerイメージは、ダッシュボード、API、および必要なローカルデータストア（RedisとMinIO）をバンドルし、[s6-overlay](https://github.com/just-containers/s6-overlay)によって監視されています。
+
 Intlayerは、Intlayer Cloudアカウントを必要とせず、独自のインフラストラクチャ上で完全に実行できます。単一のコマンドで、本番環境に対応したスタックを起動します。
 
 ```sh
@@ -27,6 +29,8 @@ curl -fsSL https://intlayer.org/install.sh | sh
 
 インストーラーは `docker-compose.yml` と `.env` をダウンロードし、必要なシークレットを自動生成して、すべてのコンテナを `docker compose up -d` で起動します。
 
+唯一の外部依存関係は **MongoDB** です。バックエンドは提供する MongoDB **Atlas** クラスターに接続します。その他すべてはコンテナ内で実行されます。
+
 ## 目次
 
 <TOC/>
@@ -60,23 +64,77 @@ Chromium (Puppeteerのスクリーンショット生成に使用) はバック
 - ホスト上でポート `3000`、`3100`、`8025`、`9000`、`9001` が利用可能であること。
 - LinuxまたはmacOSホスト（またはWindows上のWSL2）。
 
+その他すべて — Bun、Redis、MinIO、Chromium — はイメージ内に含まれています。
+
 ---
 
 ## クイックスタート
 
+### 1. インストーラーを実行する
+
 ```sh
 curl -fsSL https://intlayer.org/install.sh | sh
 ```
 
-インストーラーの動作:
+Docker がインストールされており実行中であることを確認し、既に生成された `BETTER_AUTH_SECRET` と `S3_SECRET_ACCESS_KEY` を含む `./intlayer.env` を書き込み、イメージをプルします。コンテナを起動しません — バックエンドはデータベース認証情報がないとブートできません。
+
+インストーラーを再実行しても安全です。既存の `intlayer.env` は上書きされないため、アップグレードパスとしても機能します。
+
+### 2. 認証情報を入力する
+
+`intlayer.env` を開き、`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>
+```
+
+ファイルには、オプション機能のためのコメントアウトされたブロックも含まれています — [SMTP mailer](#global-mailer)、`OPENAI_API_KEY`、および OAuth プロバイダー。必要なものをコメント解除してください。
+
+> ファイルは `docker run --env-file` によって読み込まれ、クォートを削除せず、`=` の後のすべてを値として扱います。クォートなしの値を書き、コメントは独立した行に保つようにしてください。
+
+### 3. コンテナを起動する
+
+インストーラーが完了時に出力するコマンドは次の通りです:
+
+```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 \
+  --env-file ./intlayer.env \
+  ghcr.io/aymericzip/intlayer-selfhost:latest
+```
+
+その後、**http://localhost:3000** を開きます。初回起動時はデータストアが初期化されるため、1 分ほど待ってください。
+
+> ダッシュボードは `localhost` で提供されます。[制限事項](#limitations)を参照してください。公開されているイメージではカスタムドメインはサポートされていません。
 
-1.  `docker` と `docker compose` が存在するかどうかを確認します。
-2.  `docker-compose.yml` と `.env.example` を `./intlayer/` にダウンロードします。
-3.  `.env` が存在しない場合、例をコピーし、`BETTER_AUTH_SECRET`、`S3_ACCESS_KEY_ID`、`S3_SECRET_ACCESS_KEY` 用に `openssl rand` を介してランダムなシークレットを生成します。
-4.  `docker compose pull` + `docker compose up -d` を実行します。
-5.  URLを表示します: ダッシュボード `:3000`、API `:3100`、メールUI `:8025`、MinIOコンソール `:9001`。
+### インストーラー設定
 
-スタックが起動したら、**http://localhost:3000** を開き、最初のIntlayerアカウントを作成してください。
+インストーラーは環境変数をいくつか読み込みます。`sh` にパイプされるため、`curl` ではなくシェルに環境変数を渡してください:
+
+```sh
+curl -fsSL https://intlayer.org/install.sh | INTLAYER_ENV_FILE=./config/intlayer.env sh
+```
+
+| 変数                      | デフォルト                                    | 説明                                       |
+| ------------------------- | --------------------------------------------- | ------------------------------------------ |
+| `INTLAYER_IMAGE`          | `ghcr.io/aymericzip/intlayer-selfhost:latest` | プルするイメージ                           |
+| `INTLAYER_ENV_FILE`       | `./intlayer.env`                              | env ファイルの書き込み先                   |
+| `INTLAYER_CONTAINER_NAME` | `intlayer`                                    | コンテナー名                               |
+| `INTLAYER_DATA_VOLUME`    | `intlayer-data`                               | `/data` にマウントされた名前付きボリューム |
+| `INTLAYER_APP_PORT`       | `3000`                                        | ダッシュボードのホストポート               |
+| `INTLAYER_API_PORT`       | `3100`                                        | API のホストポート                         |
+| `INTLAYER_S3_PORT`        | `9000`                                        | MinIO S3 API のホストポート                |
+| `INTLAYER_CONSOLE_PORT`   | `9001`                                        | MinIO コンソールのホストポート             |
+
+> 4 つのポート変数は、`docker run` コマンドで出力されるマッピングの**ホスト**側のみを変更します。公開されたイメージには、`http://localhost:3000`、`http://localhost:3100`、`http://localhost:9000` がビルド時にダッシュボード bundle にコンパイルされているため、これらをリマップするとブラウザーが古いポートを指し続けます。独自のイメージをビルドしていない限り、デフォルトを保持してください — [制限事項](#limitations)を参照してください。
 
 ---
 
@@ -103,8 +161,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | **minio**   | `minio/minio`                        | `9000` (S3), `9001` (コンソール) | アバターとスクリーンショット用のS3互換オブジェクトストレージ |
 | **mailpit** | `axllent/mailpit`                    | `1025` (SMTP), `8025` (ウェブUI) | ローカルトランザクションメールシンク                         |
 
-内部ポート (mongo, redis) は、デフォルトではホストに公開されません。
-
 > MinIOポート `9000` は、アップロードされたアセット (アバター、スクリーンショット) が `S3_PUBLIC_URL=http://localhost:9000/intlayer` から直接読み込まれるため、ブラウザから到達可能である必要があります。
 
 ---
@@ -160,8 +216,6 @@ curl -fsSL https://intlayer.org/install.sh | sh
 | `LINKEDIN_CLIENT_ID`, `LINKEDIN_CLIENT_SECRET`           | LinkedIn OAuthログイン                                                     |
 | `ATLASSIAN_CLIENT_ID`, `ATLASSIAN_CLIENT_SECRET`         | Atlassian OAuthログイン                                                    |
 
----
-
 ### グローバルメーラー
 
 デフォルトでは、すべてのトランザクションメールは `RESEND_API_KEY` を使用して Resend 経由で送信されます。セルフホストされたデプロイメントでは、パスワードリセットやマジックリンクなどの非組織メールを含む**すべての**メールを、環境変数で設定されたグローバルメーラー経由でルーティングできます。
@@ -247,16 +301,8 @@ const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
 
 ## アップグレード
 
-既存のデプロイメントでインストーラーを再実行すると、ローリングアップグレードが実行されます。
-
-```sh
-curl -fsSL https://intlayer.org/install.sh | sh
-```
-
 これにより、最新のイメージがプルされ、`docker compose pull && docker compose up -d` でコンテナが再起動されます。既存のボリューム (`mongo-data`、`redis-data`、`minio-data`) は保持され、データ損失はありません。
 
-`./intlayer/` ディレクトリ内で手動でアップグレードするには:
-
 ```sh
 docker compose pull
 docker compose up -d
@@ -320,14 +366,12 @@ docker compose logs mongo
 docker compose logs redis
 ```
 
+ログの上部付近で `MongoDB connection error` を探してください。
+
 ### メールが送信されない
 
 デフォルトでは、すべての送信メールはMailpitによって捕捉されます。送信されたメッセージを確認するには、`http://localhost:8025` を開いてください。実際のメールを送信するには、`.env` で `MAIL_PROVIDER=resend` と `RESEND_API_KEY=<your-key>` を設定し、バックエンドを再起動します。
 
-```sh
-docker compose restart backend
-```
-
 ### MinIOバケットが見つからない
 
 `minio-init` ワンショットサービスが実行されなかった場合 (またはMinIOが準備できる前に実行された場合) は、手動でバケットを作成してください。

package/docs/ko/agent_skills.md

@@ -1,11 +1,11 @@
 ---
 createdAt: 2026-02-09
 updatedAt: 2026-03-03
-title: 에이전트 스킬
-description: 메타데이터, 사이트맵 및 서버 액션에 대한 포괄적인 설정 가이드를 포함하여 Intlayer 에이전트 스킬을 사용하여 AI 에이전트의 프로젝트 이해도를 높이는 방법을 배워보세요.
+title: Agent Skills
+description: 메타데이터, 사이트맵 및 서버 액션에 대한 포괄적인 설정 가이드를 포함하여 Intlayer Agent Skills를 사용하여 AI 에이전트의 프로젝트 이해도를 높이는 방법을 배워보세요.
 keywords:
   - Intlayer
-  - 에이전트 스킬
+  - Agent Skills
   - AI 에이전트
   - 국제화
   - 문서
@@ -19,13 +19,13 @@ history:
 author: aymericzip
 ---
 
-# 에이전트 스킬
+# 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/ko/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://github.com/aymeric
 
 ## 설치
 
-`@intlayer/analytics`는 **선택적 피어 의존성(peer, optional dependency)**으로, 프레임워크 패키지에 의해 자동으로 설치되지 않습니다. `intlayer`와 함께 설치하세요:
+`@intlayer/analytics`는 모든 프레임워크 패키지(`react-intlayer`, `next-intlayer`, `vue-intlayer` 등)의 **선택적 의존성(optional dependency)**이므로 대부분의 프로젝트에는 이미 설치되어 있습니다. 설정이 선택적 의존성을 건너뛴다면(`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`와 연결되어 있으므로, 이 Provider가 사용되는 곳이라면 어디서든 바로 사용할 수 있습니다:
+선택적 `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, // 두 번의 배치 전송 사이의 밀리초
+    sampleRate: 1, // 기록할 세션 비율, 0(없음)에서 1(전체)까지
+  },
+};
+
+export default config;
+```
+
+`@intlayer/analytics`를 제거하는 것은 `enabled: false`와 동일한 효과를 냅니다. 전체 필드 목록은 [구성 레퍼런스](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)를 참고하세요.
 
 ## 사용법
 
@@ -154,6 +166,34 @@ const CTAButton = () => {
 
 ### 클라이언트 측에서 변형 해결(Resolving a variant)
 
+  </Tab>
+</Tabs>
+
+가중치는 선택 사항입니다. 각 변형에 대해 하나씩 전달하여 분할을 조정할 수 있습니다. 예: `useExperiment("homepage-hero", ["default", "black_friday"], [9, 1])`.
+
+자식은 일치하는 사전의 [Variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/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>
+  );
+};
+```
+
+> **자식** 컴포넌트에서 variant를 읽는 것이 React 외부에서 작동하게 하는 원리입니다: Vue, Svelte, Solid, Angular에서는 `useIntlayer`에 전달된 selector가 컴포넌트 설정 시점에 캡처되므로, 읽기는 variant가 알려진 후에만 마운트되는 컴포넌트에서 발생해야 합니다.
+
+실험이 단일 사전이 아닌 전체 페이지를 포함하는 경우, 변형을 대신 제공자에게 끌어올려야 합니다 — [Ambient variant](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/variants.md#ambient-variant)를 참조하세요. 그러면 아래의 모든 `useIntlayer`는 호출 사이트 변경 없이 이에 대해 해결됩니다.
+
+컴포넌트 외부에서 raw assignment가 필요하면 client에 직접 접근하세요:
+
 ```tsx fileName="useHeroVariant.ts" codeFormat="tsx"
 import { getGlobalAnalyticsClient } from "@intlayer/analytics/client";
 
@@ -164,6 +204,8 @@ const variant = client?.getVariant("homepage-hero", [
 ]);
 ```
 
+> `getVariant`는 할당만 수행하며, 노출을 기록하지 않습니다. 대신 `useExperiment()`을 사용하세요. 그렇지 않으면 전환율의 분모가 없습니다.
+
 ## 프라이버시 & 성능
 
 - **설계상 익명(Anonymous by design)**: 세션은 회전하는(rotating) 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`를 아예 설치하지 않는 앱은 번들 크기나 런타임 비용을 지불하지 않으며, 오류가 발생하지 않습니다.
-- `editor.clientId`가 구성되지 않은 경우 `@intlayer/config`에 의해 `'false'`로 자동 설정되는 컴파일 타임 환경 변수(`INTLAYER_ANALYTICS_ENABLED`)는, 번들러가 통합된 코드 전체를 **데드 코드 제거(dead-code-eliminate)**할 수 있게 해줍니다.
+- 컴파일 타임 환경 변수(`INTLAYER_ANALYTICS_ENABLED`)는 패키지가 설치되지 않았거나, `analytics.enabled`가 `false`이거나, `editor.clientId`가 구성되지 않은 경우 `@intlayer/config`에 의해 자동으로 `'false'`로 설정되어 번들러가 전체 통합을 **데드 코드로 제거(dead-code-eliminate)**할 수 있게 합니다;
 - Intlayer 에디터/CMS 미리보기 iframe 내부에서는 Analytics 기능이 비활성화되므로 에디터 세션이 실제 트래픽으로 계산되지 않습니다.
 
 ## 대시보드: Analytics 페이지
@@ -213,6 +255,8 @@ const cms = createIntlayerCMS();
 const { data: audience } = await analyticsEndpoint(cms).getAudience(30);
 ```
 
+> **서버 측에서만 사용.** `createIntlayerCMS()`는 `clientId` + `clientSecret`으로 인증하며, 이 시크릿은 브라우저에서 절대 사용 불가능합니다 — 이 코드가 브라우저에서 실행되면 인증되지 않은 요청을 발급합니다. 라우트 핸들러, 서버 액션 또는 스크립트에 유지하세요.
+
 ## 유용한 링크
 
 - [Dynamic Dictionaries - Collections & Variants](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dynamic_dictionaries/index.md)