> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# エディター

> CTOR 内でプロジェクトの設定をビジュアルに編集する

**エディター**タブは、[BRICKS Controller](/ja/controller) が提供するものと同じビジュアルな [Config Editor](/ja/controller/config-editor) を埋め込みますが、ローカルのプロジェクトに接続されています。Subspace、Canvas、Brick、Generator、Data、Animation、Data Calculation をビジュアルに編集でき、保存するとその編集がプロジェクトの bricks-ctor TypeScript ソースにコンパイルされ、Git にコミットされます。エディターはプロジェクトセッションで利用でき——メインチャットでは使えません——CTOR の言語とテーマに従います。アプリケーションプロジェクトとモジュールプロジェクトの両方で動作します。

エディターは Web 版 Config Editor と同じエンティティモデルを扱います。Subspace、Canvas、Brick、Generator、Data、Animation、Data Calculation が何であるかについては、[Config Editor リファレンス](/ja/controller/config-editor)を参照してください。

## エディターを開く

どちらかの[パネル](/ja/ctor/reference/panels)の **+**（新しいタブ）メニューから**エディター**タブを追加します。

## 要件

<Info>
  エディターにはグローバルにインストールされた [BRICKS CLI](/ja/cli) のバージョン **2.25.0 以降**が必要です。

  * **古い CLI** — エディターは「設定エディターには BRICKS CLI 2.25.0 以降が必要です。更新してから続行してください。」を、現在のバージョンと **BRICKS CLI を更新** ボタンとともに表示します。
  * **廃止されたパッケージ** — 廃止された bricks-ctor パッケージを使うプロジェクトでは、移行の案内と **移行** ボタンが表示されます。
  * **CLI がない** — エディターは「BRICKS CLI が見つかりません。次のコマンドでインストールしてください：」とインストールコマンドを表示します。
</Info>

## ツールバー

エディターのツールバーには次のコントロールがあります：

