コンテンツへスキップ

Dennis · 2026年4月10日

Blockstudio 7.2

Blockstudio 7.2では、フレームワークを2つの方向に同時に拡張しました。

1つ目は、単一プロジェクト内の可視性とワークフローです。新しい管理画面の概要、データベースブラウザー、管理画面用レジストリブラウザー、共通のSass設定用のSCSSプリリュードを追加しました。

2つ目は、Blockstudioを取り巻くエコシステムです。ブロック配布用のレジストリCLI(WordPress向けのshadcnのようなもの)と、テンプレート、ブロックタグ、db.php、rpc.php、cron.php、関連するスキーマファイルにTypeScript形式の型安全性をもたらすPHPStan拡張機能を追加しました。

どちらの拡張も目指すところは同じです。大規模なBlockstudioプロジェクトを理解しやすくし、開発や拡張、共有をしやすくします。

管理画面の使いやすさ

2つの機能を追加し、wp-admin内で大規模なプロジェクトを見渡しやすくしました。

管理画面の概要

Blockstudioに、ツール > Blockstudioの管理画面を追加しました。ファイルシステムからシステムに登録された内容を、1か所で確認できます。

概要には、次の専用タブがあります:

  • ブロック
  • 拡張機能
  • フィールド
  • ページ
  • スキーマ

この概要に加えて、管理画面にデータベース専用セクションを追加しました。登録済みのBlockstudio\Dbスキーマをすべて一覧表示し、wp-admin内で実際のレコードを直接確認できます。

独自のパネルグリッドを作る代わりに、この画面ではWordPress標準のDataViewsテーブルを使っています。これにより、UIがwp-adminと統一され、登録項目が数十から数百に増えたプロジェクトでも実用的に利用できます。

小規模なインストールなら、実行時の状態を頭の中で把握できます。コードベースが大きくなると、それは難しくなります。次のような疑問が出てきます:

  • 現在、実際に登録されているブロックはどれか?
  • どの拡張機能がcore/*を対象とし、どれが個々のブロックを対象とするか?
  • 同期済みのページはどれで、それぞれどの投稿タイプに属するか?
  • このプロジェクトには、どの再利用可能なフィールドがあるか?
  • どのスキーマが登録され、どのストレージバックエンドを使っているか?

これまでは、フォルダーを調べ、JSONファイルを開き、PHPをたどって確認する必要がありました。この概要によって、管理画面で実際に確認できるようになりました。

各タブは、それぞれ異なる疑問に答えるよう設計されています:

  • ブロックには、登録済みのブロックタイプ、レンダリングモード、APIのバージョン、属性数が表示されます
  • 拡張機能には、対象ブロック、優先度、レンダリングの詳細が表示されます
  • フィールドでは、再利用可能なカスタムフィールド定義を一覧できます
  • ページには、ファイルベースの同期済みページと、投稿タイプ、ステータス、テンプレートエンジン、同期状態が表示されます
  • スキーマには、登録済みストレージスキーマと、バックエンド、フィールド数、権限の範囲が表示されます

データベースブラウザーは、初期概要ペイロードとは意図的に分離されています。ページ読み込み時にすべての行をシリアライズする代わりに、利用可能なスキーマだけを最初に読み込み、データベースタブを開いたときに必要なレコードを取得します。これにより、db.phpの背後に大規模なデータセットがあるプロジェクトでも、管理画面を快適に使えます。

この初版は、スキーマに基づく登録の確認に意図的に絞っています。設定ページではなく、確認ページです。

まったく使わない場合は、完全に無効にできます。

PHP
add_filter('blockstudio/admin/enabled', '__return_false');

管理画面のレジストリブラウザー

概要の隣には、2つ目のタブ Registry があります。テーマのblocks.jsonで設定したリモートブロックレジストリを閲覧でき、WordPressの管理画面からCLIに触れることなく、ブロックを直接インポートできます。

JSON
{
  "directory": "blockstudio",
  "registries": {
    "ui": "https://blocks.example.com/registry.json",
    "private": {
      "url": "https://api.example.com/registry.json",
      "headers": {
        "Authorization": "Bearer ${REGISTRY_TOKEN}"
      }
    }
  }
}

ブラウザーは設定済みの各レジストリからデータを取得し、利用可能なブロックをすべて一覧表示して、ローカルにインストール済みか、インポート可能かを示します。各行にはインポートボタンがあり、ブロックのファイルをテーマで設定したディレクトリにダウンロードできます。インストール済みのブロックには、代わりに再インポートボタンが表示されます。

headersを含むオブジェクト形式を使った認証付きレジストリにも対応しています。${ENV_VAR}の展開も利用できるため、トークンがバージョン管理に含まれることはありません。

これにより、レジストリの閲覧と利用が単なるCLIのワークフローではなく、管理画面の中核的な機能になります。

レジストリ CLI

レジストリ機能のもう半分は、スタンドアロンのCLI、blockstudio/registryです。

WordPressブロック向けのshadcn風ツールです。npmパッケージもビルド手順も必要ありません。コマンドを実行すると、ブロックのソースコードがプロジェクトにコピーされ、完全に自分のものになります。

シェル
npx blockstudio init
npx blockstudio add ui/tabs

CLIはあらゆる種類のブロックに対応します。Blockstudioブロック、@wordpress/create-block出力、通常のPHPブロックを扱えます。レジストリはフォルダーの中身を問いません。registry.jsonからファイルマニフェストを読み取り、そこに記載されたファイルだけをコピーします。

ブロックの作者は、任意のURL(GitHubの生コンテンツ、S3、カスタムサーバーなど)にregistry.jsonを公開し、利用可能なブロックのメタデータ、依存関係、ファイル一覧を掲載します。ユーザーはURLをblocks.jsonに追加し、名前を指定してブロックを取得します。

CLIは次の機能に対応しています。

  • 依存関係の解決: ブロックは他のブロックへの依存関係を宣言でき、循環を検出しながら自動的に解決します
  • 複数レジストリ間の競合処理: 同じブロック名が複数のレジストリにある場合、CLIが選択を促します
  • 認証付きレジストリ: 環境変数の展開に対応したベアラートークン、基本認証、カスタムヘッダー
  • 対話型TUI: Inkで構築され、スピナー、選択プロンプト、進行状況インジケーターを備えています
  • 非対話モード: --yesフラグと、CIやパイプ入力時の自動フォールバック
  • 検索と一覧表示: コマンドラインからレジストリを閲覧できます

このパッケージには、スキーマ、依存関係の解決、HTTPの取得、ファイル書き込み、すべてのコマンドフロー、対話型Ink UIを網羅する130件のテストが含まれています。

詳しいドキュメントはblockstudio.dev/registryをご覧ください。

PHPStan拡張機能

もう1つの大きな追加機能はblockstudio/phpstanです。PHPStan拡張機能により、BlockstudioのユーザーもTypeScriptの開発者が期待する型安全性を得られます。

シェル
composer require --dev blockstudio/phpstan

この拡張機能は解析時にプロジェクトの実際のスキーマを読み込み、そこから得た型をPHPStanに渡します。これにより、PHPテンプレート、Twig、Blade、ブロックタグ、型付きデータベースレコード、設定パス、フック名に加え、block.json、field.json、拡張機能JSON、page.json、db.php、rpc.php、cron.php、blockstudio.jsonにわたるスキーマ検証にも対応します。

型安全なブロックテンプレート

$aでのフィールドアクセスは、対応するblock.jsonに基づいて検証されます。

PHP
<?php
/** @var array<string, mixed> $a */

