
Blockstudio 7.1は、v7の書き直し以降初の機能リリースです。v7で基盤を再構築し、7.1ではデータベース層、サーバー関数、スケジュールタスク、CLIを追加しました。ブロックフォルダーが、完全なアプリケーションになります。

新機能をすべて紹介します。

## コンポーネント

インサーターで編集者が使うブロックと、開発者がほかのものを作るための部品として使うブロックとの間には、常に緊張関係がありました。カード、バッジ、統計ウィジェット、フォーム入力欄などです。これらには完全なBlockstudioパイプライン（属性、テンプレート、アセット、Tailwind）が必要ですが、インサーターに表示する必要はありません。

7.1では、この問題を解決するコンポーネントを導入しました。block.jsonで`"component": true`を設定すると、ブロックはビルドパイプライン全体を通りますが、WordPressのブロックタイプレジストリには登録されません。インサーターにも表示されず、JavaScriptに送られるエディターデータにも現れませんが、プログラムからのレンダリングには完全に利用できます。

```json title="block.json"
{
  "name": "my-theme/card",
  "title": "Card",
  "blockstudio": {
    "component": true,
    "attributes": [
      { "id": "title", "type": "text" },
      { "id": "description", "type": "textarea" }
    ]
  }
}
```

PHPからレンダリングします:

```php
bs_render_block([
  'name' => 'my-theme/card',
  'data' => ['title' => 'My Card', 'description' => 'Card content.'],
]);
```

または、新しいHTMLタグ構文を使います:

```html
<bs:my-theme-card title="My Card" description="Card content." />
```

## ブロックタグ

ブロックをHTMLタグとして埋め込めるようになりました。構文は相互に置き換えて使える2種類があります:

```html
<bs:acme-hero title="Welcome" />
<block name="acme/hero" title="Welcome" />
```

どちらも同じ出力になります。BlockstudioブロックとコアWordPressブロックの両方で使えます。ブロックテンプレート内では、明示的な有効化なしで自動的にレンダリングされます。つまり、テンプレート内でほかのブロックを直接組み合わせて、レイアウト全体を構成できます:

```twig title="index.twig"
<div class="my-page">
  <bs:mytheme-card title="Featured" />
  <block name="core/separator" />
  <bs:core-heading level="2">Section Title</bs:core-heading>
  <block name="core/group">
    <block name="core/paragraph">Inside a core group block.</block>
    <bs:mytheme-cta variant="primary" />
  </block>
</div>
```

