
Blockstudio 7.6では、PHPからプロジェクトを読み取り、描画できるようになり、本番フロントエンドのデフォルトが`blockstudio.json`に移されました。インベントリAPI、単独描画、メディアとTailwindのテンプレートヘルパー、パフォーマンスプロファイル、単一のキャッシュディレクトリ、早期配信に対応した静的プリレンダリング、より厳格な解析プリセット、コーディングエージェント向けのプロジェクトツール生成が含まれます。

リリースの中心となるのは2つの呼び出しです。`Canvas::inventory()`は、プロジェクトに登録されたすべてのページ、ブロック、パターン、Site Editorテンプレート、テンプレートパーツ、バンドルされたUIの例を返します。`Render::document()`は、そのいずれについても、描画時に使用されたアセットだけを含む完成済みのHTMLを返します。

> **7.6.2 アップデート:** ファイルベースのページは、通常のWordPressリクエスト中に同期されなくなりました。ソースの変更を適用する場合は、`wp bs pages sync`を実行するか、`Blockstudio\Pages::reconcile()`を呼び出してください。コレクションのルーティングと`templateFor`のデフォルトでは、永続化されたランタイム設定が使用されます。また、明示的な同期では、以前発生していた大規模な多言語ORメタデータクエリが回避されます。ページ同期がリクエストフックから実行されなくなったため、短時間有効な`themeDefaults.syncPagesInDevelopment`オプションは削除されました。`Pages::init()`はブートストラップ専用になりました。`force`を渡していた統合では、`Pages::reconcile()`またはCLIを使用してください。Canvasを開くと、作成用インベントリに対して認証済みの明示的な同期が1回実行されます。

> **7.6.12 更新:** エディターのスタイルシートは、アセットごとにSASSをコンパイルするのではなく、1回の書き換え処理でプレフィックスが付与されるようになりました。そのため、ブロックが多いサイトでも、エディターの初回ビルドで少ないメモリ上限を使い切る心配がなくなりました。コンテンツハッシュ付きTailwindスタイルシートが削除されたキャッシュ済みの事前レンダリングページは、スタイルなしで配信されず、PHPキャッシュとEarly Serveドロップインの両方で再レンダリングされます。トップレベルに書き込まれたブロック属性は破棄されず、レンダリング時に読み取られるため、Blockstudioスキーマは`WP_Block_Type`上でプログラムから書き込む場合にも反映されます。

> **7.6.11 更新:** グラフアーティファクトのインストールでは、同じキーのストアコピーが変更されている場合にルートのドキュメントをアトミックに置き換え、同一のドキュメントには手を加えず、昇格、置換、スキップ、維持されたルートを`Static_Prerender_Early_Serve::last_promotion()`で報告するようになりました。

> **7.6.10 更新:** ランタイムキャッシュのヒット時に、監視のデバウンス中でも削除されたコンパイル済みアセットを検出するようになりました。また、7.6より前のフラットなランタイムキャッシュは、上限付きのcronバッチでアトミックに隔離して削除されます。バンドルされたUIのグローバルはページごとに1回だけ出力されます。グラフモードのEarly Serveでは、IDキャッシュを使ってデプロイ済みルートマップにないルートもライブレンダリングで配信できます。Tailwindでは、コンテンツハッシュ付きキャッシュファイルを`tailwind.output: "link"`で任意に出力できます。インライン出力がデフォルトです。

要点は次のとおりです。