echo $a['title'];     // OK
echo $a['cta']['href']; // OK
echo $a['typo'];      // ERROR: Field "typo" does not exist in block.json (block: hero). Did you mean "title"?

型安全なデータベースレコード

Db::get()は、db.phpスキーマに基づく型付きインスタンスを返します。レコードの構造は実際のフィールドから構築されます。

PHP
return [
  'storage' => 'table',
  'fields' => [
    'email' => ['type' => 'string', 'required' => true],
    'name'  => ['type' => 'string'],
  ],
];
PHP
$db = Db::get('mytheme/subscribers');
$record = $db->create(['email' => 'a@b.com']);

echo $record['email']; // PHPStan: string
echo $record['name'];  // PHPStan: string|null
echo $record['typo'];  // ERROR: Offset 'typo' does not exist on array{id: int, email: string, name: string|null}

スキーマ検証

無効なスキーマファイルは解析時に検出されます。対象はblock.json、field.json、拡張機能JSON、page.json、db.php、rpc.php、cron.php、blockstudio.jsonです。名前の欠落、フィールド型の誤り、定義の形式不備、非推奨の省略形ブール値(入れ子のオブジェクトの代わりに"tailwind": trueを使用)を、ソースファイル内の正確な行番号とともに報告します。

設定パスの検証

Settings::get()の呼び出しは、既知の設定スキーマに基づいて検証されます。

PHP
Settings::get('tailwind/enabled');  // OK, returns bool
Settings::get('tailwind/enabld');   // ERROR: Settings path "tailwind/enabld" is not a known Blockstudio setting. Did you mean "tailwind/enabled"?

フック名の検証

フィルターフック名とアクションフック名も同様に検証されます。

PHP
add_filter('blockstudio/render', $cb);  // OK
add_filter('blockstudio/rendrr', $cb);  // ERROR: Unknown Blockstudio hook "blockstudio/rendrr". Did you mean "blockstudio/render"?

この拡張機能には、Blockstudioの公開API全体をカバーするスタブも含まれています。対象はDb、Settings、Field_Registry、Build、グローバルヘルパーです。開発マシンにプラグインのソースがなくても、すべてのBlockstudio APIで自動補完と型チェックを利用できます。

作成を便利にする機能

このリリースには、作成を便利にする小さな機能が2つ加わりました。

グローバルSCSSプリアンブル

BlockstudioはすでにSCSSのコンパイルに対応していましたが、共有Sass設定には不便な点がありました。

