@intlayer/docs 9.0.0-canary.9 → 9.0.1

package/docs/ja/intlayer_with_vite+vue.md

@@ -76,7 +76,7 @@ Intlayer は単なる i18n ソリューションではなく、**自己ホスト
 
 <Tabs defaultTab="video">
   <Tab label="ビデオ" value="video">
-  
+
 <iframe title="The best i18n solution for Vite and Vue? Discover Intlayer" class="m-auto aspect-16/9 w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/IE3XWkZ6a5U?autoplay=0&amp;origin=https://intlayer.org&amp;controls=0&amp;rel=1"/>
 
   </Tab>
@@ -113,19 +113,19 @@ GitHub の [アプリケーションテンプレート](https://github.com/aymer
 npm を使って必要なパッケージをインストールします：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。

package/docs/ja/live-sync.md

@@ -0,0 +1,185 @@
+---
+createdAt: 2026-07-08
+updatedAt: 2026-07-08
+title: ライブ同期 | CMSコンテンツの変更をリアルタイムに反映
+description: リビルドや再デプロイなしで、Intlayer CMS のコンテンツ変更をアプリにリアルタイムで反映させます。
+keywords:
+  - ライブ同期
+  - Live Sync
+  - CMS
+  - ビジュアルエディタ
+  - 国際化
+  - ドキュメント
+  - Intlayer
+  - Next.js
+  - Vite
+history:
+  - version: 9.0.0
+    date: 2026-07-08
+    changes: "Intlayer CMS ドキュメントから独立したページに移動"
+  - version: 6.0.1
+    date: 2025-09-22
+    changes: "ライブ同期のドキュメントを追加"
+  - version: 6.0.0
+    date: 2025-09-04
+    changes: "`hotReload` フィールドを `liveSync` に置き換え"
+author: aymericzip
+---
+
+# ライブ同期
+
+ライブ同期は、アプリが実行時に CMS のコンテンツ変更を反映できるようにします。再ビルドや再デプロイは不要です。有効にすると、更新がライブ同期サーバーにストリームされ、アプリケーションが読み込む辞書が更新されます。
+
+## 目次
+
+<TOC/>
+
+---
+
+## ライブ同期を有効にする
+
+Intlayerの設定を更新してLive Syncを有効にします：
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... その他の設定
+  editor: {
+    /**
+     * 変更が検出されたときにロケール設定のホットリロードを有効にします。
+     * 例えば、辞書が追加または更新された場合、アプリケーションは
+     * ページに表示されるコンテンツを更新します。
+     *
+     * ホットリロードは継続的なサーバー接続を必要とするため、
+     * `enterprise`プランのクライアントのみ利用可能です。
+     *
+     * デフォルト: false
+     */
+    liveSync: true,
+  },
+  dictionary: {
+    /**
+     * 辞書のインポート方法を制御します：
+     *
+     * - "fetch"：辞書はLive Sync APIを使用して動的に取得されます。
+     *   useIntlayerの代わりにuseDictionaryDynamicを使用します。
+     *
+     * 注意：ライブモードはLive Sync APIを使用して辞書を取得します。API呼び出しが
+     * 失敗した場合、辞書は動的にインポートされます。
+     * 注意：リモートコンテンツかつ"live"フラグが付いた辞書のみがライブモードを使用します。
+     * その他はパフォーマンスのために動的モードを使用します。
+     */
+    importMode: "fetch",
+  },
+};
+
+export default config;
+```
+
+アプリケーションをラップするために Live Sync サーバーを起動します：
+
+スタンドアロンサーバーを使用した例：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... その他のスクリプト
+    "live:start": "npx intlayer live",
+  },
+}
+```
+
+`--process` 引数を使用して、アプリケーションサーバーと並行して使用することもできます。
+
+Next.js を使用した例：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... その他のスクリプト
+    "build": "next build",
+    "dev": "next dev",
+    "start": "npx intlayer live --with 'next start'",
+  },
+}
+```
+
+Vite を使用した例：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... その他のスクリプト
+    "build": "vite build",
+    "dev": "vite dev",
+    "start": "npx intlayer live --with 'vite start'",
+  },
+}
+```
+
+Live Sync サーバーはあなたのアプリケーションをラップし、更新されたコンテンツが到着すると自動的に適用します。
+
+CMSからの変更通知を受け取るために、Live SyncサーバーはバックエンドとのSSE接続を維持します。CMSのコンテンツが変更されると、バックエンドは更新情報をLive Syncサーバーに転送し、新しい辞書を書き込みます。アプリケーションは次のナビゲーションまたはブラウザのリロード時に更新を反映し、再ビルドは不要です。
+
+フローチャート（CMS/バックエンド -> Live Syncサーバー -> アプリケーションサーバー -> フロントエンド）:
+
+![Live Sync フロー CMS/バックエンド/Live Syncサーバー/アプリケーションサーバー/フロントエンド スキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_flow_scema.svg)
+
+動作の仕組み:
+
+![Live Sync ロジックスキーマ](https://github.com/aymericzip/intlayer/blob/main/docs/assets/live_sync_logic_schema.svg)
+
+## 開発ワークフロー（ローカル）
+
+- 開発中は、アプリケーション起動時にすべてのリモート辞書が取得されるため、更新をすばやくテストできます。
+- Next.jsでローカルにLive Syncをテストするには、開発サーバーをラップします：
+
+```json5 fileName="package.json"
+{
+  "scripts": {
+    // ... 他のスクリプト
+    "dev": "npx intlayer live --with 'next dev'",
+    // "dev": "npx intlayer live --with 'vite dev'", // Vite用
+  },
+}
+```
+
+開発中にIntlayerがLiveインポート変換を適用するように最適化を有効にします：
+
+```typescript fileName="intlayer.config.ts" codeFormat={["typescript", "esm", "commonjs"]}
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  editor: {
+    applicationURL: "http://localhost:5173",
+    liveSyncURL: "http://localhost:4000",
+    liveSync: true,
+  },
+  dictionary: {
+    importMode: "fetch",
+  },
+  build: {
+    optimize: true, // default: process.env.NODE_ENV === 'production'
+  },
+};
+
+export default config;
+```
+
+この設定により、開発サーバーがLive Syncサーバーでラップされ、起動時にリモート辞書を取得し、CMSからの更新をSSE経由でストリーミングします。変更を確認するにはページをリロードしてください。
+
+## 注意事項と制約
+
+- Live Sync のオリジンをサイトのセキュリティポリシー（CSP）に追加してください。Live Sync の URL が `connect-src`（および該当する場合は `frame-ancestors`）で許可されていることを確認してください。
+- Live Sync は静的出力では動作しません。Next.js の場合、ページはランタイムで更新を受け取るために動的である必要があります（例：完全な静的のみの制約を避けるために、`generateStaticParams`、`generateMetadata`、`getServerSideProps`、または `getStaticProps` を適切に使用してください）。
+- CMSでは、各辞書に`live`フラグがあります。`live=true`の辞書のみがライブ同期APIを通じて取得され、それ以外は動的にインポートされ、実行時には変更されません。
+- `live`フラグはビルド時に各辞書ごとに評価されます。ビルド時にリモートコンテンツが`live=true`に設定されていなかった場合、その辞書のライブ同期を有効にするには再ビルドが必要です。
+- ライブ同期サーバーは`.intlayer`に書き込み可能でなければなりません。コンテナ環境では`/.intlayer`への書き込み権限を確保してください。
+
+## 役立つリンク
+
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)
+- [Intlayer ビジュアルエディタ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_visual_editor.md)
+- [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [セルフホスティングガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/self_hosting.md)

package/docs/ja/migration_from_i18next_to_intlayer.md

@@ -99,19 +99,19 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。

package/docs/ja/migration_from_next-i18next_to_intlayer.md

@@ -102,19 +102,19 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。

package/docs/ja/migration_from_next-intl_to_intlayer.md

@@ -98,19 +98,19 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 Intlayerのコアパッケージと互換性アダプター`@intlayer/next-intl`をインストールします：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。
@@ -184,9 +184,7 @@ import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";
 
 const withIntlayer = createNextIntlPlugin();
 
-const nextConfig: NextConfig = {
-  /* 既存の設定オプション */
-};
+const nextConfig: NextConfig = {/* 既存の設定オプション */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/ja/migration_from_nuxtjs_i18n_to_intlayer.md

@@ -101,19 +101,19 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。

package/docs/ja/migration_from_react-i18next_to_intlayer.md

@@ -101,19 +101,19 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。
@@ -209,9 +209,7 @@ import { createNextI18nPlugin } from "@intlayer/next-i18next/plugin";
 
 const withIntlayer = createNextI18nPlugin();
 
-const nextConfig: NextConfig = {
-  /* オプション */
-};
+const nextConfig: NextConfig = {/* オプション */};
 
 export default withIntlayer(nextConfig);
 ```

package/docs/ja/migration_from_vue-i18n_to_intlayer.md

@@ -100,19 +100,19 @@ AIプロバイダーのコストで、お好みのLLMを使用してCI/CDパイ
 Intlayerのコアパッケージと互換性アダプターをインストールします：
 
 ```bash packageManager="npm"
-npx intlayer-cli init --interactive
+npx intlayer init --interactive
 ```
 
 ```bash packageManager="pnpm"
-pnpm dlx intlayer-cli init --interactive
+pnpm dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="yarn"
-yarn dlx intlayer-cli init --interactive
+yarn dlx intlayer@canary init --interactive
 ```
 
 ```bash packageManager="bun"
-bunx intlayer-cli init --interactive
+bunx intlayer@canary init --interactive
 ```
 
 > `--interactive` フラグはオプションです。AI エージェントの場合は `intlayer-cli init` を使用してください。

package/docs/ja/releases/v9.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2026-06-14
-updatedAt: 2026-06-26
+updatedAt: 2026-07-08
 title: Intlayer v9の新機能
 description: Intlayer v9の新機能をご覧ください。主要なi18nライブラリ向けのドロップイン互換性パッケージと、コレクション、バリアントのサポートを導入します。
 keywords:
@@ -9,9 +9,11 @@ keywords:
   - Migration
   - Collections
   - Variants
+  - CMS SDK
   - i18next
   - next-intl
   - vue-i18n
+youtubeVideo: https://www.youtube.com/watch?v=zmCN4z_B4jk
 slugs:
   - doc
   - releases
@@ -23,6 +25,14 @@ author: aymericzip
 
 Intlayer v9へようこそ！このメジャーリリースは、主要なi18nライブラリ（`react-i18next`、`next-intl`、`vue-i18n`など）向けの**互換アダプターパッケージ**により、Intlayerへの移行パスを簡素化し、**コレクション**、**バリアント**といったリッチなコンテンツ構造のサポートを追加することで、大きな節目となります。
 
+<iframe
+  src="https://www.youtube.com/embed/zmCN4z_B4jk"
+  className="m-auto overflow-hidden rounded-lg border-0 max-md:size-full max-md:h-[700px] md:aspect-16/9 md:w-full"
+  title="Demo Video - New Intlayer v9 - What's new?"
+  sandbox="allow-forms allow-modals allow-popups allow-presentation allow-same-origin allow-scripts"
+  loading="lazy"
+/>
+
 ## 目次
 
 <TOC levels={[2]} maxDepth={1} />
@@ -109,36 +119,40 @@ Intlayer v9は、静的なキーと値のオブジェクトを超えて拡張さ
 
 CMSで管理される順序付きアイテムのリスト（例：FAQ、製品、ブログリスト）を定義します。
 
-```ts fileName="faq.content.ts"
+```ts fileName="faq.1.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "faq",
+  item: 1,
+  content: {
+    question: t({ en: "What is Intlayer?", fr: "Qu'est-ce qu'Intlayer ?" }),
+    answer: t({ en: "An i18n toolkit.", fr: "Une boîte à outils i18n." }),
+  },
+} satisfies Dictionary;
+```
+
+```ts fileName="faq.2.content.ts"
 import { t, type Dictionary } from "intlayer";
 
 export default {
   key: "faq",
-  content: [
-    {
-      question: t({
-        ja: "Intlayerとは何ですか？",
-        en: "What is Intlayer?",
-        fr: "Qu'est-ce qu'Intlayer ?",
-      }),
-      answer: t({
-        ja: "i18nツールキットです。",
-        en: "An i18n toolkit.",
-        fr: "Une boîte àツール i18n.",
-      }),
-    },
-  ],
+  item: 2,
+  content: {
+    question: t({ en: "Is it free?", fr: "Est-ce gratuit ?" }),
+    answer: t({ en: "Yes, open-source.", fr: "Oui, open-source." }),
+  },
 } satisfies Dictionary;
 ```
 
 #### 使用法：
 
 ```ts
-// Fetch all items
+// Fetch all items as an array
 const allFaqs = useIntlayer("faq"); // -> { question: string, answer: string }[]
 
-// Fetch single item by index
-const faq = useIntlayer("faq", { item: 1 }); // -> { question: string, answer: string }
+// Fetch a single item by index
+const faq = useIntlayer("faq", { item: 2 }); // -> { question: string, answer: string }
 ```
 
 ### 2. バリアント
@@ -192,28 +206,52 @@ export default {
 ```ts
 // Fetches only the requested item dynamically (requires Suspense)
 const product = useIntlayer("product-copy", {
-  id: "prod_123",
-  category: "books",
+  variant: { id: "prod_123", category: "books" },
 });
 ```
 
 ---
 
-## 動的ロードとバンドルサイズの最適化
-
-バンドルを極めて小さく保つため、Intlayer v9は動的な遅延ロードをサポートしています。
-
-設定で、`importMode`を`'dynamic'`または`'fetch'`に設定します。
-
-```ts fileName="intlayer.config.ts"
-export default {
-  dictionary: {
-    importMode: "dynamic", // "static" | "dynamic" | "fetch"
-  },
+## `@intlayer/analytics`: コンテンツ露出の計測と A/B テスト
+
+新しいオプションパッケージ [`@intlayer/analytics`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) は、実際にどのコンテンツが訪問者に表示されているかを教えてくれます。そして **Collections & Variants** の輪を完成させ、コンテンツの A/B テストとバリアントごとのコンバージョン計測を可能にします。
+
+- **プロバイダーレベルの計測**: `IntlayerProvider`（React / Next.js / React Native）は、初回読み込み、ルート変更、ロケール変更時に自動で `page_view` イベントを記録します。
+- **ノードレベルの計測**: `useIntlayer` が解決されるたびに `content_exposure` イベントが送信されます — どの辞書キー、キーパス、ロケール、そして（該当する場合は）どの A/B **バリアント** が表示されたか。フラッシュ間隔内の同一ノードへの重複露出は 1 件に集約されます。
+- **決定論的な A/B 割り当て**: `getVariant(experimentKey, variants)` はサーバーへの往復なしでセッションにバリアントを割り当てるため、初回描画前のちらつきがありません。
+- **`useConversion()`**: セッションが見たバリアントに対して、ゴール（登録、クリック、購入など）を紐づけます。
+- **未インストール時のコストはゼロ**: `@intlayer/editor` と同じ tree-shakeable パターンを採用 — `try/catch` でラップした動的 `import()` に加え、ビルド時の環境変数（`INTLAYER_ANALYTICS_ENABLED`）により、利用しないアプリでは統合全体がデッドコード除去されます。
+- **新しい設定スキーマなし**: 既存の `editor.backendURL`（送信先エンドポイント / セルフホスティング）と `editor.clientId`（プロジェクトキー、兼有効化スイッチ）を再利用します。
+- **プライバシーへの配慮**: セッションの匿名ハッシュ化（SHA-256、生の ID は保存しない）、IP は保存せず、国単位の大まかな位置情報のみ、リクエストはおよそ 20 秒ごとにバッチ送信されます。
+- **ダッシュボード**: 新しい **Analytics** ページ（プロジェクト選択後にサイドバーへ表示）で、アクティブユーザー数、本日のユーザー数、過去 7/30/90 日のユーザー数、訪問者推移グラフ、ロケール別・地域別の内訳を確認できます。
+
+```tsx fileName="CTAButton.tsx" codeFormat="tsx"
+import { useConversion } from "react-intlayer";
+
+const CTAButton = () => {
+  const trackConversion = useConversion();
+
+  return (
+    <button
+      onClick={() =>
+        trackConversion({
+          experimentKey: "homepage-hero",
+          variant: "black_friday",
+          goal: "cta_click",
+        })
+      }
+    >
+      Get started
+    </button>
+  );
 };
 ```
 
-ビルド時、`@intlayer/swc`と`@intlayer/babel`はファイルをスキャンし、`useIntlayer` / `getIntlayer`の呼び出しをツリーシェイク可能なラッパー（`useDictionary` / `useDictionaryDynamic`）に置き換えます。選択されたコレクションアイテム、バリアント、またはロケールに必要なコンテンツのみがロードされ、本番バンドルに未使用の翻訳が含まれるのを防ぎます。
+```bash packageManager="npm"
+npm install @intlayer/analytics
+```
+
+現在 React、Next.js、React Native（`react-intlayer` 経由）で利用可能です。他のフレームワークバインディング（Vue、Svelte、Angular など）は、`@intlayer/editor` と同じ展開パターンに沿って計画されています。完全なガイドは [Analytics ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md) を参照してください。
 
 ---
 
@@ -296,6 +334,34 @@ npm install intlayer react-native-intlayer
 
 ---
 
+## CMS SDK: Intlayer をヘッドレスコンテンツデータベースとして使う
+
+Intlayer v9 は、CMS をプログラムから操作するためのクリーンで自動認証される SDK を `@intlayer/api` に同梱しています。プロジェクトの取得、辞書の取得、そして自分のサーバー・スクリプト・CI からのプッシュや更新が可能です。認証（OAuth2 `client_credentials`）は自動的に処理・更新されます。
+
+SDK は **2 つの独立したインポート** に分かれており、実際に使用するドメインだけがバンドルに含まれます。
+
+1. `createIntlayerCMS` — 資格情報と管理されるトークンを保持する軽量な **認証器**（ドメインクライアントは同梱されません）。
+2. `dictionaryEndpoint`、`projectEndpoint`、… — ドメインごとの **エンドポイントバインダー**。それぞれ独自のサブパスからインポートします。
+
+```ts fileName="cms.ts"
+import { createIntlayerCMS } from "@intlayer/api";
+import { dictionaryEndpoint } from "@intlayer/api/dictionary";
+
+// 設定は任意です。資格情報は INTLAYER_CLIENT_ID /
+// INTLAYER_CLIENT_SECRET（`@intlayer/config/built` により解決）にフォールバックします。
+const cms = createIntlayerCMS();
+
+// 読み取り
+const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();
+
+// 書き込み — CMS をデータベースのように使う
+await dictionaryEndpoint(cms).pushDictionaries([myDictionary]);
+```
+
+> セキュリティ: CMS の資格情報はコンテンツへの書き込みアクセスを許可します。認証器は必ず **サーバーサイド** でのみ作成し、`clientId` / `clientSecret` をブラウザーに送らないでください。
+
+---
+
 ## v8からの移行に関する注意点
 
 v8からアップグレードする場合、v9には破壊的変更は含まれていません。ただし、主な変更点は次のとおりです。
@@ -310,4 +376,6 @@ v8からアップグレードする場合、v9には破壊的変更は含まれ
 
 - [互換アダプターパッケージガイド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/compat/index.md)
 - [動的辞書 - コレクション、バリアント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/dynamic_dictionaries/index.md)
+- [Analytics（分析） - コンテンツ露出の計測とA/Bテスト](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/analytics.md)
 - [設定リファレンス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/configuration.md)
+- [CMS SDK - @intlayer/api によるプログラムからのアクセス](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)