WP-LIT-MCP/tests/Unit/Integrations/Divi/Design/VariableRestorePlannerTest.php

<?php

declare(strict_types=1);

namespace LIT\MCP\Tests\Unit\Integrations\Divi\Design;

use Brain\Monkey\Functions;
use LIT\MCP\Integrations\Divi\Design\DesignPlan;
use LIT\MCP\Integrations\Divi\Design\DesignSystemWriter;
use LIT\MCP\Integrations\Divi\Design\GlobalVariablesAdapter;
use LIT\MCP\Integrations\Divi\Design\VariableArea;
use LIT\MCP\Integrations\Divi\Design\VariableBook;
use LIT\MCP\Integrations\Divi\Design\VariableRestorePlanner;
use LIT\MCP\Integrations\Divi\Design\ReferenceUsageQuery;
use LIT\MCP\Integrations\Divi\Library\GlobalUsages;
use LIT\MCP\Integrations\Divi\Release\DiviFeature;
use LIT\MCP\Tests\Support\UsageFixture;
use LIT\MCP\Tests\Unit\TestCase;
use Mockery;

final class VariableRestorePlannerTest extends TestCase
{
    public const SNAPSHOT_ID = 'variables-20261016T100000Z-aaaaaa';

    /** One stored variable of type numbers. */
    public static function number(string $id, string $label, string $value): array
    {
        return ['id' => $id, 'label' => $label, 'value' => $value, 'order' => '1', 'status' => 'active',
            'lastUpdated' => '2026-10-01T10:00:00.000Z', 'variableType' => 'numbers'];
    }

    /** @return array<string, array<string, array<string, mixed>>> Now: radius 8px and "Neu", created afterwards. */
    public static function current(): array
    {
        return ['numbers' => [
            'gvid-radius0001' => self::number('gvid-radius0001', 'Eckenradius', '8px'),
            'gvid-neu0000001' => self::number('gvid-neu0000001', 'Neu', '2rem'),
        ]];
    }

    /** @return array<string, array<string, array<string, mixed>>> The snapshot: radius 4px. */
    public static function snapshot(): array
    {
        return ['numbers' => ['gvid-radius0001' => self::number('gvid-radius0001', 'Eckenradius', '4px')]];
    }

    private static function planner(bool $manage = true, ?GlobalUsages $usages = null): VariableRestorePlanner
    {
        $writer = Mockery::mock(DesignSystemWriter::class);
        $writer->allows('refresh');
        $writer->allows('canUseVisualBuilder')->andReturn(true);
        $variables = Mockery::mock(GlobalVariablesAdapter::class);
        $variables->allows('refresh');
        $variables->allows('canManage')->andReturn($manage);

        return new VariableRestorePlanner($writer, $variables, $usages ?? UsageFixture::none());
    }

    public function testAreaFeaturesAndDesignArea(): void
    {
        $planner = self::planner();

        self::assertSame('variables', $planner->area());
        self::assertSame([DiviFeature::DesignRead, DiviFeature::VariableWrite], $planner->features());
        self::assertInstanceOf(VariableArea::class, $planner->designArea());
    }

    public function testNeedsTheVariableRights(): void
    {
        Functions\when('current_user_can')->justReturn(true);
        self::assertNull(self::planner()->rights());
        self::assertToolError(self::planner(false)->rights(), 'forbidden');
    }

    public function testRestoresTheSnapshotAndKeepsNewerVariablesArchived(): void
    {
        $current = VariableBook::fromDivi(self::current());
        $snapshot = VariableBook::fromDivi(self::snapshot());

        $plan = self::planner()->plan(self::current(), self::snapshot(), self::SNAPSHOT_ID);

        self::assertInstanceOf(DesignPlan::class, $plan);
        self::assertFalse($plan->mayRemove, 'V1: variables are never removed');
        self::assertSame($current->restoredFrom($snapshot)->data(), $plan->raw);
        self::assertSame('4px', $plan->raw['numbers']['gvid-radius0001']['value']);
        self::assertSame('archived', $plan->raw['numbers']['gvid-neu0000001']['status']);
        self::assertEqualsCanonicalizing(
            [['gvid-radius0001', 'changed'], ['gvid-neu0000001', 'archived']],
            array_map(static fn (array $row): array => [$row['id'], $row['action']], $plan->diff)
        );
        self::assertStringStartsWith('Snapshot ' . self::SNAPSHOT_ID . ' wiederherstellen – Variablen: ', $plan->summary);
        self::assertSame(
            ['Variable „Neu“ gibt es im Snapshot nicht; sie bleibt archiviert erhalten (Divi löscht keine Variablen).'],
            $plan->warnings
        );
    }

    /** Audit L4: changed and archived variables are looked up; the plan carries the report for P8a. */
    public function testReportsThePagesUsingChangedOrArchivedVariables(): void
    {
        $usages = Mockery::mock(GlobalUsages::class);
        $usages->expects('reportFor')->once()->with(Mockery::on(
            static fn (mixed $query): bool => $query instanceof ReferenceUsageQuery
                && $query->matches('gvid-radius0001') && $query->matches('gvid-neu0000001')
        ))->andReturn(UsageFixture::blockedReport());

        $plan = self::planner(true, $usages)->plan(self::current(), self::snapshot(), self::SNAPSHOT_ID);

        self::assertInstanceOf(DesignPlan::class, $plan);
        self::assertTrue($plan->usages?->blocks());
    }
}