2つの構文は自由に入れ子にできます。Blockstudioブロックは完全なパイプライン（テンプレート、Tailwind、アセット）を通してレンダリングされます。コアブロックは、[Pages and Patterns](https://blockstudio.dev/ja/docs/pages-and-patterns/)を支えるものと同じレンダラーを使い、WordPress経由でレンダリングされます。

投稿コンテンツやウィジェットエリアなど、ページ単位のレンダリングでは、`blockstudio.json`で有効にします:

```json
{ "blockTags": { "enabled": true } }
```

許可リストと拒否リストでは、ワイルドカードパターンを使って、タグ経由でレンダリングできるブロックを制御します。`data-*`属性と`html-*`属性は、レンダリングされたブロックのルートHTML要素に引き継がれます。カスタムレンダラーは`blockstudio/block_tags/renderers`フィルターから登録できます。

内部では、新しい軽量文字列スキャナーがDOMDocumentを完全に置き換え、タグを解析します。深さを追跡して入れ子タグを処理し、コンテナブロックを再帰的に扱い、1回の処理で混在構文にも対応します。ベンチマークでは、フラットなタグ1,000個を2.4ms、100階層の入れ子を3.7msで解析し、DOMDocumentと`WP_HTML_Tag_Processor`のWordPressの両方を一貫して上回りました。同じパーサーは[Pages and Patterns](https://blockstudio.dev/ja/docs/pages-and-patterns/)の生のHTML要素解析にも対応し、従来`<p>`、`<div>`、その他のHTML要素を処理していたDOMDocumentベースのパーサーを置き換えます。

## 新しいフィールドタイプ

### ブロック

別のBlockstudioブロックを属性として参照できる、新しい`block`フィールドタイプです。参照先ブロックのフィールドは、カスタムフィールドと同じように`idStructure`と`overrides`を使ってインライン展開されます。違いは、テンプレートで値にアクセスすると、レンダリング済みのブロック出力が返ることです。

```json title="block.json"
{
  "blockstudio": {
    "attributes": [
      {
        "id": "card",
        "type": "block",
        "block": "mytheme/card",
        "idStructure": "card_{id}"
      }
    ]
  }
}
```

`mytheme/card`に`heading`フィールドと`content`フィールドがある場合、ホストブロックのサイドバーには`card_heading`と`card_content`が表示されます。テンプレート内で`{{ a.card }}`を使うと、レンダリング済みのカードが出力されます。通常のブロックとコンポーネントの両方で動作します。

### HTMLタグ

テーマには、状況に応じて見出しレベルを変える必要があるブロックが必ずあります。ホームページではH1、下層ページではH2にするといった具合です。毎回ハードコードされた選択肢を持つセレクトフィールドを作る代わりに、プリセットを組み込んだ専用の`html-tag`フィールドタイプを用意しました。

```json
{
  "id": "tag",
  "type": "html-tag",
  "default": "h2",
  "tags": "heading",
  "exclude": ["h5", "h6"]
}
```

プリセット: `heading`（h1-h6）、`text`（見出しとp、span、div）、`structural`（div、section、article、aside、main、header、footer、nav）、`all`。独自の配列を渡すこともできます。`exclude`を使うと、任意のプリセットから特定のタグを除外できます。

```twig
<{{ a.tag }}>{{ a.title }}</{{ a.tag }}>
```

## データベース

今回のリリースの中心となる機能です。任意のブロックディレクトリに`db.php`ファイルを追加すると、Blockstudioが5つのREST CRUDエンドポイントを生成し、スキーマに照らして書き込みをすべて検証し、ストレージバックエンドを自動管理します。また、`bs.db()`のJavaScriptクライアントと、APIPHP（`Db::get()`）の両方を提供します。マイグレーションファイルも、コントローラークラスも、ルート登録も不要です。

```php title="db.php"
return [
    'subscribers' => [
        'storage'    => 'table',
        'capability' => [
            'create' => true,
            'read'   => true,
            'update' => 'edit_posts',
            'delete' => 'manage_options',
        ],
        'fields' => [
            'email' => [
                'type'     => 'string',
                'format'   => 'email',
                'required' => true,
                'validate' => function ($value) {
                    if (str_ends_with($value, '@spam.com')) {
                        return 'This domain is blocked.';
                    }
                    return true;
                },
            ],
            'name' => ['type' => 'string', 'maxLength' => 100],
            'plan' => ['type' => 'string', 'enum' => ['free', 'pro']],
        ],
    ],
];
```

このスキーマだけで、作成、一覧取得、個別取得、更新、削除の各エンドポイントを備え、入力検証も行う、完全に動作するAPIが生成されます。

### ストレージ

用途に合わせて選べる5つのストレージバックエンド:

- **`table`**: `dbDelta()`で管理されるカスタムMySQLテーブル。スキーマにフィールドを追加すると、次回のページ読み込み時に列が追加されます。本番環境のデフォルトです。
- **`sqlite`**: ブロックの`db/`フォルダー内にある単一のSQLiteファイルです。実際のSQLクエリ、同時読み取り用のWALモードに対応し、完全にポータブルです。フォルダーをコピーすれば、データベースもコピーできます。
- **`jsonc`**: フラットファイル内に1行につき1つのJSONオブジェクトを保存します。人が読みやすく、バージョン管理に対応し、gitにも適しています。
- **`meta`**: 特定の投稿に紐づく、投稿メタ内のWordPressJSON配列です。
- **`post_type`**: 各レコードはカスタム投稿タイプのWordPress投稿になります。フィールドは個別の投稿メタエントリーとして保存され、`WP_Query`で完全にクエリできます。

### クライアント

JavaScript側では、`bs.db()`が完全なCRUDクライアントを提供します:

```js
const db = bs.db('my-theme/block', 'subscribers');
const record = await db.create({ email: 'a@b.com', plan: 'pro' });
const pros = await db.list({ plan: 'pro' });
await db.update(record.id, { plan: 'free' });
await db.delete(record.id);
```

それに加えて、3つの補助ユーティリティも利用できます:

- **`bs.cache`**: `get`、`set`、`invalidate`、`clear`に対応する、メモリ内クエリキャッシュです。すべてのクエリ呼び出しとミューテーション呼び出しで共有されます。
- **`bs.query(key, fn, options)`**: 任意の非同期関数にキャッシュ、リクエストの重複排除、設定可能な`staleTime`を追加します。リクエストの実行中に同じキーで複数回呼び出すと、同じPromiseが返ります。
- **`bs.mutate(options)`**: 楽観的ミューテーションを処理し、失敗時には自動でロールバックします。リアクティブな状態オブジェクト、アクション（`create`、`update`、`delete`）、楽観的データを渡します。UIは即座に更新されます。サーバー呼び出しに失敗すると、状態はミューテーション前のスナップショットに戻ります。

これらを組み合わせると、読み書きのサイクル全体をカバーできます。キャッシュされた読み取りには`bs.query`、楽観的な書き込みには`bs.mutate`、手動制御には`bs.cache`を使います。

PHP側では、`Db`クラスが同じ操作を提供します:

```php
use Blockstudio\Db;

$db = Db::get('my-theme/block', 'subscribers');
$db->create(['email' => 'a@b.com', 'plan' => 'pro']);
$db->list(['plan' => 'pro']);
```

### バリデーション

バリデーションエラーは、Zodの`fieldErrors`形式を参考にした、フィールドごとのエラー配列として返されます。同じフィールドで複数のルールに違反することがあり、フロントエンドのフォームフィールドにエラーを簡単に割り当てられる構造です:

```json
{
  "data": {
    "status": 400,
    "errors": {
      "email": ["Must be a valid email address.", "This domain is blocked."],
      "plan": ["Must be one of: free, pro."]
    }
  }
}
```

組み込みルールで対応できないドメインのブロック、フィールド間の検証、外部データの照会などには、カスタム`validate`コールバックをサーバー側で実行できます。

### ユーザー単位のデータ

ToDo、お気に入り、下書きなどユーザーごとのデータでは、`userScoped`を`true`に設定すれば、残りはBlockstudioが処理します。`user_id`カラムを追加し、作成時に自動設定して、すべてのクエリを現在のユーザーに絞り込みます。更新と削除では所有権を確認します。手動で`user_id`フィールドを設定したり、`before_create`フックを使ったり、RPCで絞り込んだりする必要はありません。設定は1行だけです。`post_type`ストレージでは、`userScoped`は独立したカラムではなく`post_author`にマッピングされます。

```php
return [
    'storage'    => 'sqlite',
    'userScoped' => true,
    'fields'     => [ /* ... */ ],
];
```

### リアルタイムポーリング

スキーマで`'realtime' => true`を設定すると、クライアントが自動的に変更をポーリングします。サーバー側で変更があると、Interactivity APIストアが更新され、UIが再レンダリングされます。手元でJavaScriptを変更する必要はありません。カスタム状態キーと間隔は`'realtime' => ['key' => 'todos', 'interval' => 5000]`で設定できます。ポーリングではハッシュ比較を使ってリクエストを軽量化し、ブラウザーのタブが非表示の間は一時停止します。

### セキュリティ、フック、ポータビリティ

公開エンドポイントには、`X-BS-Token` CSRFヘッダーが自動的に挿入され、保護されます。受信Webhookなど、認証を完全に不要にする必要がある場合は`'open'`を使います。

ライフサイクルフックは、すべての書き込み操作の前後に実行されます。`db.php`内でインライン定義するか、WordPressアクションでグローバルに定義できます。

フィールドに`component`キーを定義すると、`bs_db_form()`を使ったスキーマ駆動のフォームレンダリングに利用できます。

SQLiteまたはJSONCストレージを使うと、コード、ロジック、アクセス制御、データを含むアプリケーション全体が1つのフォルダーに収まります。フォルダーをコピーするだけでデプロイできます。

## RPC

CRUDだけでは足りない場合もあります。ToDoの切り替え、通知の送信、統計の集計など、独自のサーバーロジックが必要です。そのための機能が`rpc.php`です。PHP関数を定義して、フロントエンドから`bs.fn()`で呼び出すと、BlockstudioがRESTエンドポイント、認証、CSRF保護、JSONシリアライズを処理します。このパターンは[tRPC](https://trpc.io)に着想を得ています。プロシージャをサーバー側で定義し、クライアントから名前で呼び出します。

```php title="rpc.php"
return [
    'subscribe' => function (array $params): array {
        $email = sanitize_email($params['email']);
        return ['success' => true];
    },
];
```

```js
const result = await bs.fn('subscribe', { email: 'user@example.com' });
```

インラインスクリプト（`script-inline.js`）は、スクリプトタグの`data-block`属性からブロック名を自動判定するため、手動で渡す必要はありません。モジュールスクリプトでは第3引数として渡します。

アクセス制御には、`public`（CSRF保護あり）、`'open'`（保護なし）、権限文字列、配列を指定できます。関数ごとのHTTPメソッド制御、ライフサイクルフック、JSとPHPの両方からのブロック間呼び出しにも対応しています。

## Cron

バックグラウンドタスクは`cron.php`ファイルで定義します。スケジュールとコールバックを設定すると、Blockstudioが初期化時にWordPress Cronへ登録します。プラグインを無効化すると、スケジュールはすべて適切に解除されます。

```php title="cron.php"
return [
    'cleanup' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db = Db::get('my-theme/app', 'logs');
            // delete old entries
        },
    ],
    'sync' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // pull from external API
        },
    ],
];
```

組み込みのWordPressスケジュールすべてに対応し、`cron_schedules`フィルターで独自の間隔も追加できます。

## CLI

新しい`wp bs`コマンドで、ブロック、データベース、RPC、cron、設定、Tailwindのコンパイル、SCSSのコンパイル、カスタムフィールド、アセット管理など、Blockstudio機能一式を利用できます。

```bash
wp bs blocks list --components
wp bs db schemas
wp bs db create my-theme/app subs --email=a@b.com
wp bs db list my-theme/app subs --plan=pro --format=json
wp bs rpc call my-theme/app subscribe --email=a@b.com
wp bs cron run my-theme/app cleanup
wp bs tailwind compile --file=template.html
wp bs scss compile --file=style.scss
wp bs fields list
wp bs assets list --type=global
wp bs settings get tailwind/enabled
```

すべてのコマンドは、スクリプトから実行するための`--format=json`に対応しています。

## リピーターの改善

### オブジェクトフィールドのtextMinimized

折りたたまれたリピーター行で、オブジェクト型フィールドの値を適切に扱えるようになりました。以前は、`textMinimized`をリンクフィールドに指定すると、`[object Object]`が表示されていました。現在はBlockstudioがフィールドタイプに応じた適切なサブプロパティを自動で読み取ります。リンクには`title`、色とグラデーションには`value`、アイコンには`icon`を使います。`key`プロパティを明示して、任意のサブプロパティを読み取ることもできます。

```json
{
  "type": "repeater",
  "textMinimized": { "id": "href", "fallback": "Add a link" },
  "attributes": [{ "id": "href", "type": "link" }]
}
```

### RichTextとMediaPlaceholder

両方のテンプレートコンポーネントが、正しい行を指定する角括弧記法を使って、リピーターフィールド内で動作するようになりました。リピーターの各行で、見出しや段落をインライン編集したり、メディアのアップロード領域を使ったりできます。

```twig
{% for item in a.items %}
  <div class="card">
    <MediaPlaceholder attribute="items[{{ loop.index0 }}].image" />
    <RichText tag="h2" attribute="items[{{ loop.index0 }}].heading" />
    <RichText tag="p" attribute="items[{{ loop.index0 }}].content" />
  </div>
{% endfor %}
```

## idStructureによるカスタムフィールドの条件

`idStructure`を使うカスタムフィールドでは、フィールド定義内の条件IDが展開後の名前に一致するよう、自動で書き換えられるようになりました。フォントサイズのフィールドグループで`enable`を条件に使い、`idStructure: "title_font_{id}"`で展開すると、その条件は元の`enable`ではなく`title_font_enable`を正しく参照します。

参照レベルの条件にも対応しました。カスタムフィールド参照に`conditions`を追加すると、展開されるすべてのフィールドに一度に適用できます。

## 動的なpopulate引数

populate引数で`{attributes.*}`構文を使い、ほかのブロック属性を参照できるようになりました。参照先の属性が変わると、セレクトフィールドの選択肢が自動的に再取得されます。セレクトを連鎖させることもできます。1つ目で投稿タイプを選び、もう1つでそのタイプの投稿を読み込みます。

```json
{
  "id": "selected_post",
  "type": "select",
  "populate": {
    "type": "query",
    "query": "posts",
    "arguments": {
      "post_type": "{attributes.post_type}"
    }
  }
}
```

`post_type`を「page」に変更すると、2つ目のセレクトに固定ページが読み込まれます。「post」に変更すると、投稿が読み込まれます。あらゆるpopulateタイプ、あらゆる属性で動作します。

## Composer

Blockstudioを、プラグインディレクトリに限らず`wp-content/`以下のどこから読み込んでも動作するようになりました。アセットURLは`plugins_url()`ではなく`BLOCKSTUDIO_URL`定数で解決されるため、テーマに同梱したインストールでもそのまま動作します:

```php title="functions.php"
require_once __DIR__ . '/vendor/autoload.php';
require_once __DIR__ . '/vendor/blockstudio/blockstudio/blockstudio.php';
```

`composer.json`のランタイム依存関係を整理しました。`lib/`にすでにバンドルされているスコープ付きパッケージ（TailwindPHP、ScssPhp、Minify）は、ランタイム依存関係の一覧から削除されました。残るのは`php >= 8.2`と`plugin-update-checker`だけです。

3つのインストール方法（プラグインZIP、Composer経由のプラグイン、Composer経由でテーマに同梱）のいずれでも、最終的に同じ状態になります。WordPressが完全に有効化され、ブロックが登録され、フロントエンドでレンダリングされます。

セットアップ手順は[Composerのドキュメント](https://blockstudio.dev/ja/docs/dev/composer/)をご覧ください。

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

任意のページURLに`?blockstudio-perf`を追加すると、下部にデバッグパネルが表示されます。ブロックごとのレンダリング時間、フェーズ別の内訳、キャッシュヒット率を確認できます。計測データはServer-Timingヘッダーにも送信され、ブラウザーのDevToolsのNetworkタブで確認できます。

```json title="blockstudio.json"
{ "dev": { "perf": true } }
```

設定から常時有効にすると、ページ読み込みのたびにプロファイリングできます。`edit_posts`権限を持つログイン済みユーザーにのみ表示されます。

自己終了型のブロックタグもメモリ内でキャッシュされるようになりました。同じ属性のブロックがページ内に複数回現れる場合、2回目以降のレンダリングではテンプレートパイプライン全体が省略されます。

## バグ修正

- **PHP 8.4の非推奨警告**: `null`を`add_submenu_page()`に渡したことが原因の`strpos()`と`str_replace()`の非推奨警告を修正しました。

## その他

- **SCSSのコードフィールド**: コードフィールドが`language: "scss"`に対応しました。値はエディターとフロントエンドの両方でScssPhpを通してコンパイルされます。
- **標準のWordPressブロック**: Blockstudioディレクトリには、Blockstudioブロックに加えて`@wordpress/create-block`出力を含められます。個別のプラグインコードなしで自動登録されます。

---

フルスタックのパターンを実際に見たい方は、[フルスタックブロックのガイド](https://blockstudio.dev/ja/guides/full-stack-blocks/)をご覧ください。ユーザー単位のToDoアプリと、公開ニュースレター登録フォームをゼロから作る手順を紹介しています。