- **プロジェクト一覧**: `Canvas::inventory()`は、登録済みのすべてのレコードをソースと安定した表示順とともに返します。
- **対象の選択**: ブロックとページを指定すると、検出、同期、レンダリング、コンパイルの対象を絞り込めます。
- **単独レンダリング**: `Blockstudio\Render`は、ブロック、コンポジション、またはドキュメント全体の完成したHTMLを返します。
- **UIコンポーネントファミリー**: `Blockstudio\Ui`は、バンドルされたライブラリをコンポーネントごとに1つの公開ファミリーにまとめ、それぞれの例を用意します。
- **画像寸法の安定化**: `bs_media_image()`は、生成された`assets/media.json`から実寸を取得してテーマアセットをレンダリングします。
- **Tailwindクラスヘルパー**: `bs_tw_merge()`と`bs_tw_variants()`は、競合を考慮してマージしながらPHP内のクラスを組み立てます。
- **パフォーマンスプロファイル**: `performance.profile`は、本番環境向けのフロントエンドのデフォルト設定を一括で有効にします。個別の値があればそちらが優先されます。
- **型付き設定アクセス**: `Settings::get_bool()`とその関連機能は、`blockstudio.json`を実際の型で読み取り、解析エラーを通知します。
- **単一のキャッシュディレクトリ**: 生成ファイルはすべて、ランタイムIDをキーとして`cache.path`以下に保存されます。
- **静的事前レンダリング**: 匿名のHTMLをキャッシュし、依存関係グラフで無効化して、WordPressの起動前に配信できます。
- **解析プリセット**: `theme`、`extreme-theme`、`wordpress-render`は、`blockstudio/phpstan`の対象をブロックテンプレート以外にも広げます。
- **管理対象のコミットフック**: `blockstudio-githooks sync`は、設定されたプリセットを実行するpre-commitフックを書き込み、管理します。
- **プロジェクトの仕様書**: `blockstudio-agents`は、プロジェクトで作成するもの、有効にする機能、プリセットで適用されるルールを記した`AGENTS.md`を書き込みます。
- **ドキュメント索引**: AIコンテキストファイルは、すべてのドキュメント、その目的、管理する識別子をまとめた索引になりました。
- **正規ブロックタグ**: 単独のコマンドで、プレフィックスやエイリアスの省略形を`<bs:namespace-slug>`に書き換えられます。ドライランにも対応しています。
- **デフォルトは互換モード**: 上記の機能は、`blockstudio.json`で指定されるまでサイトに影響しません。

## プロジェクトの読み込みとレンダリング

### プロジェクト一覧

`Canvas::inventory()`は、プロジェクトが登録したすべての項目を、レンダリングせずに1つの通常の配列として返します。

```php
use Blockstudio\Canvas;

$result = Canvas::inventory();

foreach ($result['inventory']['blocks'] as $block) {
    echo $block['name'] . "\n";
}
```

レコードは種類ごとにグループ化されます: `pages`、`blocks`、`patterns`、`templates`、`parts`、`ui`。`order`は全種類にわたる安定した表示順、`sources`は各レコードのソースパスを示し、`warnings`と`errors`は問題を構造化されたエントリーとしてまとめます。

ブロックレコードには`id`、`name`、`title`、`source`、`path`、`provenance`と、すぐにレンダリングできる`declaration`が含まれます。ページレコードでは、`source`が安定した識別子、`path`がレンダリングに使うテンプレートです。

### 対象の選択

レコードを指定すると、後から絞り込むのではなく、処理対象を絞って読み込みます。

```php
$changed = Canvas::inventory([
    'blocks' => ['mytheme/hero'],
    'pages' => ['about'],
]);
```

これにより、ブロック1つとページ1つが返されます。`patterns`、`templates`、`parts`、`ui`は空になり、それらのソースが読み込み、同期、レンダリング、コンパイルされることはありません。

ルールは次のとおりです:

- 種類のキーがない場合は、すべての種類を読み込みます。
- `true`、`null`、または`"*"`を指定すると、その種類の全レコードを読み込みます。
- 文字列またはリストは、ID、名前、スラッグ、パス、ソースパスに完全一致します。
- 空の文字列、空のリスト、または`false`を指定すると、その種類は何も読み込みません。
- いずれかの種類のキーを指定すると、省略した種類には触れません。

存在しなくなった識別子はエラーにならず`deleted`に返されます。CanvasのREST更新エンドポイントでも、`blocks`と`pages`のパラメーターに同じルールが適用されます。

