<?php

declare(strict_types=1);

namespace Mironsoft\Loyalty\Model\Widget;

use Magento\Framework\View\Element\Template;
use Magento\Framework\View\Element\Template\Context;
use Magento\Widget\Block\BlockInterface;
use Mironsoft\Loyalty\ViewModel\PointsBalance;

/**
 * Renders the "My Points" widget insertable into any CMS WYSIWYG content. Magento's widget
 * subsystem (widget.xml, the {{widget}} directive filter) instantiates this class directly
 * as a layout block - there is no view_model-argument equivalent here, so unlike every other
 * template data source in this module (chapter 47), a real block subclass is unavoidable.
 * The class still delegates every piece of actual logic to ViewModel\PointsBalance (chapter
 * 48) instead of duplicating it - only the mandatory Template/BlockInterface wrapper is new.
 */
class PointsBalanceWidget extends Template implements BlockInterface
{
    /**
     * @param Context $context Framework template context, required by the parent Template class.
     * @param PointsBalance $pointsBalanceViewModel Same view model already used in chapters 48/51/52 - reused unmodified here.
     * @param array<string, mixed> $data Additional block data, populated by Magento's widget system from the admin-configured parameters (chapter 57).
     */
    public function __construct(
        Context $context,
        private readonly PointsBalance $pointsBalanceViewModel,
        array $data = [],
    ) {
        parent::__construct($context, $data);
        $this->setTemplate('Mironsoft_Loyalty::widget/points-balance.phtml');
    }

    /**
     * Returns the injected view model. Exists purely so the template written in chapter 53 -
     * which calls $block->getViewModel() - keeps working here completely unmodified, even
     * though $block is now this widget class instead of a generic Template block.
     *
     * @return PointsBalance
     */
    public function getViewModel(): PointsBalance
    {
        return $this->pointsBalanceViewModel;
    }
}

<?xml version="1.0"?>
<widgets xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Widget:etc/widget.xsd">
    <widget id="mironsoft_loyalty_points_balance"
            class="Mironsoft\Loyalty\Model\Widget\PointsBalanceWidget"
            is_email_compatible="false">
        <label translate="true">Loyalty: My Points Balance</label>
        <description translate="true">Displays the logged-in customer's points balance and loyalty tier.</description>
        <parameters>
            <!-- chapter 57 adds show_tier_badge and css_class here -->
        </parameters>
    </widget>
</widgets>