| コントロール                    | 操作                                                                                                           |
| ------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Undo** / **Redo**       | 編集を前後に進める                                                                                                    |
| **History**               | 編集履歴パネルを開く                                                                                                   |
| **Single** / **Subspace** | 単一の Canvas 表示と Subspace 全体の表示を切り替える。現在の Subspace に複数の Canvas がある場合に表示される                                     |
| **Grid** / **Preview**    | Brick レイアウトのレンダリングモードを切り替える。これはエディター内のレイアウトレンダリングモードで、右パネルの[シミュレーター](/ja/ctor/reference/simulator)タブとは別のものです |
| 保存状態のドット                  | 編集が保存されているかどうかを示す——[保存状態](#保存状態)を参照                                                                          |
| **再読み込み**                 | コンパイル済み設定をディスクから再読み込みする                                                                                      |
| **保存**                    | 編集を保存してコミットする                                                                                                |

## 保存とコミット

**保存**をクリックすると、プレースホルダー `chore: update config from CTOR editor` があらかじめ入力されたコミットメッセージのポップオーバーが開きます。**保存してコミット**で確定して編集を書き込みます。

保存すると：

* 編集内容のソースファイル——`application.json`、`app.ts`、`root.ts`、および `subspaces/` と `automation-tests/` 配下のファイル——を生成します。
* 生成したソースをコンパイルして型チェックします。
* Git コミットを作成します——件名はあなたのメッセージ（または既定のプレースホルダー）で、本文は変更の要約です。エディターが生成または削除したファイルのみがステージされ、無関係な変更がステージされることはありません。

コンパイルまたは型チェックが失敗すると、保存は拒否され失敗内容が表示されます。何もコミットされません。

## 保存状態

保存状態のドットは編集の状態を示します。ドットにカーソルを合わせると全文が表示されます。

| 状態         | 意味                     |
| ---------- | ---------------------- |
| **保存済み**   | 編集が書き込まれてコミットされている     |
| **未保存**    | まだ保存されていない編集がある        |
| **保存中...** | 保存が進行中                 |
| 競合の警告      | コンパイル済み設定がエディター外で変更された |
| エラー        | 直前の保存が失敗した             |

未保存の編集がある状態でコンパイル済み設定がエディター外で変更された場合（たとえばエージェントがソースを編集した場合）、保存すると「コンパイル済み設定がエディター外で変更されました。保存する前に再読み込みするか外部変更を解決してください。」と表示されます。エディターは外部変更のマージと保存の再試行を自動的に試みます。できない場合は、まず**再読み込み**するか変更を解決してください。

**再読み込み**は未保存の編集を破棄し——「未保存の設定エディターの変更を破棄しますか？」と確認します——取り消し履歴をクリアします。

## キーボードショートカット

| ショートカット                        | 操作        |
| ------------------------------ | --------- |
| **Cmd/Ctrl+Z**                 | 元に戻す      |
| **Cmd+Shift+Z** または **Ctrl+Y** | やり直す      |
| **Backspace** / **Delete**     | 選択中の項目を削除 |
| **Cmd/Ctrl+C**                 | 選択内容をコピー  |
| **Cmd/Ctrl+V**                 | 貼り付け      |
| **Cmd/Ctrl+D**                 | 選択内容を複製   |

テキストフィールドに入力しているあいだは、コピー・貼り付け・複製はスキップされます。項目を右クリックするとコンテキストメニューが開きます。

コピーした Brick と Canvas は、エディターと Web 版 [Config Editor](/ja/controller/config-editor) の間を双方向に移動できるため、一方でコピーしてもう一方に貼り付けられます。

## コマンドパレット

**エディター**タブがアクティブなときに **Cmd/Ctrl+K** を押すと、エディターのコマンドパレット（タイトルは **エディターコマンド**）が開きます。次の項目が並びます：

* **New: Subspace / Canvas / Data / General Data Calculation / Script Data Calculation / Animation** — その種類の新しい項目を作成します。
* **New Brick: \<name>** と **New Generator: \<name>** — 指定した種類の新しい Brick または Generator を作成します。
* 設定内の既存項目への移動ナビゲーション。

モジュールプロジェクトでは Subspace を作成できません。

## ライブシミュレーションとエージェント

未保存の編集は[シミュレーター](/ja/ctor/reference/simulator)にライブでレンダリングされ、エージェントのスクリーンショットもそれを使うため、あなたが見るものとエージェントが見るものは一致します。

エディターを開いているあいだにエージェントが設定を変更すると、その変更はその場で適用され——影響を受ける Brick、Canvas フレーム、リスト行が短くパルスして、何が変わったかがわかります。

エージェントはあなたのエディター状態も把握できます。エディターが開いているか、未保存の編集があるか、現在の Subspace、選択内容、そして直近の編集履歴です。これにより、あなたのビジュアル編集と歩調を合わせて作業できます。

## 未保存の編集の保護

未保存の編集がある状態でセッションやプロジェクトを切り替えたり、**エディター**タブを閉じたり、ウィンドウを閉じたりすると、まず「未保存の設定エディターの変更を破棄しますか？」と確認されるため、誤って作業を失うことはありません。

## 項目ごとのヘルプ

多くの項目にはヘルプ（**?**）アイコンがあります。クリックすると、エディターの言語で表示されるドッキングされたリファレンスドロワーが開きます。

## 次のステップ

<CardGroup cols={2}>
  <Card title="シミュレーター" icon="play" href="/ja/ctor/reference/simulator">
    組み込みシミュレーターでプロジェクトを実行し、未保存のエディター編集をライブで確認できます。
  </Card>

  <Card title="Config Editor" icon="pen-to-square" href="/ja/controller/config-editor">
    Subspace、Canvas、Brick、Generator の背後にあるエンティティモデルを学びます。
  </Card>
</CardGroup>