`Canvas::documents()`は同じ選択対象を受け取り、レコードごとにレンダリング済みドキュメントを1つ追加します。選択したページは復元されたフロントエンドのコンテキストでレンダリングされるため、クエリー条件、bodyクラス、ショートコード、レイアウト、リダイレクト、enqueueコールバックには、ページを要求したリクエストではなく、そのページ自体が渡されます。

### 単独レンダリング

`Blockstudio\Render`は、フロントエンドと同じパイプラインを使って、レンダリング済みのHTMLを文字列として返します。

```php
use Blockstudio\Render;

$html = Render::composition([
    'root' => 'mytheme/card',
    'data' => ['heading' => 'Example card'],
    'layers' => [
        ['name' => 'mytheme/button', 'data' => ['label' => 'Continue']],
    ],
]);
```

基礎となる宣言形式は1つで、キーは4つです: `name`、`attributes`、`content`、`children`。`root`、`data`、`inner`、`innerBlocks`、`layers`、`example`は入力時の便宜機能で、`Render::normalize()`がこの形式にまとめます。
子要素は再帰的にレンダリングされ、入力が不正な場合は対象ブロック名を示す例外が発生します。

`Render::document()`は出力を完全な単独のHTMLドキュメントで囲みます。

```php
$document = Render::document('mytheme/hero', [
    'title' => 'Hero preview',
]);

echo $document['html'];
```

`body`はブロックの出力だけ、`html`は組み立てられたドキュメント、`blocks`は出力に含まれたブロック名、`assets`はマークアップを`head`、`footer`、`styles`、`scripts`、`modules`、`interactivity`、`ui`、`tailwind`に分割します。アセットはレンダリングされた内容に限定されるため、エディター専用アセットは含まれません。

`Render::document_from_html()`は別の場所でレンダリングされたHTMLを囲み、`Render::content()`はシリアライズされたブロックコンテンツをドキュメントなしでレンダリングします。1つのPHPプロセス内で複数のドキュメントをレンダリングする場合は、ドキュメント間で`Blockstudio\Batch_Render::reset()`を呼び出してください。`Canvas::documents()`ではすでに呼び出されています。

### UIコンポーネントファミリー

`Blockstudio\Ui`は、バンドルされたUIライブラリを、内部パーツの一覧ではなく、公開コンポーネントごとに1つのエントリーとして公開します。

`Ui::inventory()`は、各ファミリーについてルートブロック、タイトル、必要な実装ブロックを含むエントリーを1つ返します。`Ui::examples()`は各ファミリーの決定的な宣言を追加します。デフォルト値を維持し、必須の子レイヤーを親の下にネストし、値が空のフィールドには安定した例示テキストを入れます。この宣言が正規形式なので、そのまま`Render::document()`に渡せます。

Canvasも同じようにグループ化します。バンドルされたUIは`ui`タイプの下にファミリーごとに1つの例として表示され、実装の登録情報は`blocks`に表示されません。

