WP-LIT-MCP/tests/Unit/Integrations/Divi/Schema/DiviCatalogAbilityTest.php

<?php

declare(strict_types=1);

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

use Brain\Monkey\Functions;
use LIT\MCP\Integrations\Divi\Schema\DiviCatalogAbility;
use LIT\MCP\Integrations\Divi\Schema\DiviModules;
use LIT\MCP\Tests\Support\DiviFixtures;
use LIT\MCP\Tests\Unit\TestCase;
use Mockery;

final class DiviCatalogAbilityTest extends TestCase
{
    private function ability(): DiviCatalogAbility
    {
        $modules = Mockery::mock(DiviModules::class);
        $modules->allows('catalog')->andReturn(DiviFixtures::catalog());

        return new DiviCatalogAbility($modules);
    }

    /** Trial feedback: both result shapes as one-line examples. */
    public function testDescriptionShowsBothResultShapes(): void
    {
        $description = $this->ability()->description();

        self::assertStringContainsString('{"modules": [{"name": "divi/heading"', $description);
        self::assertStringContainsString('{"module": {"name": "divi/heading"', $description);
        self::assertStringContainsString('"notes": [', $description);
    }

    public function testListsModulesWithShortformFlag(): void
    {
        $result = $this->ability()->execute([]);

        $button = array_values(array_filter($result['modules'], static fn (array $m): bool => $m['name'] === 'divi/button'));
        self::assertSame(
            [['name' => 'divi/button', 'title' => 'Button', 'category' => 'module', 'children' => [], 'shortform' => true]],
            $button
        );
        $header = array_values(array_filter(
            $result['modules'],
            static fn (array $m): bool => $m['name'] === 'divi/fullwidth-header'
        ));
        self::assertFalse($header[0]['shortform']);
        self::assertSame(DiviCatalogAbility::CODE_NOTE, $result['notes'][0]);
        self::assertStringContainsString('"divi-shortform"', $result['notes'][1]);
        self::assertStringContainsString('"divi-attrs"', $result['notes'][1]);
    }

    public function testDetailOfOneModule(): void
    {
        $result = $this->ability()->execute(['module' => 'Accordion']);

        self::assertSame('divi/accordion', $result['module']['name']);
        self::assertSame(['divi/accordion-item'], $result['module']['children']);
        self::assertSame('accordion-item', $result['module']['item_type']);
        self::assertContains('title.decoration.font.font', $result['module']['paths']);

        $button = $this->ability()->execute(['module' => 'divi/button'])['module'];
        self::assertSame('linkUrl', $button['shortform']['url']['sub']);
    }

    public function testDetailExposesTheAttributePathKindsForSanitizationRouting(): void
    {
        $button = $this->ability()->execute(['module' => 'divi/button'])['module'];

        self::assertSame('text', $button['path_kinds']['module.meta.adminLabel']);
        self::assertArrayNotHasKey('no.such.path', $button['path_kinds']);
        // Composite ("group") paths are left out rather than guessing a single kind.
        self::assertArrayNotHasKey('button.innerContent', $button['path_kinds']);
    }

    /** A composite path (several named sub-fields under one attribute path) surfaces as a
     *  subName => kind map, not a single guessed string (spec §5.6, ruling F1 #1). */
    public function testDetailExposesCompositePathKindsAsASubNameMap(): void
    {
        $header = $this->ability()->execute(['module' => 'divi/fullwidth-header'])['module'];

        self::assertSame(
            ['text' => 'text', 'linkUrl' => 'url'],
            $header['path_kinds']['buttonOne.innerContent']
        );
        self::assertSame(['src' => 'image'], $header['path_kinds']['image.innerContent']);
    }

    public function testUnknownModuleAndPermission(): void
    {
        self::assertToolError($this->ability()->execute(['module' => 'slider-pro']), 'not_found');

        Functions\when('current_user_can')->justReturn(false);
        self::assertToolError($this->ability()->permission([]), 'forbidden');
        self::assertTrue($this->ability()->annotations()['readonly']);
        self::assertTrue($this->ability()->isDirect());
    }
}