<?php

namespace FluentCartBreakdance\Breakdance;

defined('ABSPATH') || exit;

/**
 * Option plumbing for the site-wide editor-preview-product fallback (shared
 * contract with the ProductContext fork, see ELITE-PLAN.md WP2 "GEDEELD CONTRACT").
 *
 * This class owns only the storage side: registering the `fcbd_preview_product_id`
 * option (int, 0 = off) and exposing it through the `fcbd/editor_preview_product_id`
 * filter so ProductContext::resolve() can consult it as a last-resort fallback when
 * running inside the builder (isBuilderRequest()) and nothing else resolved a
 * product.
 *
 * There is no admin UI for this yet (planned for WP12's backend app). Until then
 * the option is deliberately WP-CLI-friendly:
 *
 *   wp option update fcbd_preview_product_id 123
 *   wp option get fcbd_preview_product_id
 *
 * register_setting() is used (rather than a bare add_option()) so the option gets
 * a sanitize callback and a description without requiring any settings page to be
 * registered; WP-CLI's `option` commands work against any option regardless of
 * whether register_setting() was called, but doing so keeps the value sane
 * (absint) if it is ever wired into wp-admin/options.php or the REST settings
 * endpoint later.
 */
final class EditorSupport
{
    public const OPTION = 'fcbd_preview_product_id';

    public static function hook(): void
    {
        add_action('init', [self::class, 'registerOption']);
    }

    public static function registerOption(): void
    {
        if (!function_exists('register_setting')) {
            return;
        }

        register_setting('fluentcart_breakdance', self::OPTION, [
            'type' => 'integer',
            'description' => __('Site-wide fallback FluentCart product ID used to preview elements in the Breakdance editor when no other product context resolves.', 'sparkcore-commerce'),
            'sanitize_callback' => 'absint',
            'default' => 0,
            'show_in_rest' => false,
        ]);
    }

    /**
     * Reads the stored option and runs it through the public filter so other
     * code (a future admin UI, per-document overrides, tests) can override the
     * value without touching the option itself.
     */
    public static function previewProductId(): int
    {
        $stored = function_exists('get_option') ? absint(get_option(self::OPTION, 0)) : 0;

        return (int) apply_filters('fcbd/editor_preview_product_id', $stored);
    }
}