
Blockstudio 7.7では、WordPress投稿を作成せずにドキュメントを表示できる仮想ルートを追加し、対象を絞ったプリレンダリングビルドを改善しました。既存ブロックの編集とレンダリングの信頼性も向上しています。また、PHPStanのブロックタグ検査を拡張し、同梱のUIコンポーネント全体のアクセシビリティを改善しました。

ファイルを優先するワークフローに変更はありません。ブロックはテンプレートからレンダリングされ、ファイルベースのページは明示的なCLIまたはAPI同期によって変更されます。このリリースでは、訪問者や管理者のリクエスト時にページを自動同期する機能は導入していません。

要点は次のとおりです。

- **仮想ルート**: 投稿を作成したり、独自のリダイレクトハンドラーを書いたりせずに、コンポーネントギャラリー、カタログなどの完全なドキュメントを提供できます。
- **対象を絞ったプリレンダリングビルド**: HTTPビルドでは、各ページが使用するソースファイルを記録するため、次回のビルドでは影響を受けるルートだけをレンダリングできます。
- **キャッシュの保持**: キャッシュ済みページで古いスタイルシートを引き続き使えるようにし、未使用の早期配信マップ項目を調査または削除できます。
- **エディターの信頼性**: 複数選択したブロックはそれぞれの値を保持します。RichTextとサイドバーのフィールドで元に戻す・やり直す操作が機能し、継承されたコンテキストも正しいブロックに保持されます。
- **ファイルコンテンツの忠実性**: ネストされたリスト、セクション要素、インラインHTML、ショートコード、エスケープされた属性を、解析とレンダリング後も維持します。
- **PHPStanの改善**: プレフィックスタグ、エイリアス、マッピングされたページ要素、テンプレート変数を、プロジェクト独自の定義に照らして検査します。
- **アクセシブルなUI**: コントロールの状態が正しく公開され、ラベルで適切な入力欄を切り替えられます。リストおよびテーブルコンポーネントは、有効なHTML構造を使用します。
- **翻訳**: インストール済みのJavaScript翻訳がエディターと管理画面の概要で読み込まれ、これまで未翻訳だったフィールドコントロールも含まれます。

## 仮想ルート

ページによっては、エディターが所有する投稿ではなくデータから生成されます。たとえば、コンポーネントのリファレンスには独自のURLとドキュメントタイトルが必要でも、`wp_posts`の投稿として登録する必要はありません。

`Blockstudio\Virtual_Routes`を使ってドキュメントを登録します。

```php title="functions.php"
add_action('init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function () {
            get_header();
            echo bs_block([
                'name' => 'mytheme/card',
                'data' => ['heading' => 'Example card'],
            ]);
            get_footer();
        },
        ['title' => 'Component gallery']
    );
});
```

このルートは`/components/`を提供します。コールバックはBlockstudioの出力バッファ内で実行されるため、レンダリングされたブロックには通常のパイプラインを通じてスタイル、スクリプト、同梱のUIアセット、Tailwindの出力が適用されます。WordPressは、一致したルートを404にしたり、投稿へリダイレクトしたりしません。

URL群を扱うには、`prefix`を`true`に設定し、`match`コールバックを指定します。コールバックにはルート以下のパスが渡され、レンダラーが必要とする値を返します。`null`または`false`を返すと、リクエストはWordPressに引き渡されます。静的プリレンダリングビルドに含めるパスを一覧表示するには`urls`を使用します。単一の非プレフィックスルートは、デフォルトで自身のパスを含みます。

`Virtual_Routes::urls()`は、サイトマップを組み立てる連携機能向けに絶対URLを返します。仮想ドキュメントをWordPressの投稿サイトマップに自動追加することはありません。

