Aller au contenu

Dennis · 10 avril 2026

Blockstudio 7.2

Blockstudio 7.2 élargit le framework dans deux directions à la fois.

La première concerne la visibilité et le flux de travail au sein d’un même projet : une nouvelle vue d’ensemble de l’administration, un explorateur de base de données, un explorateur de registre d’administration et des préludes SCSS pour la configuration partagée de Sass.

La seconde concerne l’écosystème autour de Blockstudio : une extension CLI de registre pour distribuer des blocs (comme shadcn pour WordPress), et une extension PHPStan qui apporte aux modèles, balises de bloc, db.php, rpc.php, cron.php et fichiers de schéma associés le typage sûr de TypeScript.

Ces deux axes poursuivent le même objectif : faciliter la compréhension, l’évolution et le partage des projets Blockstudio de plus grande envergure.

Expérience d’administration

Deux nouveautés facilitent la navigation dans les projets plus importants depuis wp-admin.

Vue d’ensemble de l’administration

Blockstudio inclut désormais un écran d’administration sous Outils > Blockstudio. Il offre un emplacement unique pour examiner les éléments que le système a enregistrés depuis le système de fichiers.

La vue d’ensemble comporte des onglets dédiés pour :

  • Blocs
  • Extensions
  • Champs
  • Pages
  • Schémas

En plus de cette vue d’ensemble, l’espace d’administration comprend désormais une section Bases de données dédiée. Elle répertorie chaque schéma Blockstudio\Db enregistré et permet d’inspecter directement les enregistrements dans wp-admin.

Au lieu de créer une grille personnalisée de panneaux, l’écran utilise les tableaux DataViews natifs de WordPress. Cela permet à l’interface UI de rester cohérente avec wp-admin et la rend pratique même lorsque le projet compte des dizaines ou des centaines d’éléments enregistrés.