各ファミリーは組み合わせて使えるよう設計されています。セレクトはダイアログ内で開き、リストボックスがトリガーに重なります。メニューとコンボボックスは、スクロールしても位置が変わらないビューポート固定座標に固定されます。モーダルは重ねて表示でき、Escapeキーを1回押すごとに1つ閉じます。すべてのフッターでは、バリアントと同じ閉じるコントロールを組み合わせて使えます。これらの連携方法と、それを保つ不変条件については[コンポジションの章](https://blockstudio.dev/ja/ui/composition/)をご覧ください。[/ui/examples](https://blockstudio.dev/ja/ui/examples/)では、実際のコンポジションを確認できます。

## テンプレートヘルパー

### 画像寸法の安定化

`bs_media_image()`はテーマアセットの実際の幅と高さ、予約済みのアスペクト比を出力するため、メディアライブラリ以外の画像でもレイアウトがずれません。

```php
<?php
echo bs_media_image([
    'src' => 'assets/images/hero.webp',
    'alt' => 'Hero',
]);
```

出力は`figure.blockstudio-media`で、実際の`width`、`height`、`loading`、`decoding`を持つ`img`を、インラインの`aspect-ratio`で囲みます。寸法は生成された`assets/media.json`から取得します。ビルド時には`Blockstudio\Media_Metadata_Builder`が書き込みますが、手動で作成することもできます。

`src`にはテーマからの相対パス、絶対パス、完全なURLを渡せます。メディアライブラリの画像には`attachmentId`を使います。`eager`はファーストビューで遅延読み込みを無効にし、`sources`は`<picture>`を出力します。

`performance.media.lazy`を有効にすると、実際のURLは、適切なサイズのプレースホルダーの背後にある`data-src`へ移動します。

### Tailwindクラスヘルパー

`bs_tw_merge()`と`bs_tw_variants()`は、エンジンBlockstudioがすでにバンドルしているものを使い、PHPテンプレートでTailwindクラスを組み立てます。

`bs_tw_merge('px-2 text-sm', 'px-4')`は`text-sm px-4`を返します。競合する`px-2`は削除され、後の値が優先されます。クラス値を含むネストした配列も使用できます。

`bs_tw_variants()`は、コンポーネントのバリアントに使える小さな呼び出し可能オブジェクトを返します:

```php
$button = bs_tw_variants([
    'base' => 'inline-flex items-center',
    'variants' => [
        'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
    ],
    'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);
```

これを実行すると`inline-flex items-center h-12 px-6 rounded`と表示されます。基本クラス、バリアント、デフォルトバリアント、複合バリアント、呼び出しごとの`class`または`className`に対応しています。

## 本番環境の設定

### パフォーマンスプロファイル

`performance.profile`を使うと、本番環境向けのフロントエンドのデフォルト設定を一括で有効にできます。

```json title="blockstudio.json"
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

`compat`はデフォルトで、何も変更しません。`speed`と`strict`は同じ設定一式を有効にします。headからジェネレーター、絵文字、フィード、ディスカバリー、関連記事の出力を削除し、oEmbedのディスカバリーとホスト側のスクリプトを削除します。XML-RPC、ピンバック、リモートエディターのディスカバリーを無効にし、汎用のコアフロントエンドアセットを削除し、画像出力のデフォルトを適用します。エディター以外ではHeartbeatを抑制し、ホバー時またはフォーカス操作時に同一オリジンのドキュメントを事前取得します。また、Blockstudioの画像ローダーを使用します。

上記の`preload.links`のように、各子設定の値はプロファイルを上書きします。コアのフロントエンドアセットを削除すると、それらに依存するページの表示が崩れるため、最初にテストしてください。`Runtime_Settings::current()`は解決済みのプロファイルを表示します。

`themeDefaults`は、テーマが独自に実装しがちな2つの機能を提供します。`titleTag`と、更新結果から有効な子テーマと親テーマを隠す`suppressDirectoryUpdates`です。

### 型付き設定アクセス

`Blockstudio\Settings`は、JSONに入っていた値をそのまま返すのではなく、設定を実際の型で読み取ります。

```php
use Blockstudio\Settings;

$lazy = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
$roles = Settings::get_array('users/roles');

foreach (Settings::errors() as $error) {
    error_log($error);
}
```

形式が不正なJSONは、デフォルト値に解決されず、`Settings::errors()`を通じて報告されます。`Settings::get_raw()`は有効なソースで宣言された項目だけを返すため、`false`に設定された値と未設定の値を区別できます。

`Settings::fingerprint()`は有効な設定の安定したIDを返し、`blockstudio.json`が変更されるとアクセス時に再読み込みします。

### 単一のキャッシュディレクトリ

生成ファイルはすべて`cache.path`以下に保存されます。デフォルトは`wp-content/blockstudio/cache`です。

```json title="blockstudio.json"
{
  "cache": {
    "enabled": true,
    "path": "cache/blockstudio"
  }
}
```

ビルドペイロード、ブロック登録データ、エディターアセット、コンパイル済みTailwind CSS、レンダリングドキュメント、アイランドフラグメント、静的HTML、グラフインデックス、ウォームキュー、診断情報はすべてそのルート以下に保存されます。相対パスは`WP_CONTENT_DIR`を基準に解決され、絶対パスを指定すると専用ボリュームを指します。

オブジェクトは現在のネットワークとサイトの下に、さらにランタイムIDごとに整理されます。ランタイムIDはBlockstudio、WordPress、PHPの各バージョン、有効な設定、アクティブなテーマとプラグイン、検出元、関連するソースファイルのフィンガープリントです。入力を変更すると、影響を受けるオブジェクトは新しいものに置き換わり、古いものは削除されます。

初回ビルドはシングルフライト方式です。1つのリクエストがビルドして結果をアトミックに公開し、ほかのリクエストは待機します。更新に失敗した場合は、失敗を確認できる状態のまま、最後に正常だったオブジェクトの配信を続けます。`Blockstudio\Runtime_Cache::purge('tailwind')`は1つのスコープをクリアします。

## 静的事前レンダリング

静的事前レンダリングでは、匿名アクセス向けの完全なHTMLドキュメントをキャッシュし、WordPressの起動前に配信できます。デフォルトでは無効です。

```json title="blockstudio.json"
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}
```

### 適用条件

対象となるのは、匿名アクセス向けの完全なHTMLドキュメントのみです。GET以外のリクエスト、クエリー文字列、管理画面、REST、Ajax、cron、フィード、検索、プレビュー、nonceを含むリクエスト、個人設定用Cookie、`dynamicPaths`以下のパスは対象外です。`<!-- blockstudio:no-cache -->`マーカーを使うと、レスポンス全体を対象外にできます。

パスの照合では境界を考慮します。そのため、`/account`は`/account/orders`には一致しますが、`/accounting`には一致しません。

### 署名モードとグラフモード

`invalidate`はエントリーの有効期限の扱いを選択します。デフォルトの`signature`モードでは、匿名アクセスでキャッシュが見つからないときにIDをキーとしたレスポンスを作成し、サイトレベルの変更後にローテーションします。通常のサイトに適しています。

`graph`モードは、ビルドとデプロイを明示的に行うツール向けです。各ページのソース依存関係を記録するため、プランを実行すると影響を受けるURLだけが再ビルドされます。

```php
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
    $result = render_with_dependencies($url);

    Static_Prerender_Runtime::persist_built_response(
        $url,
        $result['html'],
        $result['files'],
        $result['virtualHashes']
    );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));
