
Blockstudio 7.3では、ブロックと同じようにレンダリングできる再利用可能なUIコンポーネントという新たな層が、フレームワークに加わります。

7.1ではブロックがフルスタックアプリケーションになり、7.2では大規模プロジェクトの確認、検証、配布が容易になりました。7.3では、そうしたアプリケーションの構築と編集を日々行う際の使いやすさに焦点を当てています。

要点は次のとおりです。

- **UIコンポーネント**: WordPress Interactivity APIを基盤とする、同梱されたオプトイン型の`bsui/*`コンポーネントライブラリ。
- **アプリ**: UIコンポーネントを組み合わせて大規模なインターフェースを構築する方法を示す、同梱の`app/*`の例。
- **拡張エディター**: サイドバーが狭すぎる場合にBlockstudioフィールドを編集できる、幅広のドロワー。
- **スコープ付きアセットセレクター**: CSSアセットとSCSSアセットでは、`%selector%`を使ってブロックのラッパークラスを直接指定できます。
- **プラグイン依存関係**: ブロックが、任意のバージョン条件とともに、有効なWordPressプラグインを必須として指定できます。
- **エディターポリシー**: `blockstudio.json`は、WordPressのPHPを利用するエディターフックで、グローバルブロック、パターン、メディアの動作を設定できます。
- **ブロックタグのエイリアス**: ブロックタグの作成に使えるカスタムエイリアス。
- **静的解析とドキュメント**: 外部ブロックライブラリに対するPHPStanの対応範囲を拡大し、設定とフックのドキュメントを生成。
- **ページとエディターの修正**: ファイルベースのページ解析、Tailwind候補の検出、リセットモード、レンダリングキャッシュの分離、エディターの事前読み込みを改善。

## UIライブラリ

7.3には、同梱のコンポーネントライブラリと、それを使ったアプリのサンプルが含まれています。

### UIコンポーネント

Blockstudio 7.3には、`bsui/*`名前空間のUIライブラリが同梱されています。コンポーネントは通常のBlockstudioブロックなので、既存のブロックタグ構文を使って、テンプレート、ファイルベースのページ、パターン、投稿コンテンツ内にレンダリングできます。

UIコンポーネントライブラリは、さらにフィードバックを集めるためベータ版です。7.3では最初のコンポーネントセットを公開し、実際のプロジェクトで得た知見をもとに、APIの仕様を安定版とする前に、名称、動作、デフォルト設定を見直すことを目指しています。

ライブラリはオプトイン方式です。

```json title="blockstudio.json"
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "ui": {
    "enabled": true
  }
}
```

有効にすると、シンプルなコンポーネントを直接レンダリングできます。

```html
<block name="bsui/button" label="Save" variant="default"></block>
<block name="bsui/badge" label="Beta"></block>
<block
  name="bsui/input"
  nameAlt="email"
  type="email"
  placeholder="Email"
></block>
```

短い`bs:`構文も使えます。

```html
<bs:bsui-button label="Save" variant="default" />
```

BlockstudioをページビルダーUIキットにすることが目的ではありません。一般的なUIの基本要素をブロックとして利用できるようにし、Blockstudioで構築したアプリケーションごとに、ボタン、ダイアログ、タブ、セレクト、フォームフィールド、メニュー、ツールバー、フィードバック用コンポーネントを作り直さずに済むようにすることが目的です。

最初のコンポーネントセットには、レイアウト、アクション、入力、オーバーレイ、ナビゲーション、フィードバック、フォーム、データ表示の基本要素が含まれています。

- `bsui/button`, `bsui/button-group`, `bsui/toggle`, `bsui/toggle-group`,
  `bsui/toolbar`
- `bsui/input`, `bsui/textarea`, `bsui/select`, `bsui/checkbox`,
  `bsui/radio-group`, `bsui/slider`, `bsui/switch`, `bsui/number-field`,
  `bsui/password-input`, `bsui/phone-input`, `bsui/otp-input`,
  `bsui/date-input`, `bsui/time-picker`
