feat: Warnung, wenn lokale Werte ein zugewiesenes Preset überdecken

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
This commit is contained in:
Jan-Niclas Loosen
2026-10-18 16:53:38 +02:00
co-authored by Claude Haiku 5.5
parent be6ca5bee0
commit 1f9b50f1a6
5 changed files with 206 additions and 9 deletions
@@ -4,9 +4,12 @@ declare(strict_types=1);
namespace LIT\MCP\Tests\Unit\Integrations\Divi\Compose;
use LIT\MCP\Integrations\Divi\BlockTree\Block;
use LIT\MCP\Integrations\Divi\BlockTree\Document;
use LIT\MCP\Integrations\Divi\BlockTree\NodeIndex;
use LIT\MCP\Integrations\Divi\Compose\Warnings;
use LIT\MCP\Integrations\Divi\Design\PresetAssignment;
use LIT\MCP\Integrations\Divi\Design\PresetBook;
use LIT\MCP\Tests\Support\ComposeFixture;
use LIT\MCP\Tests\Support\DiviFixtures;
use PHPUnit\Framework\TestCase;
@@ -53,4 +56,144 @@ final class WarningsTest extends TestCase
self::assertSame([], (new Warnings(DiviFixtures::designSystem()))->collect(NodeIndex::build($document), []));
}
/** @return array<string, mixed> Button attrs with a preset and a local font color. */
private static function button(string $color, string $preset = 'p-2'): array
{
return [
'modulePreset' => [$preset],
'button' => ['decoration' => ['font' => ['font' => ['desktop' => ['value' => ['color' => $color]]]]]],
];
}
/** Preset p-2 "CTA primär" sets the font color #ffffff; g-1 is a group preset without values. */
private static function book(): PresetBook
{
return PresetBook::fromDivi([
'module' => ['divi/button' => ['default' => '', 'items' => [
'p-2' => [
'id' => 'p-2',
'name' => 'CTA primär',
'moduleName' => 'divi/button',
'attrs' => ['button' => ['decoration' => ['font' => ['font' => [
'desktop' => ['value' => ['color' => '#ffffff']],
]]]]],
],
]]],
'group' => ['divi/font' => ['default' => '', 'items' => [
'g-1' => ['id' => 'g-1', 'name' => 'Fließtext groß', 'groupName' => 'divi/font'],
]]],
]);
}
/** @param int $loads Counts how often the preset book is read. */
private static function presets(int &$loads): PresetAssignment
{
return ComposeFixture::presetAssignment(null, null, null, null, static function () use (&$loads): PresetBook {
++$loads;
return self::book();
});
}
/**
* @param list<Block> $blocks top-level blocks of the page
* @param list<Block> $touched
* @return array{0: list<string>, 1: NodeIndex}
*/
private static function collect(array $blocks, array $touched, PresetAssignment $presets): array
{
$document = new Document();
foreach ($blocks as $block) {
$document->append($block);
}
$index = NodeIndex::build($document);
$warnings = (new Warnings(DiviFixtures::designSystem(), $presets))->collect($index, $touched);
return [
array_values(array_filter($warnings, static fn (string $w): bool => str_contains($w, 'überdecken'))),
$index,
];
}
public function testWarnsWhenLocalValuesCoverAnAssignedPreset(): void
{
$loads = 0;
$button = Block::create('divi/button', self::button('#000000'));
[$covering, $index] = self::collect([$button], [$button], self::presets($loads));
self::assertCount(1, $covering);
self::assertStringStartsWith(
$index->idOf($button) . ': lokale Werte überdecken „CTA primär“: ',
$covering[0]
);
self::assertStringContainsString('button.decoration.font.font', $covering[0]);
self::assertStringEndsWith('clear_overrides: true entfernt sie.', $covering[0]);
}
public function testEqualValuesAndUntouchedBlocksDoNotWarn(): void
{
$loads = 0;
$same = Block::create('divi/button', self::button('#ffffff'));
$other = Block::create('divi/button', self::button('#000000'));
[$covering] = self::collect([$same, $other], [$same], self::presets($loads));
self::assertSame([], $covering, 'the same value covers nothing; $other was not touched');
}
public function testChildrenOfATouchedBlockAreChecked(): void
{
$loads = 0;
$button = Block::create('divi/button', self::button('#000000'));
$section = Block::create('divi/section', [], [
Block::create('divi/row', [], [Block::create('divi/column', [], [$button])]),
]);
[$covering, $index] = self::collect([$section], [$section], self::presets($loads));
self::assertCount(1, $covering);
self::assertStringStartsWith($index->idOf($button) . ': lokale Werte', $covering[0]);
}
public function testThePresetBookIsOnlyReadForBlocksThatHavePresets(): void
{
$loads = 0;
$plain = Block::create('divi/button', [
'button' => ['decoration' => ['font' => ['font' => ['desktop' => ['value' => ['color' => '#000000']]]]]],
]);
$presets = self::presets($loads);
self::collect([$plain], [$plain], $presets);
self::assertSame(0, $loads, 'no touched block names a preset');
$grouped = Block::create('divi/button', [
'groupPreset' => ['button.decoration.font.font' => ['groupName' => 'divi/font', 'presetId' => ['g-1']]],
]);
$stacked = Block::create('divi/button', self::button('#000000'));
[$covering] = self::collect([$plain, $grouped, $stacked], [$plain, $grouped, $stacked], $presets);
self::assertSame(1, $loads, 'read once, for the first block that has a preset');
self::assertCount(1, $covering);
}
public function testOpaqueAndForeignBlocksAreSkipped(): void
{
$loads = 0;
$attrs = self::button('#000000');
$opaque = Block::parsed(
'divi/button',
$attrs + ['globalModule' => '9'],
'<!-- wp:divi/button {"globalModule":"9"} /-->',
true,
true
);
$foreign = Block::create('core/paragraph', $attrs);
[$covering] = self::collect([$opaque, $foreign], [$opaque, $foreign], self::presets($loads));
self::assertSame([], $covering);
self::assertSame(0, $loads);
}
}