```

### 早期配信

`earlyServe`を有効にすると、Blockstudioはサイトごとに小さなルートマップを管理し、`advanced-cache.php`ドロップインを使って、WordPress、プラグイン、テーマが起動する前に対象リクエストへのキャッシュヒットをストリーミング配信します。

ほかの所有者が管理するマップ、ドロップイン、`WP_CACHE`宣言は上書きしません。グラフアーティファクトは、マップの切り替え前に参照されているHTMLファイルをすべて検証するため、レンダリングが不完全なデプロイでも以前のグラフが有効なままです。マルチサイトのエントリーはホスト、ホームパス、サイトIDごとに分離されます。

### ウォームアップとステータス

日常的な操作には、3つのWP-CLIコマンドを使います:

```bash
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
```

`status`は、アクティブなID、ファイル数とバイト数、グラフレコード、キューの状態、スコープごとのヒット、ミス、ビルド、失敗のカウンターを報告します。

## 解析とエージェント用ツール

### 解析プリセット

`blockstudio/phpstan`は、ブロック解析に3つのレイヤーを追加し、プロジェクトが選んだレイヤーを実行するコマンドを提供します。

| プリセット | 追加される内容 |
| --- | --- |
| `base` | 既存のスキーマ、テンプレート、フック、設定、APIの解析。 |
| `theme` | テーマルート、スタイルヘッダー、アセット、セレクターのスコープ、フィールドのデフォルト値、リピーターの上限。 |
| `extreme-theme` | PHPStan`max`、安全でないPHP、エスケープ、Tailwind、JavaScript、Interactivityのチェック。 |
| `wordpress-render` | `extreme-theme`に加えて、呼び出し元が指定するライブレンダリングのプローブ。 |

デフォルト設定は`blockstudio.json`から取得されるため、対話形式の実行、CI、コミットフックで同じ設定を共有できます:

```json title="blockstudio.json"
{
  "phpstan": {
    "preset": "theme",
    "roots": ["."],
    "excludePaths": ["fixtures/**"],
    "maxFiles": 10000
  }
}
```

```bash
vendor/bin/blockstudio-phpstan --root . -- --no-progress
```

終了コードは、成功時が`0`、診断時が`1`、不正な使い方の場合が`2`です。ラッパーはシステムの一時ディレクトリ内で設定を組み立てるため、生成された設定、ベースライン、キャッシュがプロジェクト内に置かれることはありません。また、PHPStanのメモリ上限を`1G`に引き上げます。

BC Mathプロバイダーもバンドルされているため、JavaScriptのチェックで`ext-bcmath`が不要になりました。

### 管理対象のコミットフック

1つの設定と1つのコマンドで、設定済みのプリセットをコミット時のチェックとして実行できます。

```json title="blockstudio.json"
{
  "githooks": {
    "commit": true
  }
}
```

```bash
vendor/bin/blockstudio-githooks sync
```

同期すると、Gitの共通ディレクトリ内にフックと所有権レコードが書き込まれ、`core.hooksPath`は管理対象ディレクトリを指すようになります。以前に設定されていたpre-commitフックがあれば、その後に実行します。フックはコミット時にリポジトリとプロジェクトのルートを解決するため、リンクされたチェックアウトや空白を含むパスにも対応します。

このフックが実行するのは`vendor/bin/blockstudio-phpstan`だけです。ファイルのフォーマットや書き換えは行いません。`commit`を`false`に設定して再度同期するか、`blockstudio-githooks remove`を実行すると、記録済みのフックパスが復元され、Blockstudioが所有するファイルだけが削除されます。

### プロジェクトの仕様書

`blockstudio-agents`は、ブロックの保存場所、このプロジェクトでのページの定義、有効な機能、アナライザーが拒否する内容を記した`AGENTS.md`を書き込みます。

```bash
vendor/bin/blockstudio-agents
```

このドキュメントはテンプレートから作られるのではなく、プロジェクトから生成されます。`style.css`ヘッダーとブロック、ファイルに基づくページを持つテーマと、ブロックのみを登録するプラグインでは、異なる仕様書が生成されます。スキャナーが検出した件数、ディレクトリ、名前空間、テンプレート言語も記載されます。どの機能を記載するかは`blockstudio.json`で決まるため、静的事前レンダリングを使わないプロジェクトでは言及されません。

正確性のセクションは、選択したプリセットのルールファイルからレイヤーごとに読み込まれます。そのため、プリセットにルールが追加されると、それを使って生成されるすべての仕様書に反映されます。

所有権の扱いはコミットフックと同じです。生成マーカーのないファイルは、`--force`で許可されていない限り置き換えずに拒否されます。末尾のメモ領域は再生成後も維持され、仕様書が古い場合は`--check`が`1`で終了します。`--stdout`はファイルシステムに触れずに仕様書を出力します。

### ドキュメント索引

`blockstudio-llm.txt`は文書を連結する代わりに、索引になりました。公開済みの各ドキュメントは、セクションとサブセクションごとに1回ずつ記載され、ルート、そのソースファイル、1行の説明、管理する識別子（設定パス、フック名、PHPの関数とクラス、コマンド）が示されます。

```text
## Docs / Dev / Inspection Tools