- `bsui/dialog`, `bsui/drawer`, `bsui/popover`, `bsui/menu`,
  `bsui/context-menu`, `bsui/menubar`, `bsui/tooltip`, `bsui/alert-dialog`
- `bsui/tabs`, `bsui/accordion`, `bsui/breadcrumb`, `bsui/pagination`,
  `bsui/navigation-menu`
- `bsui/card`, `bsui/table`, `bsui/stack`, `bsui/separator`,
  `bsui/aspect-ratio`, `bsui/badge`, `bsui/avatar`, `bsui/progress`,
  `bsui/meter`, `bsui/skeleton`, `bsui/spinner`, `bsui/kbd`
- `bsui/form`, `bsui/field`, `bsui/field-group`, `bsui/file-upload`,
  `bsui/color-picker`, `bsui/rating`

これらの多くは複合ブロックです。`bsui/tabs`ブロックがインタラクティブな状態を管理し、`bsui/tabs-list`、`bsui/tabs-trigger`、`bsui/tabs-panel`などの子ブロックが構造を定義します。

```html
<block name="bsui/tabs" defaultValue="features">
  <block name="bsui/tabs-list">
    <block name="bsui/tabs-trigger" value="features" title="Features"></block>
    <block name="bsui/tabs-trigger" value="pricing" title="Pricing"></block>
  </block>
  <block name="bsui/tabs-panel" value="features">
    <p>Features content.</p>
  </block>
  <block name="bsui/tabs-panel" value="pricing">
    <p>Pricing content.</p>
  </block>
</block>
```

これによりマークアップの読みやすさが保たれ、状態と動作はInteractivity APIによって処理されます。

### アプリの例

`app/*`名前空間には、同じUIコンポーネントで構築された例が含まれています。

これらは独立したフレームワークではありません。より大規模なBlockstudioインターフェースの参考実装です。複合ブロック、入れ子のUI、Interactivity APIによる状態管理、UIコンポーネントがRPCやデータベース連携機能と組み合わさる箇所を示します。

```html
<block name="app/kitchen-sink"></block>

<block name="app/chat">
  <block name="app/chat-sidebar"></block>
  <block name="app/chat-header"></block>
  <block name="app/chat-messages"></block>
  <block name="app/chat-input"></block>
</block>
```

UIライブラリには、独自のドキュメントとライブコンポーネントリファレンスも含まれています。コンポーネントの動作は、単なるテンプレートの集まりではありません。フレームワークの契約の一部として、ライブラリの拡大後も一貫性を保ちます。

## 作成と編集

ブロックの作成と編集を簡単にする変更がいくつか加わりました。

### 拡張エディター

インスペクターのサイドバーで複雑なブロックを編集する際は、すぐに手狭になります。特にリピーター、コードフィールド、リッチテキスト、入れ子のグループでは顕著です。

Blockstudio 7.3では、ブロックインスペクターに拡張エディターのアクションが追加されました。これを使うと、エディターの右側から幅広のドロワーが開き、同じBlockstudioフィールドが表示されます。

重要なのは、これも同じフィールドシステムを使う点です。フィールドの描画を複製せず、別の保存経路も追加しません。拡張エディターでの変更は、通常のサイドバーでの変更と同じように、選択中のブロックに反映されます。

サイドバーは項目をざっと確認するには十分でも、実際に入力するには狭いときに使ってください。

### スコープ付きアセットセレクター

Blockstudioはすでにコードフィールドで`%selector%`に対応していました。7.3では、ブロックのCSSアセットとSCSSアセットでも、同じ作成パターンを使えます。

CSSファイルでは、`%selector%`がブロックのスコープ付きクラスに展開されます。

```css title="style.scoped.css"
%selector% {
  --hero-gap: var(--wp--preset--spacing--space-10);
}

%selector%.hero {
  border-bottom: 1px solid currentColor;
}

.hero__title {
  color: red;
}
```

これにより、実際のラッパー要素をスタイル設定できます。

```php title="index.php"
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Hero</h1>
</section>
```

`*.scoped.css`内の通常のセレクターは、引き続き子孫要素を対象にします。`%selector%`はブロックのルート要素を明示的に指定するフックです。