Dans une petite installation, vous pouvez garder en tête l’état d’exécution. Dans une base de code plus importante, ce n’est plus possible. Vous commencez à vous poser des questions comme :

  • Quels blocs sont actuellement enregistrés ?
  • Quelles extensions ciblent core/* et lesquelles ciblent des blocs individuels ?
  • Quelles pages sont synchronisées et à quels types de publication appartiennent-elles ?
  • Quels champs réutilisables existent dans ce projet ?
  • Quels schémas sont enregistrés et quel moteur de stockage utilisent-ils ?

Jusqu’à présent, il fallait combiner l’examen des dossiers, l’ouverture de fichiers JSON et l’analyse de PHP. La vue d’ensemble transforme cela en une véritable interface d’administration.

Chaque onglet est conçu pour répondre à des questions différentes :

  • Blocs : types de blocs enregistrés, mode de rendu, version API et nombre d’attributs
  • Extensions : blocs ciblés, priorité et détails du rendu
  • Champs : aperçu des définitions de champs personnalisés réutilisables
  • Pages : pages synchronisées à partir de fichiers, avec type de publication, état, moteur de modèles et état de synchronisation
  • Schémas : schémas de stockage enregistrés, avec moteur, nombre de champs et portée des permissions

L’explorateur de bases de données est volontairement séparé de la charge utile de la vue d’ensemble initiale. Au lieu de sérialiser chaque ligne au chargement de la page, il ne localise d’abord que les schémas disponibles, puis récupère les enregistrements à la demande lorsque vous ouvrez un onglet de base de données. L’interface d’administration reste ainsi utile même lorsque le projet contient de grands ensembles de données derrière db.php.

Cette première version se concentre volontairement sur les inscriptions reposant sur des schémas. Ce n’est pas une page de réglages, mais une page d’inspection.

Si vous n’en voulez pas du tout, désactivez-le complètement :

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

Explorateur du registre d’administration

À côté de la vue d’ensemble se trouve un deuxième onglet : Registre. Il permet de parcourir les registres de blocs distants configurés dans le blocks.json de votre thème et d’importer des blocs directement depuis l’administration de WordPress, sans toucher à un 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}"
      }
    }
  }
}

L’explorateur récupère chaque registre configuré, répertorie tous les blocs disponibles et indique s’ils sont déjà installés localement ou peuvent être importés. Chaque ligne comporte un bouton Importer qui télécharge les fichiers du bloc dans le répertoire configuré de votre thème. Les blocs déjà installés affichent plutôt un bouton Réimporter.

Les registres authentifiés sont pris en charge au moyen du format objet avec headers, y compris l’interpolation ${ENV_VAR}, afin que les jetons ne se retrouvent jamais dans le contrôle de version.

Les registres deviennent ainsi une fonctionnalité de premier plan dans l’administration, plutôt qu’un simple flux de travail CLI.

Registre CLI

L’autre volet des registres est un CLI autonome : blockstudio/registry.

C’est un outil de style shadcn pour les blocs WordPress. Pas de paquet npm, pas d’étape de compilation. Vous exécutez une commande, le code source du bloc est copié dans votre projet et vous en avez entièrement la maîtrise.

Shell
npx blockstudio init
npx blockstudio add ui/tabs

Le CLI fonctionne avec tous les types de blocs : blocs Blockstudio, sortie @wordpress/create-block, blocs PHP simples. Le registre ne se préoccupe pas du contenu du dossier. Il lit le manifeste des fichiers dans registry.json et copie exactement les fichiers qui y sont indiqués.

Les auteurs de blocs publient un registry.json à n’importe quelle URL (contenu brut GitHub, S3 ou serveur personnalisé) qui répertorie leurs blocs disponibles avec leurs métadonnées, dépendances et listes de fichiers. Les utilisateurs ajoutent le URL à leur blocks.json, puis récupèrent les blocs par nom.

Le CLI prend en charge :

  • Résolution des dépendances : les blocs peuvent déclarer des dépendances à d’autres blocs, qui sont résolues automatiquement avec détection des cycles
  • Gestion des conflits entre registres : lorsqu’un même nom de bloc existe dans plusieurs registres, le CLI vous demande d’en choisir un
  • Registres authentifiés : jetons porteurs, authentification de base et en-têtes personnalisés avec interpolation de variables d’environnement
  • Interface TUI interactive : construite avec Ink, avec indicateurs d’activité, invites de sélection et indicateurs de progression
  • Mode non interactif : indicateur --yes et basculement automatique en mode CI ou redirection de flux
  • Recherche et liste : parcourez les registres depuis la ligne de commande

Le paquet comprend 130 tests couvrant les schémas, la résolution des dépendances, la récupération HTTP, l’écriture des fichiers, chaque flux de commande et l’UI interactive d’Ink.

Documentation complète sur blockstudio.dev/registry.

Extension PHPStan

L’autre grande nouveauté est blockstudio/phpstan : une extension PHPStan qui apporte aux utilisateurs de Blockstudio le niveau de sécurité des types auquel les développeurs TypeScript s’attendent.

Shell
composer require --dev blockstudio/phpstan

L’extension lit les schémas réels de votre projet au moment de l’analyse et transmet les types obtenus à PHPStan. Cela couvre désormais les modèles PHP, Twig, Blade, les balises de bloc, les enregistrements typés de base de données, les chemins de réglages, les noms de hooks et la validation des schémas dans block.json, field.json, JSON d’extension, page.json, db.php, rpc.php, cron.php et blockstudio.json.

Modèles de blocs avec sécurité des types

Les accès aux champs sur $a sont validés par rapport au block.json associé :

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"?

Enregistrements de base de données avec sécurité des types

Db::get() renvoie une instance typée d’après votre schéma db.php. La forme de l’enregistrement est construite à partir des champs réels :

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}

Validation des schémas

Les fichiers de schéma invalides sont détectés au moment de l’analyse : block.json, field.json, JSON d’extension, page.json, db.php, rpc.php, cron.php et blockstudio.json. Les noms manquants, types de champs incorrects, définitions mal formées et booléens abrégés obsolètes ("tailwind": true au lieu de l’objet imbriqué) sont tous signalés avec la ligne exacte du fichier source.

Validation des chemins de réglages

Les appels Settings::get() sont validés par rapport au schéma de réglages connu :

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"?

Validation des noms de hooks

Même chose pour les noms des hooks de filtres et d’actions :

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

L’extension fournit également des stubs pour toute l’Blockstudio publique de API : Db, Settings, Field_Registry, Build et les fonctions globales. Vous bénéficiez de la complétion automatique et de la vérification des types pour toutes les API Blockstudio, sans avoir besoin du code source de l’extension sur votre machine de développement.

Facilités de développement

Deux petites améliorations facilitent également le développement.

Préambules SCSS globaux

Blockstudio prenait déjà en charge la compilation SCSS, mais un point de friction persistait : la configuration partagée de Sass.

Pour accéder à un ensemble commun de variables, de fonctions ou de mixins, il fallait les importer dans chaque fichier SCSS. Cela devient vite répétitif, surtout avec les systèmes de conception ou les boîtes à outils Sass plus grands, comme Bootstrap.

La version 7.2 ajoute un hook de préambule conçu précisément pour cela :

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

Associé au filtre blockstudio/assets/process/scss/import_paths existant, il permet de définir une seule fois une surface Sass partagée, disponible dans chaque fichier compilé.

La feuille de style d’un bloc peut ainsi se concentrer sur les styles dont elle a réellement besoin :

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

Plus besoin de répéter les imports dans chaque ressource de bloc. Il ne s’agit pas d’un « mode de prise en charge de Bootstrap » spécial. C’est un hook générique pour partager Sass dans un projet, qu’ils viennent de Bootstrap ou de votre propre boîte à outils interne.

Définitions de API de bloc natives à PHP

La version 7.2 ajoute aussi une syntaxe facultative native à PHP pour les API de blocs full stack. Les tableaux restent la valeur par défaut et sont entièrement pris en charge. Rien n’a été remplacé. Mais si vous préférez les arguments nommés, les énumérations et les attributs aux tableaux de configuration imbriqués, vous pouvez maintenant choisir ce style.

Pour rpc.php, renvoyez un objet avec des méthodes annotées :

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'];
    }
};

Pour cron.php, la même approche fonctionne avec #[Cron] :

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

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

Et pour db.php, une petite couche de création est désormais disponible :

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),
    ],
);

Cela offre un meilleur équilibre pour les grandes bases de code. Vous gardez la simplicité du format tableau quand vous le souhaitez et pouvez passer à une surface PHP plus facile à explorer lorsqu’un bloc dépasse quelques champs ou points de terminaison.

Pourquoi ces nouveautés sont regroupées

La vue d’ensemble d’administration, l’explorateur de registres, le CLI des registres et l’extension PHPStan répondent tous à la même question : comment garder un projet Blockstudio compréhensible à mesure qu’il grandit ?

Les outils d’administration répondent à cette question à l’échelle du projet : visibilité sur ce qui est inscrit, possibilité d’ajouter des blocs depuis les registres et moins de suppositions.

Le CLI y répond à l’échelle de l’écosystème : il permet de partager des blocs entre projets et équipes sans les regrouper dans des paquets npm ni devoir composer avec les systèmes de compilation.

L’extension PHPStan y répond à l’échelle du code : elle détecte les accès à des champs incorrects, les fautes de frappe dans les schémas et les callbacks de hooks défectueux avant leur exécution.

C’est l’orientation générale de la version 7.2 : moins de suppositions, moins de répétitions, une meilleure visibilité et désormais une véritable sécurité des types.

Corrections de bugs

  • Champ Classes : les noms de classe personnalisés saisis par l’utilisateur disparaissaient silencieusement au moment de quitter le champ, car le validateur n’acceptait que les classes de la liste prédéfinie Tailwind/des réglages. Les chaînes non vides sont désormais acceptées.
  • Champ Attributs : la suppression d’une paire d’attributs laissait des entrées null dans les données enregistrées. Remplacement de lodash unset() (qui met les éléments du tableau à null) par splice() (qui les supprime).
  • Minificateur CSS : le minificateur TailwindPHP supprimait les espaces autour de + dans calc() et clamp(), produisant des CSS invalides, comme calc(1rem+0.5vw). Le correctif a été apporté en amont dans TailwindPHP v1.3.1, grâce à un parcours des caractères tenant compte de la profondeur, qui ne supprime les espaces autour des combinateurs de sélecteurs qu’à la profondeur de parenthèses 0.
  • Aperçu de l’outil d’insertion de blocs : $isPreview était toujours false dans l’aperçu de l’outil d’insertion de blocs, car le cache de rendu n’incluait pas le mode de rendu dans sa clé de hachage. Les rendus de l’éditeur et de l’aperçu disposent désormais d’entrées de cache distinctes.
  • Modèle imbriqué InnerBlocks : le composant <InnerBlocks template="..."/> supprimait le 3e élément (les enfants) des tuples de modèle comme ['core/group', {}, [['core/paragraph']]], ce qui produisait des blocs conteneurs vides. Les enfants imbriqués sont désormais conservés.