### Canvas
route: /docs/dev/canvas
file: docs/docs/dev/canvas.md
purpose: A visual workspace and public inventory API for Blockstudio content.
settings: dev/canvas/enabled, ui
hooks: blockstudio/settings/dev/canvas/admin_bar, blockstudio/settings/dev/canvas/enabled
php: Blockstudio\Canvas, Canvas::documents(), Canvas::inventory()
```

エージェントはインデックスを読み、対象の識別子を管理するドキュメントを1つ見つけて、そのドキュメントを開きます。以前の約500KBの結合ファイルも引き続き生成され、`/blockstudio-llm-full.txt`で公開されますが、最初に渡されるものではなくなりました。

## 正規ブロックタグ

単独のコマンドで、プレフィックスとエイリアスの省略形を正規の`<bs:namespace-slug>`表記に書き換えます。この表記には実際のブロック名が記録され、プロジェクトフィルターを読み込まなくても解決できます。

`brand`のプレフィックスが`theme-components`に、`ui`のプレフィックスが`bsui`に対応している場合、この省略形は次のようになります。

```html
<brand-card>
  <ui-input />
</brand-card>
```

次と同じ意味です。

```html
<bs:theme-components-card>
  <bs:bsui-input />
</bs:theme-components-card>
```

プレフィックスと完全一致するエイリアスは引き続き使用でき、非推奨ではありません。このコマンドはWordPressを読み込まず、`--apply`なしでは何も書き込みません。

```bash
php vendor/blockstudio/blockstudio/bin/migrate-block-tags.php \
  --root="$PWD" \
  --prefix-map=/tmp/prefixes.json \
  --known-blocks=/tmp/blocks.json \
  --report=/tmp/tag-migration.json \
  --dry-run
