Кастомный блок в Gutenberg ломается не из-за кода, а из-за плохой структуры

Начинайте не с JSX и стилей, а с границ блока: что редактирует пользователь, а что должно быть зашито жестко. Если блок отвечает за один сценарий, он будет проще в поддержке и понятнее в интерфейсе.

Перед разработкой проверьте 4 вещи:
— какие поля реально нужны в панели настроек
— как блок выглядит без контента
— что будет, если пользователь удалит часть текста
— можно ли переиспользовать логику в другом блоке

Главная ошибка — делать «комбайн» из десятка опций. Чем больше переключателей, тем выше шанс получить неудобный интерфейс и сложный код. Лучше собрать ядро блока, а расширения вынести в отдельные вариации или дочерние блоки.

Отдельно продумайте сохранение данных: если контент важен для верстки, не прячьте его в случайные атрибуты. У блока должна быть предсказуемая схема, иначе потом больно править шаблон, миграции и старые записи.

Хороший кастомный блок — это не самый умный блок, а самый предсказуемый. Сначала сценарий, потом настройки, и только затем код.