<?php
/**
 * What's New — a reusable, accessible release-notes dialog.
 *
 * Notes are keyed by release line ("2.2"), not by patch, so everyone who
 * lands on any 2.2.x build sees "What's new in 2.2" once. VersionManager
 * calls on_upgrade() when the stored version changes; fresh installs never
 * see the dialog. The Overview header carries a "What's new" button that
 * reopens the current line's notes at any time.
 *
 * To announce a release: add an entry to notes() with `since` set to the
 * first version that ships the entry.
 *
 * @package AllAccessible
 * @since   2.2.1
 */
if (!defined('ABSPATH')) { exit; }

class AllAccessible_WhatsNew {
    const OPTION_PENDING = 'aacb_whats_new_pending';
    const OPTION_SEEN    = 'aacb_whats_new_seen';
    const AJAX_ACTION    = 'aacb_whats_new_action';
    const DOM_ID         = 'aacb-whats-new';

    public static function register() {
        add_action('admin_footer', array(__CLASS__, 'maybe_render'));
        add_action('wp_ajax_' . self::AJAX_ACTION, array(__CLASS__, 'ajax_handle'));
    }

    /** Release notes by line. Customer-facing copy only. */
    public static function notes() {
        return array(
            '2.2' => array(
                'since' => '2.2.1',
                'title' => __("What's new in AllAccessible 2.2", 'allaccessible'),
                'items' => array(
                    array(
                        'heading'    => __('Build your accessibility statement page', 'allaccessible'),
                        'body'       => __('We draft it from your AllAccessible statement, you publish it as a page, and the accessibility menu links visitors to it. If you already have one, we ask before touching anything. When the wording changes, one click refreshes the page.', 'allaccessible'),
                        'cta_label'  => __('Create my statement page', 'allaccessible'),
                        'cta_anchor' => 'aacb-statement-card',
                    ),
                    array(
                        'heading' => __('A status-first dashboard', 'allaccessible'),
                        'body'    => __('One health card answers "is my site OK?" in plain words, says when the score only covers part of your site, and carries one clear next action.', 'allaccessible'),
                    ),
                    array(
                        'heading' => __('Scan from the overview', 'allaccessible'),
                        'body'    => __('When a scan is due it runs right from the overview with live progress, and if it cannot start the plugin tells you why.', 'allaccessible'),
                    ),
                ),
            ),
        );
    }

    /** "2.2.1" → "2.2". */
    public static function line_for($version) {
        return preg_match('/^(\d+)\.(\d+)/', (string) $version, $m) ? $m[1] . '.' . $m[2] : (string) $version;
    }

    public static function entry_for($version) {
        $notes = self::notes();
        $line  = self::line_for($version);
        return isset($notes[$line]) ? $notes[$line] + array('line' => $line) : null;
    }

    /**
     * Called by VersionManager when the stored version changes.
     *
     * @return bool true when the dialog was queued.
     */
    public static function on_upgrade($from, $to) {
        if ((string) $from === '0' || (string) $from === '') return false; // fresh install
        $entry = self::entry_for($to);
        if (!$entry) return false;
        if (version_compare((string) $from, $entry['since'], '>=')) return false; // already on a build that had it
        update_option(self::OPTION_PENDING, $entry['line'], false);
        return true;
    }

    /** Pure rule, testable: should the dialog open by itself on this screen? */
    public static function evaluate_open(array $ctx) {
        if (empty($ctx['can_manage'])) return false;
        if (strpos((string) ($ctx['screen_id'] ?? ''), 'allaccessible') === false) return false;
        $pending = (string) ($ctx['pending'] ?? '');
        return $pending !== '' && $pending === (string) ($ctx['line'] ?? '');
    }

    private static function on_plugin_screen() {
        $screen = function_exists('get_current_screen') ? get_current_screen() : null;
        return $screen && strpos((string) $screen->id, 'allaccessible') !== false;
    }

    public static function should_open() {
        if (!current_user_can('manage_options') || !self::on_plugin_screen()) return false;
        $entry = self::entry_for(AACB_VERSION);
        if (!$entry) return false;
        return self::evaluate_open(array(
            'can_manage' => true,
            'screen_id'  => get_current_screen()->id,
            'pending'    => get_option(self::OPTION_PENDING, ''),
            'line'       => $entry['line'],
        ));
    }

    /** Header button. Prints nothing when there are no notes for this line. */
    public static function render_link() {
        if (!self::entry_for(AACB_VERSION)) return;
        ?>
        <button type="button" class="aacx-v2__btn aacx-v2__btn--ghost" data-aacb-whats-new-open aria-controls="<?php echo esc_attr(self::DOM_ID); ?>">✦ <?php esc_html_e("What's new", 'allaccessible'); ?></button>
        <?php
    }