### プラグイン依存関係

ブロックは`block.json`の`blockstudio`キー内で、WordPressプラグインへの依存関係を宣言できるようになりました。

シンプルな形式では、一覧にあるすべてのプラグインスラッグが有効かどうかを確認します。

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": ["woocommerce"]
  }
}
```

オブジェクト形式では、バージョン条件も指定できます。

```json title="block.json"
{
  "blockstudio": {
    "pluginDependencies": {
      "woocommerce": {
        "version": ">6"
      }
    }
  }
}
```

識別子にはWordPressのプラグインスラッグを使い、WordPressコアのプラグイン依存関係システムに合わせます。Blockstudioは有効なプラグインを対応するスラッグに解決し、必須プラグインが見つからない、無効になっている、または必要なバージョンを下回っている場合は登録をスキップします。

バージョン条件にはPHPの`version_compare()`と同じ比較方式を使います。`"6"`のような単一のバージョンは、`>=6`として扱われます。

これは、プラグインが利用できる場合にのみ意味を持つブロックで便利です。WooCommerceの商品カード、フォーム連携、SEO連携、会員向けコンポーネント、予約ウィジェット、サードパーティープラグインに結び付いた管理画面UIなどが該当します。

### エディターポリシー

`blockstudio.json`ファイルは、プロジェクトレベルのエディターポリシーを定義するファイルとしても役立つようになっています。

7.3ではPHPを基盤とする`blockEditor`ポリシーレイヤーが追加され、設定WordPressがサーバーサイドフック経由ですでに公開している機能を利用できます。これにより、個別対応のテーマ用コードを用意せずに、インサーター、パターン、メディアの動作を全体設定できます。

```json title="blockstudio.json"
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "blockEditor": {
    "blocks": {
      "allow": ["core/*", "my-theme/*"],
      "deny": ["core/embed", "core/freeform"],
      "directory": false,
      "categories": {
        "rename": {
          "text": "Writing",
          "design": "Layout"
        },
        "order": ["my-theme", "text", "media"]
      }
    },
    "patterns": {
      "core": false,
      "remote": false,
      "categories": {
        "deny": ["gallery"],
        "order": ["featured", "buttons"]
      }
    },
    "media": {
      "openverse": false,
      "imageSizes": {
        "allow": ["thumbnail", "large"]
      }
    }
  }
}
```

初期段階では、意図的にPHPで実現できる範囲に絞っています。許可・拒否するブロック、ブロックディレクトリの読み込み、インサーターのカテゴリー名と順序、パターンのソースとカテゴリー、Openverse、画像サイズの選択肢、レガシーウィジェットの表示、PHPで登録されたブロックスタイルの削除が対象です。

コアブロックの任意のデフォルト設定を書き換えるものではありません。`core/columns.isStackedOnMobile`のような設定は、ブロックエディターのJavaScript登録フロー内で扱われるため、JSONファイルに無理に詰め込まず、より明示的なAPIが別途必要です。

### ブロックタグのエイリアス

ブロックタグにエイリアスフィルターが追加されました。

```php title="functions.php"
add_filter('blockstudio/block_tags/tag_aliases', function ($aliases) {
    $aliases['theme-button'] = 'bsui/button';
    return $aliases;
});
```

これにより、プロジェクト内で作成しやすいタグを定義しながら、内部では正式なブロック名に解決できます。

```html
<bs:theme-button label="Continue" />
```

これは、正式なブロック名は正しくても、作成時に使いやすいとは限らないUIを多用するテンプレートを組み立てるときに特に便利です。

## ツールと信頼性

静的解析、信頼性、パフォーマンス関連のツールがそれぞれ強化されました。

### 静的解析とドキュメント生成

PHPStan拡張機能が、外部ブロックライブラリをスキャンするルートの明示指定に対応しました。これにより、現在のプラグインやテーマの外にあるブロックに対しても、`<bs:*>`タグと`<block>`タグを検証できます。解析時に、これらのルートはレジストリ専用として扱われます。

ページのメタデータと`pluginDependencies`に関するスキーマチェックも拡張され、リリース時の設定ミスがWordPressに反映される前に見つけやすくなりました。

ドキュメント生成で、設定用フィルターとPHPフックのリファレンスも出力されるようになりました。`blockstudio.json`が点在する数個の切り替え項目ではなく、実際のプロジェクトポリシーファイルになったことで、重要性が高まっています。

### ページとエディターの信頼性

7.3では、ファイルベースのページ、エディターのレンダリング、リセットモードに関する修正も行われています。

ファイルベースのページ解析で、HTMLの解析時に属性を考慮したカスタムコンテナーマッピングに対応しました。`bs:`のページタグもハイフンを含むブロック名前空間を正しく解決するため、`custom-theme/card`のような名前でもパーサーがつまずかなくなりました。

コア以外の汎用コンテナータグは、ラッパーマークアップを指定しない場合でも、有効な`innerContent`としてシリアライズされるようになりました。これにより、同期されたページコンテンツの予測可能性が高まり、WordPressのブロックシリアライズも有効に保たれます。

プレビューとプリロードの動作に関する一連の修正をエディターに加えました。

- TailwindエディターのCSSに、ファイルベースのページテンプレートのクラス候補が含まれるようになりました。
- エディターのプリロードで、同じ種類のブロックが繰り返される場合もRichTextラッパークラスが保持されます。
- 保存されたブロックマークアップでは省略されても、Gutenbergによってデフォルトのフィールド値が展開されるブロックと、エディターのプリロードが一致するようになりました。
- Gutenbergによって展開される登録済みのデフォルト属性は、レンダーキャッシュキーの比較前に無視されます。
- エディターとインサーターのプレビュー描画では、クライアントIDを共有していても、キャッシュエントリーが別々に保持されます。
- 再利用されたカスタムフィールドグループ（IDがカスタムフィールド名と一致するグループを含む）でも`bs_get_group()`が正しく動作し、グループの正確なプレフィックスだけを抽出するようになりました。
- `withCreateSuggestion`を持つリンクフィールドで、WordPressのLinkControl作成フローが正しく接続され、RESTAPIを使って下書きページが作成されるようになりました。
- PHPブロックテンプレートは、破棄される事前処理のインクルードを実行せず、レンダーごとに1回だけ実行されます。

リセットモードも強化しました。設定済みの投稿タイプではGutenbergエディターのブロック幅と縦方向のマージン規則を無効化し、必要に応じてWordPressのiframeコンテンツ／リセットスタイルを削除し、Blockstudioのホバー／選択オーバーレイをすっきり表示します。

複雑なInnerBlocksパターンの回帰テストも拡充し、ネストされたBlockstudioブロックを追加しました。手作業では確認しづらいパターン挿入ケースに対して、エディターの描画経路を検証できます。

### パフォーマンス計測ツール

ローカルの匿名`blockstudio-perf=1`プローブで、デバッグパネルを挿入せずに`Server-Timing`ヘッダーを出力できるようになりました。

計測対象のタイミングもビルドライフサイクル全体に広がり、検出、アセット処理、登録、オーバーライドをカバーします。これにより、目に見えるプロファイリングUIを有効にしなくても、実際に時間がかかっている箇所を把握しやすくなります。

## このリリースが重要な理由

7.3の主なテーマはコンポジションです。

UIコンポーネントにより、アプリケーションのインターフェースを組み立てやすくなります。拡張されたエディターでは、より大きなブロックを編集しやすくなりました。プラグイン依存関係により、ブロックが必要とするプラグインのコンテキストを宣言できます。エディターポリシーによって、プロジェクトレベルのブロックエディター規則を`blockstudio.json`に移せます。ブロックタグのエイリアスにより、テンプレートの記述も快適になります。パーサー、PHPStan、エディターの修正によって、これらの構成をWordPressに通した後も、より確実に動作します。

Blockstudioは引き続きファイルベースです。ブロックは引き続きフォルダーで構成され、テンプレートが引き続き処理を担います。その基盤の上に、フレームワークのUIレイヤーが強化されました。