共通の変数、関数、ミックスインを使うには、すべてのSCSSファイルでインポートする必要がありました。特に大規模なデザインシステムやBootstrapのようなSassツールキットでは、すぐに手間が増えてしまいます。

7.2では、この問題を解決するプリアンブルフックが追加されました。

PHP
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
  return '@import "functions";' . "\n"
    . '@import "variables";' . "\n"
    . '@import "mixins";';
}, 10, 3);

既存のblockstudio/assets/process/scss/import_pathsフィルターと組み合わせれば、共有Sass環境を一度定義するだけで、コンパイルされるすべてのファイルから利用できます。

ブロックのスタイルシートには、実際に必要なスタイルだけを記述できます。

Scss
.hero {
  @include media-breakpoint-up(lg) {
    padding: 4rem;
  }
}

ブロックのアセットごとにインポートを繰り返す必要はありません。これは「Bootstrap対応」という特別なモードではなく、Bootstrapでも独自の内部ツールキットでも使える、プロジェクト全体でSassを共有するための汎用フックです。

PHPネイティブのブロックAPI定義

7.2では、フルスタックのブロックAPI向けに、任意で使えるPHPネイティブ構文も追加されました。配列は引き続きデフォルトであり、完全にサポートされています。既存の形式が置き換わることはありません。名前付き引数、列挙型、属性を入れ子の設定配列より好む場合は、この形式を選べるようになりました。

rpc.phpでは、属性付きメソッドを持つオブジェクトを返します。

PHP
<?php
use Blockstudio\Attributes\Rpc;
use Blockstudio\Rpc\Access;
use Blockstudio\Rpc\Method;

return new class {
    #[Rpc(access: Access::Session)]
    public function subscribe(array $params): array {
        return ['success' => true];
    }

    #[Rpc(name: 'status', methods: [Method::Get, Method::Post])]
    public function getStatus(array $params): array {
        return ['status' => 'ok'];
    }
};

cron.phpでは、同じ考え方を#[Cron]で使えます。

PHP
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;

return new class {
    #[Cron(schedule: Schedule::Hourly)]
    public function heartbeat(): void {
    }
};

db.phpでは、小さなビルダーレイヤーが追加されました。

PHP
<?php
use Blockstudio\Db\Field;
use Blockstudio\Db\Schema;
use Blockstudio\Db\Storage;

return Schema::make(
    storage: Storage::Table,
    fields: [
        'email' => Field::string(required: true, format: 'email'),
        'active' => Field::boolean(default: false),
    ],
);

これにより、大規模なコードベースでバランスが良くなります。必要なときは配列形式のシンプルさを保ちつつ、ブロックが少数のフィールドやエンドポイントを超えて大きくなったら、見つけやすいPHP形式に切り替えられます。

これらの機能をまとめてリリースする理由

管理画面の概要、レジストリブラウザー、レジストリCLI、PHPStan拡張機能は、どれも同じ問いへの答えです。Blockstudioプロジェクトが大きくなっても、どうすれば理解しやすい状態を保てるでしょうか。

管理ツールはプロジェクトの視点から答えます。何が登録されているかを把握でき、レジストリからブロックを取り込めるため、推測に頼る場面が減ります。

CLIはエコシステムの視点から答えます。npmパッケージにまとめたり、ビルドシステムと格闘したりせずに、プロジェクトやチーム間でブロックを共有できます。

PHPStan拡張機能はコードの視点から答えます。誤ったフィールドアクセス、スキーマのタイプミス、壊れたフックコールバックを、実行時に問題となる前に検出できます。

7.2全体の方向性は、推測や繰り返しを減らし、可視性を高め、さらに実際の型安全性を加えることです。

バグ修正

  • Classesフィールド: ユーザーが入力したカスタムクラス名は、バリデーターが事前定義済みのTailwind/設定リスト内のクラスしか受け付けなかったため、フォーカスを外すと黙って破棄されていました。現在は空でない文字列をすべて受け付けます。
  • Attributesフィールド: 属性のペアを削除しても、保存データにnullエントリーが残っていました。配列要素をnullにするlodash unset()から、要素を削除するsplice()に切り替えました。
  • CSSミニファイア: TailwindPHPミニファイアが、calc()とclamp()内の+の前後の空白を削除し、calc(1rem+0.5vw)のような無効なCSSを生成していました。括弧の深さを考慮して文字を走査し、深さ0のセレクター結合子の前後だけ空白を削除する修正をTailwindPHP v1.3.1で行いました。
  • ブロックインサーターのプレビュー: レンダリングキャッシュのハッシュキーにレンダリングモードが含まれていなかったため、ブロックインサーターのプレビューで$isPreviewが常にfalseになっていました。エディターとプレビューのレンダリングで、別々のキャッシュエントリーを使うようになりました。
  • InnerBlocksの入れ子テンプレート: <InnerBlocks template="..."/>コンポーネントが、['core/group', {}, [['core/paragraph']]]のようなテンプレートタプルの3番目の要素(子要素)を破棄し、空のコンテナーブロックを生成していました。現在は入れ子の子要素を保持します。