    /** Dialog markup, printed hidden on every plugin screen; opens itself when pending. */
    public static function maybe_render() {
        if (!current_user_can('manage_options') || !self::on_plugin_screen()) return;
        $entry = self::entry_for(AACB_VERSION);
        if (!$entry) return;
        $auto  = self::should_open();
        $nonce = wp_create_nonce(self::AJAX_ACTION);
        $ajax  = admin_url('admin-ajax.php');
        $id    = self::DOM_ID;
        ?>
        <div id="<?php echo esc_attr($id); ?>" class="aacb-modal" hidden
             data-auto="<?php echo $auto ? '1' : '0'; ?>"
             data-line="<?php echo esc_attr($entry['line']); ?>"
             data-nonce="<?php echo esc_attr($nonce); ?>"
             data-ajax="<?php echo esc_url($ajax); ?>">
            <div class="aacb-modal__backdrop" data-act="close"></div>
            <div class="aacb-modal__panel aacx-v2" role="dialog" aria-modal="true" aria-labelledby="<?php echo esc_attr($id); ?>-title" tabindex="-1">
                <button type="button" class="aacb-modal__close" data-act="close" aria-label="<?php esc_attr_e('Close', 'allaccessible'); ?>">×</button>
                <div class="aacb-modal__eyebrow">✦ <?php esc_html_e('Release notes', 'allaccessible'); ?></div>
                <h2 id="<?php echo esc_attr($id); ?>-title" class="aacb-modal__title"><?php echo esc_html($entry['title']); ?></h2>
                <?php foreach ($entry['items'] as $i => $item) : ?>
                    <div class="aacb-modal__item">
                        <span class="aacb-modal__num" aria-hidden="true"><?php echo (int) $i + 1; ?></span>
                        <div>
                            <h3><?php echo esc_html($item['heading']); ?></h3>
                            <p><?php echo esc_html($item['body']); ?></p>
                            <?php if (!empty($item['cta_label'])) :
                                $href = !empty($item['cta_url']) ? $item['cta_url'] : admin_url('admin.php?page=allaccessible' . (!empty($item['cta_anchor']) ? '#' . $item['cta_anchor'] : ''));
                                ?>
                                <p style="margin-top:8px;"><a href="<?php echo esc_url($href); ?>" class="aacx-v2__btn aacx-v2__btn--primary aacx-v2__btn--sm" data-act="cta"><?php echo esc_html($item['cta_label']); ?> →</a></p>
                            <?php endif; ?>
                        </div>
                    </div>
                <?php endforeach; ?>
                <p class="aacb-modal__foot"><button type="button" class="aacx-v2__btn aacx-v2__btn--secondary" data-act="close"><?php esc_html_e('Got it', 'allaccessible'); ?></button></p>
            </div>
        </div>
        <script>
        (function () {
            var root = document.getElementById('<?php echo esc_js($id); ?>');
            if (!root) return;
            var panel = root.querySelector('.aacb-modal__panel');
            var opener = null, marked = false;
            function focusables() {
                return panel.querySelectorAll('a[href], button:not([disabled]), [tabindex]:not([tabindex="-1"])');
            }
            function mark() {
                if (marked) return; marked = true;
                var fd = new FormData();
                fd.append('action', '<?php echo esc_js(self::AJAX_ACTION); ?>');
                fd.append('_ajax_nonce', root.getAttribute('data-nonce'));
                fd.append('wn_act', 'seen');
                fd.append('line', root.getAttribute('data-line'));
                fetch(root.getAttribute('data-ajax'), { method: 'POST', credentials: 'same-origin', keepalive: true, body: fd });
            }
            function open(from) {
                opener = from || null;
                root.hidden = false;
                document.body.classList.add('aacb-modal-open');
                panel.focus();
            }
            function close() {
                root.hidden = true;
                document.body.classList.remove('aacb-modal-open');
                mark();
                if (opener && typeof opener.focus === 'function') opener.focus();
            }
            root.addEventListener('click', function (e) {
                var act = e.target.closest('[data-act]');
                if (!act) return;
                if (act.getAttribute('data-act') === 'close') { e.preventDefault(); close(); }
                else if (act.getAttribute('data-act') === 'cta') { close(); /* let the link navigate / jump to its anchor */ }
            });
            // Escape is caught at the document so it works wherever focus sits while open.
            document.addEventListener('keydown', function (e) {
                if (!root.hidden && (e.key === 'Escape' || e.key === 'Esc')) { e.preventDefault(); close(); }
            });
            root.addEventListener('keydown', function (e) {
                if (e.key !== 'Tab') return;
                var f = focusables(); if (!f.length) return;
                var first = f[0], last = f[f.length - 1];
                if (e.shiftKey && (document.activeElement === first || document.activeElement === panel)) { e.preventDefault(); last.focus(); }
                else if (!e.shiftKey && document.activeElement === last) { e.preventDefault(); first.focus(); }
            });
            document.querySelectorAll('[data-aacb-whats-new-open]').forEach(function (btn) {
                btn.addEventListener('click', function () { marked = false; open(btn); });
            });
            if (root.getAttribute('data-auto') === '1') { open(null); }
        })();
        </script>
        <?php
    }

    public static function ajax_handle() {
        if (!current_user_can('manage_options')) {
            wp_send_json_error(array('message' => 'forbidden'), 403);
        }
        check_ajax_referer(self::AJAX_ACTION);
        $act = isset($_POST['wn_act']) ? sanitize_key($_POST['wn_act']) : '';
        if ($act !== 'seen') {
            wp_send_json_error(array('message' => 'unknown action'), 400);
        }
        $line = isset($_POST['line']) ? preg_replace('/[^0-9.]/', '', (string) $_POST['line']) : '';
        if ($line === '') $line = self::line_for(AACB_VERSION);
        update_option(self::OPTION_SEEN, $line, false);
        delete_option(self::OPTION_PENDING);
        wp_send_json_success(array('seen' => $line));
    }
}