```

`--prefix-map`は各プレフィックスを名前空間に対応付け、`--known-blocks`は登録済みのブロック名を一覧表示します。レポートには、出現数、ファイルごとのハッシュ、未知のタグ、曖昧なエイリアス、動的タグの個別一覧とともに、旧形式から正規形式への対応が記録されます。いずれかが残っている間、`--allow-unresolved`を渡さない限り`--apply`は書き込みを拒否します。

ペアタグ、ネストされたタグ、自己終了タグに対応し、PHP文字列内のリテラルタグも処理します。変更されるのはタグ名だけで、2回目の実行では変更は発生しません。コメント、コードフェンス、`<pre>`、`<code>`内の例はレポートのみの対象です。

## デフォルトの動作

7.6をインストールしても、それだけでは何も変わりません。

**パフォーマンスプロファイルのデフォルトは`compat`です。** head出力、oEmbed、XML-RPC、Heartbeat、画像のデフォルト設定、リンクの先読み、遅延読み込み、フロントエンドの`<title>`は、WordPressとテーマが設定した状態のままです。

**有効にするまで、次の機能は無効です。** すべての`performance.staticPrerender`、`performance.measurement`、`performance.media`、`themeDefaults`キーに加え、`githooks.commit`、`dev.canvas.enabled`、`ui.enabled`、`tailwind.enabled`、`blockTags.enabled`も対象です。無効の間、静的プリレンダリングはファイルを作成せず、ドロップインもインストールしません。

**CanvasとRenderは受動的に動作します。** 既存のレジストリを読み取り、呼び出し元から要求されたものだけをレンダリングします。どちらもフロントエンド出力にフックせず、ルートも登録しません。Canvasの管理画面には引き続き`dev.canvas.enabled`と`edit_posts`が必要です。

**より厳密な解析を行うには、明示的な指定が必要です。**`blockstudio/phpstan`をインストールしても有効になるのは基本拡張のみです。プロジェクトでプリセットを指定しない場合、正規コマンドは`base`を実行します。

**生成ファイルはコマンドの実行が必要です。**`githooks.commit`は`blockstudio-githooks sync`を実行するまで何もせず、`AGENTS.md`も`blockstudio-agents`を実行するまで何もしません。

## 7.5からのアップグレード

要件に変更はありません。PHPは8.2以降、WordPressは6.7以降が必要です。

```bash
composer require blockstudio/blockstudio
```

**キャッシュは一度再構築されます。** ランタイムの識別情報にはBlockstudioのバージョンが含まれるため、アップグレード後の最初のリクエストではキャッシュが空の状態になり、古いオブジェクトが削除されます。`wp-content/uploads/blockstudio/tailwind/cache`内の古いTailwindキャッシュは削除できます。そこをglobで検索していたスニペットは、代わりに`Blockstudio\Runtime_Cache::purge('tailwind')`を呼び出してください。

7.6より前のフラットな`wp-content/blockstudio/cache/runtime`ディレクトリは、アクティブなパスから自動的に移動され、上限付きのWP-Cron処理で削除されます。そのため、デプロイのリクエスト中に大量の旧ロックファイルツリーを削除する必要はありません。

**生成ファイルには管理元があります。**`assets/media.json`はバージョン管理またはビルドステップに含めてください。ルートマップ、`advanced-cache.php`ドロップイン、`WP_CACHE`宣言は`earlyServe`が有効な間だけ存在し、プリコミットフックは同期済みの場合に限り存在します。それ以外の生成物はすべて`cache.path`以下に置かれるため、安全に削除できます。

**削除や名称変更はありません。**`bs_render_block()`、`bs_block()`、`Blockstudio\Pages`、`Blockstudio\Patterns`は、ファイルベースの正規コンテンツ領域として引き続き使用できます。

**機能ごとにロールバックできます。**`performance.profile`を`compat`に戻す、`staticPrerender.enabled`を`false`に戻す、`githooks.commit`を`false`と`sync`に戻す、`cache.enabled`を`false`に戻すことで、それぞれのレイヤーを1つずつ元に戻せます。

導入は次の順序がおすすめです。

1. `performance.profile`を`speed`に設定し、head出力、フィード、oEmbedやXML-RPCに依存するプラグインを確認します。
2. `assets/media.json`を生成し、テンプレートを`bs_media_image()`に移してから、`performance.media.lazy`を有効にします。
3. `earlyServe`を無効にしたまま`performance.staticPrerender`を有効にし、`wp bs prerender status`でアクセスを確認してから、`earlyServe`を有効にします。
4. プリセットを`githooks.commit`に設定する前に、`blockstudio-phpstan --preset theme`を問題がなくなるまで実行します。

## 詳細情報の掲載先

- [Canvas](https://blockstudio.dev/ja/docs/dev/canvas/)とその
  [インベントリおよびドキュメントAPI](https://blockstudio.dev/ja/docs/dev/canvas/#public-inventory-and-document-api)
- [レンダリング](https://blockstudio.dev/ja/docs/blocks/rendering/#structured-compositions-and-complete-documents)、
  [UIコンポーネント](https://blockstudio.dev/ja/ui/#public-inventory-and-examples)、および
  [UIコンポジション](https://blockstudio.dev/ja/ui/composition/)
- [設定](https://blockstudio.dev/ja/docs/general/settings/)と
  [パフォーマンス](https://blockstudio.dev/ja/docs/general/settings/#performance)
- [パフォーマンス](https://blockstudio.dev/ja/docs/production/performance/)、
  [キャッシュ](https://blockstudio.dev/ja/docs/production/caching/)、および
  [静的プリレンダリング](https://blockstudio.dev/ja/docs/production/static-prerendering/)
- [Tailwind CSS](https://blockstudio.dev/ja/docs/tailwind/#template-composition-helpers)
- [PHPStan](https://blockstudio.dev/ja/docs/dev/phpstan/)： [プリセット](https://blockstudio.dev/ja/docs/dev/phpstan/#analysis-presets)、
  [標準コマンド](https://blockstudio.dev/ja/docs/dev/phpstan/#canonical-command)、
  [管理対象のコミットフック](https://blockstudio.dev/ja/docs/dev/phpstan/#managed-commit-hook)、および
  [プロジェクトの契約](https://blockstudio.dev/ja/docs/dev/phpstan/#project-contract-for-coding-agents)
- [AI連携](https://blockstudio.dev/ja/docs/dev/ai/)：ドキュメントの索引と全文
- [移行](https://blockstudio.dev/ja/docs/dev/migration/v7/#canonical-block-tags)および
  [PHPフック](https://blockstudio.dev/ja/docs/blocks/hooks/php/)