詳しくは[Virtual Routes](https://blockstudio.dev/ja/docs/pages-and-patterns/pages/#virtual-routes)をご覧ください。完全なAPIとオプションが記載されています。

## より精密なプリレンダリングビルド

HTTPを使ったグラフモードのビルドでは、各ルートが使用したファイルを記録するようになりました。対象はWordPressテンプレート、レンダリングされたブロックのテンプレートとアセット、ファイルページの定義とレイアウト、および`blockstudio/render/dependencies`を通じて追加された依存関係です。

次回のビルドでは、`build_plan()`がこれらの依存関係を比較します。ブロックテンプレートを変更すると、その依存ルートが再レンダリング対象になり、関係のないページをすべて再ビルドする必要はありません。共有設定の変更は引き続きビルド全体に影響し、新規ルートと期限切れルートは従来どおりレンダリングされます。

データベースのみの変更は、ファイル依存関係として扱われません。デプロイ時にオプション、投稿、その他のデータベース値を反映するには、ビルドを強制するか、対象URLを明示的にレンダリングする必要があります。

このリリースでは、最初のレンダリング中にビルド識別情報が変化する問題、opcodeキャッシュに残る古い早期配信マップ、パスに`search`または`preview`が含まれるだけで有効なURLが除外される問題も修正しました。`Accept: text/markdown`を使用するMarkdownリクエストでは、キャッシュ済みのHTMLを迂回し、該当するレスポンスで`Vary: Accept`を送信します。

静的プリレンダリングでは、フックを登録するかどうかの判断時に、アクティブなテーマが登録したフィルターを考慮するようになりました。これにより、先行する設定の参照で機能が有効なままになることなく、テーマ側で無効にできます。

[静的プリレンダリング](https://blockstudio.dev/ja/docs/production/static-prerendering/)を参照してください。

## キャッシュの保持とメンテナンス

キャッシュ済みのHTMLページは、そのスタイルシートをコンパイルしたランタイム識別情報より長く残ることがあります。`cache.namespaceGrace`は、クリーンアップで廃止が初めて検出されてから、廃止済みの名前空間を保持する期間を制御します。

```json title="blockstudio.json"
{
  "cache": {
    "namespaceGrace": 777600
  }
}
```

この例では、廃止済みファイルを9日間保持します。デフォルトは1日です。現在使用中の名前空間と、デプロイ済みプリレンダリング成果物を提供している名前空間は、廃止対象から保護されます。

早期配信マップには、確認とクリーンアップのコマンドもあります。

```bash
wp bs prerender map status
wp bs prerender map prune --dry-run
wp bs prerender map prune
```

これらのコマンドは、削除済みサイトや存在しないディレクトリの項目を報告して削除します。マルチサイトのサイトを削除すると、その項目も削除されます。ルートドキュメントが見つからない場合は別途報告され、有効なサイトの項目全体が削除されることはありません。

保持期間の指針は[キャッシュ](https://blockstudio.dev/ja/docs/production/caching/)を、コマンドは[マップのメンテナンス](https://blockstudio.dev/ja/docs/production/static-prerendering/#warming-maintenance-and-observability)を参照してください。

## より信頼性の高いエディター

複数選択したブロックを編集しても、更新されるのはそのブロックだけになりました。保存時にはブロックごとのコンテンツ、キー、メタデータ、ロックが保持され、選択中のブロック間で属性がコピーされません。

RichTextの値はブロック属性に直接保存されるため、Gutenbergの元に戻す・やり直す操作に含められます。サイドバーのフィールドも同じ履歴に加わります。`InnerBlocks templateLock="false"`は実際の真偽値として渡され、外側の領域がロックされていてもコンテンツのロックを解除できます。

初回のプリロードには編集中の投稿のIDとタイプが渡されるため、テンプレートは最初のレンダリングから正しいメタデータを読み取れます。異なる親の下にある同一の子ブロックは、プリロードとレンダリングキャッシュでそれぞれ別の継承コンテキストを保持します。初回リクエスト中に属性やコンテキストが変更されても、プレビューが古いままになることはありません。

Blockstudioは、ブロックのルート間に非表示のレンダーマーカー要素を挿入しないようになりました。`.card + .card`のような隣接兄弟セレクターは、エディターでもフロントエンドと同じ要素間の関係を認識します。エディターのプレビューとインサーターのプレビューは、引き続き別々にレンダリングされます。

## サイト全体のオプションをより安全に保存

オプションに紐づくフィールドは引き続きサイト全体の値を提供しますが、投稿の保存時に、保存済みの値をすべて無条件で書き込むことはなくなりました。

- 下書き、承認待ち、非公開、予約投稿の保存では、公開中のサイトオプションを書き込みません。
- 公開済み投稿の保存では、その編集で変更された入力済みフィールドを書き込みます。
- 古いコピーをタイトルだけ変更して保存しても、サイト全体の新しい値は元に戻りません。
- フィールドがない場合やブロックが削除された場合でも、既存のオプションは削除されません。
- 明示的な`null`でオプションを削除できます。空文字列、`false`、ゼロ、空の配列は有効な値として保持されます。

アップグレード時に確認すべき主な動作変更です。連携機能が非公開投稿や下書きを使って公開中のオプションを更新していた場合は、そのオプションを明示的に書き込むか、公開済みの設定投稿を使ってください。投稿メタデータの保存には、公開済みに限る制約は適用されません。

保存ルールの詳細は[ストレージ](https://blockstudio.dev/ja/docs/blocks/storage/)を参照してください。

## ファイルコンテンツをそのまま保持

HTMLからブロックへのパイプラインでは、記述した構造がより多く保持されます。

- ネストされたリストは、親項目の内側にあるリストブロックになります。リストと項目のクラスは保持され、通常のフラットなリストは従来どおり出力されます。
- `main`、`header`、`footer`、`article`、`aside`は、ブロックレンダリングを迂回する生のHTMLではなく、元の要素を保持するグループブロックになります。
- マッピングされたリッチテキスト段落ではインラインのマークアップが保持され、画像のみの段落は対応する画像ブロックに変換され、ショートコードタグのコンテンツも保持されます。
- エスケープされた属性は一度だけデコードおよびエスケープされます。`InnerBlocks`、`RichText`、`useBlockProps`要素の属性も対象です。
- 引用符で囲まれた自己終了タグの属性内にある大なり記号も受け付けます。
- グローバルなHTML属性がフィールドとして宣言されていない場合、Blockstudioブロックのルートに渡されます。`wp bs pages sync`は、保存されているもののレンダリングされない属性を報告します。

Bladeを使ったページ、パターン、サイトエディターのテンプレートは`Blockstudio\Blade_Renderer`を通じてレンダリングされ、`illuminate/view` 8から12をサポートするようになりました。同じブロックを対象とする拡張ファイルはすべて登録されます。優先度、グループフィールド、対象リストは、ドキュメント化されたスキーマに従います。

ネストされたSCSSの依存関係も追跡されます。別のパーシャルからインポートされているパーシャルを編集すると、依存するスタイルシートのバージョンが変わり、再コンパイルが実行されます。

## PHPStanの改善

別途インストールする`blockstudio/phpstan`パッケージにより、ブロックタグの検証対象がプレフィックスタグとエイリアスタグ、マッピングされたページ要素、レイアウト、同梱のUIブロック、さらにオプションで他のプロジェクトのPHPソースにも広がります。名前空間の解決はランタイムと同じ方法で行われ、ハイフンを含む名前空間にも対応します。転送されたグローバルなHTML属性も受け付けます。

`$a`、`$block`、`$context`などのブロックテンプレート変数は、Blockstudioによって定義済みとして扱われます。PHPStan 2.3では、フィールドの型はnull合体と`isset()`の後も保持されます。テンプレートが独自の`$a`を割り当てる場合は、その型が維持されます。

これらの変更は`blockstudio/phpstan` 0.1.9に含まれます。プラグインとは別にパッケージを更新してください。PHPStan 2.1.47以降が必要です。

```bash
composer require --dev blockstudio/phpstan:^0.1.9
```

設定と解析プリセットについては、[PHPStan](https://blockstudio.dev/ja/docs/dev/phpstan/)を参照してください。

## アクセシビリティと翻訳

同梱のUIトリガーでは、実際のボタンで展開状態が公開されます。チェックボックス、スイッチ、ラジオボタンのラベルは、それぞれのコントロールに名前を付け、切り替えられるようにします。パンくずリスト、ページネーション、ナビゲーションメニュー、テーブルでは、リストやテーブルと子要素の間に無効なラッパー要素が挿入されなくなりました。

パスワードの表示切り替えでは押下状態が公開され、クリック領域も大きくなりました。入力欄は`autocomplete`を受け付け、パスワード入力欄には明示的なIDとアクセシブルなラベルを指定できます。カルーセルのビューポートはキーボードでフォーカスでき、スピナーとスケルトンのアニメーションは視差効果を抑える設定に従います。

エディターと管理画面の概要では、`blockstudio`テキストドメイン用にインストール済みのJavaScript翻訳が読み込まれます。属性メニューとプレースホルダー、コードポップアップの操作、画像とファイルのバッジを翻訳できるようになりました。翻訳がない文字列は英語のまま表示されます。

[UIライブラリ](https://blockstudio.dev/ja/ui/)と[翻訳の設定](https://blockstudio.dev/ja/docs/general/getting-started/#translations)を参照してください。

## ドキュメントとアップグレード

ドキュメントには、ドキュメントサイト、Content Sync、Site Editorテンプレート、ブロックタグ、アイランド、カスタムフィールドタイプ、デプロイ、事前レンダリング、レジストリの設定、分析ツール、UIアプリ画面に関するガイドが追加されました。ACF移行ガイドは、現在のACF登録方法とBlock Bindingsを反映しています。

カスタムpopulateの例では、サポート対象の単一引数による名前付きデータセットフィルターを使用するようになりました。アセットのドキュメントでは、フロントエンドのスタイルシートの順序と、ブロックCSSの後にテーマのオーバーライドを読み込む方法を説明しています。コントリビューター用の環境では、レジストリ認証情報なしで公開Font Awesomeパッケージを使います。

PHP 8.2とWordPress 6.7が引き続き最小要件です。既存のページコレクションを変更せずに、仮想ルートと新しいメンテナンスコマンドを利用できます。上記のオプションストレージの保存ルールを確認し、使用している場合は別パッケージのPHPStanを更新してください。また、これまでどおりページ同期は明示的に実行してください。

### 7.7.1 フォローアップ

7.7.1パッチにより、同期結果がより明確で安全になります。キーを使ったマージで投稿に変更がない場合、リビジョンは作成されず、更新日時も更新されません。既存の公開ステータスは維持され、ファイルによるタイトルとスラッグの置き換えが報告され、ロック済みまたは削除済みのページはCLIレポートに記載されます。Content SyncはPage Syncが所有する本文を識別し、既存のレビュー用コピーを保持します。また、このパッチはWordPressが所有する属性を競合するフィールドIDから保護し、他のフィルターが追加したエディタークラスも保持します。
