<?php
/**
 * COGS Setup Wizard (Free onboarding).
 *
 * @package Kayvandra\MarginBeacon
 */

declare(strict_types=1);

namespace Kayvandra\MarginBeacon\Admin\Cost;

use Kayvandra\MarginBeacon\Admin\Navigation\Tabs;
use Kayvandra\MarginBeacon\Application\Cost\CanonicalCostSource;
use Kayvandra\MarginBeacon\Application\Cost\CogsEnvironment;
use Kayvandra\MarginBeacon\Application\Cost\CostCoverageService;
use Kayvandra\MarginBeacon\Support\Capabilities;
use Kayvandra\MarginBeacon\Support\Constants;

/**
 * Multi-step Cost of Goods setup wizard per PRD 11.3 / FR-003.
 */
final class CogsWizardPage {

	const STEPS = array(
		1 => 'environment',
		2 => 'source',
		3 => 'coverage',
		4 => 'acknowledge',
		5 => 'complete',
	);

	/**
	 * Register handlers (menu owned by AdminApp tabs).
	 *
	 * @return void
	 */
	public function register() {
		add_action( 'admin_init', array( $this, 'handle_post' ) );
		add_action( 'admin_notices', array( $this, 'prompt_incomplete_wizard' ) );
	}

	/**
	 * Persist wizard step submissions.
	 *
	 * @return void
	 */
	public function handle_post() {
		if ( ! isset( $_POST['aksmb_wizard_nonce'] ) ) {
			return;
		}
		if ( ! Capabilities::current_user_can_manage() ) {
			return;
		}
		if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['aksmb_wizard_nonce'] ) ), 'aksmb_cogs_wizard' ) ) {
			return;
		}

		$step   = isset( $_POST['wizard_step'] ) ? absint( $_POST['wizard_step'] ) : 1;
		$action = isset( $_POST['wizard_action'] ) ? sanitize_key( wp_unslash( $_POST['wizard_action'] ) ) : 'next';
		$state  = $this->get_state();

		if ( 'back' === $action ) {
			$state['step'] = max( 1, $step - 1 );
			$this->save_state( $state );
			$this->redirect_step( (int) $state['step'] );
		}

		if ( 2 === $step ) {
			$cost = get_option( Constants::OPTION_COST_SETTINGS, array() );
			if ( ! is_array( $cost ) ) {
				$cost = array();
			}
			$prev_cost = $cost;
			$source    = isset( $_POST['canonical_cost_source'] ) ? sanitize_key( wp_unslash( $_POST['canonical_cost_source'] ) ) : '';
			if ( ! ( new CanonicalCostSource() )->is_valid( $source ) ) {
				$env_detect = ( new CogsEnvironment() )->detect();
				$source     = ! empty( $env_detect['native_cogs_enabled'] )
					? CanonicalCostSource::WOOCOMMERCE
					: CanonicalCostSource::MARGINBEACON;
			}
			$cost['canonical_cost_source'] = $source;
			$cost['prefer_native_cogs']    = ( CanonicalCostSource::WOOCOMMERCE === $source );
			$cost['fallback_enabled']      = ! empty( $_POST['fallback_enabled'] );
			$percent                       = isset( $_POST['global_assumed_cost_percent'] )
				? sanitize_text_field( wp_unslash( $_POST['global_assumed_cost_percent'] ) )
				: '';
			if ( '' !== $percent ) {
				if ( ! preg_match( '/^[+-]?(?:\d+(?:\.\d*)?|\.\d+)$/', trim( $percent ) ) ) {
					add_settings_error( 'aksmb_wizard', 'percent', __( 'Assumed cost percentage must be a number between 0 and 100.', 'marginbeacon' ), 'error' );
					$state['step'] = 2;
					$this->save_state( $state );
					return;
				}
				$percent_str = trim( (string) $percent );
				$in_range    = bccomp( $percent_str, '0', 6 ) >= 0 && bccomp( $percent_str, '100', 6 ) <= 0;
				if ( ! $in_range ) {
					add_settings_error( 'aksmb_wizard', 'percent', __( 'Assumed cost percentage must be between 0 and 100.', 'marginbeacon' ), 'error' );
					$state['step'] = 2;
					$this->save_state( $state );
					return;
				}
				$cost['global_assumed_cost_percent'] = $percent;
			} else {
				$cost['global_assumed_cost_percent'] = null;
			}
			$cost['custom_meta_key'] = isset( $_POST['custom_meta_key'] )
				? sanitize_text_field( wp_unslash( $_POST['custom_meta_key'] ) )
				: '';
			$cost_changed            = $prev_cost !== $cost;
			$updated                 = update_option( Constants::OPTION_COST_SETTINGS, $cost, true );
			( new CanonicalCostSource() )->set( $source );
			if ( $cost_changed && $updated ) {
				( new \Kayvandra\MarginBeacon\Application\Freshness\FreshnessService() )->on_global_threshold_change();
			}
			$state['source_configured'] = true;
		}

		if ( 4 === $step ) {
			if ( empty( $_POST['ack_incomplete'] ) || empty( $_POST['ack_tax_exclusive'] ) || empty( $_POST['ack_scope'] ) ) {
				add_settings_error(
					'aksmb_wizard',
					'ack',
					__( 'You must acknowledge all required statements before continuing. Cost completion can be incomplete, but limitation acknowledgement cannot be skipped.', 'marginbeacon' ),
					'error'
				);
				$state['step'] = 4;
				$this->save_state( $state );
				return;
			}

			$tax_basis = isset( $_POST['cogs_tax_basis'] ) ? sanitize_key( wp_unslash( $_POST['cogs_tax_basis'] ) ) : 'exclusive';
			$cost      = get_option( Constants::OPTION_COST_SETTINGS, array() );
			if ( ! is_array( $cost ) ) {
				$cost = array();
			}
			$cost['cogs_tax_basis'] = ( 'inclusive' === $tax_basis ) ? 'inclusive' : 'exclusive';
			if ( 'inclusive' === $cost['cogs_tax_basis'] ) {
				$cost['needs_cogs_correction'] = true;
			} else {
				$cost['needs_cogs_correction'] = false;
			}
			update_option( Constants::OPTION_COST_SETTINGS, $cost, true );

			$settings = get_option( Constants::OPTION_SETTINGS, array() );
			if ( ! is_array( $settings ) ) {
				$settings = array();
			}
			$settings['disclaimer_accepted'] = true;
			update_option( Constants::OPTION_SETTINGS, $settings, true );

			$state['acknowledged']      = true;
			$state['ack_incomplete']    = true;
			$state['ack_tax_exclusive'] = ( 'exclusive' === $cost['cogs_tax_basis'] );
			$state['completed']         = true;
			$state['completed_at_gmt']  = gmdate( 'Y-m-d H:i:s' );
		}

		if ( 'next' === $action ) {
			$state['step'] = min( 5, $step + 1 );
		}

		$this->save_state( $state );
		$this->redirect_step( (int) $state['step'] );
	}

	/**
	 * Soft prompt when wizard never completed.
	 *
	 * @return void
	 */
	public function prompt_incomplete_wizard() {
		if ( ! Capabilities::current_user_can_manage() ) {
			return;
		}
		$state = $this->get_state();
		if ( ! empty( $state['completed'] ) ) {
			return;
		}
		$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
		if ( ! $screen || false === strpos( (string) $screen->id, 'marginbeacon' ) ) {
			return;
		}
		// phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( isset( $_GET['tab'] ) && Tabs::COST_SETUP === sanitize_key( wp_unslash( $_GET['tab'] ) ) ) {
			return;
		}
		printf(
			'<div class="notice notice-warning"><p>%s <a href="%s">%s</a></p></div>',
			esc_html__( 'Finish Cost Setup so MarginBeacon can resolve product costs. Incomplete coverage never produces Safe.', 'marginbeacon' ),
			esc_url( Tabs::url( Tabs::COST_SETUP ) ),
			esc_html__( 'Open COGS Wizard', 'marginbeacon' )
		);
	}

	/**
	 * Human labels for each wizard step, keyed by step number.
	 *
	 * @return array<int,string>
	 */
	public static function step_labels() {
		return array(
			1 => __( 'Environment', 'marginbeacon' ),
			2 => __( 'Cost source', 'marginbeacon' ),
			3 => __( 'Coverage', 'marginbeacon' ),
			4 => __( 'Acknowledge', 'marginbeacon' ),
			5 => __( 'Next steps', 'marginbeacon' ),
		);
	}

	/**
	 * Render wizard.
	 *
	 * @return void
	 */
	public function render() {
		if ( ! Capabilities::current_user_can_manage() ) {
			wp_die( esc_html__( 'You do not have permission to access MarginBeacon.', 'marginbeacon' ) );
		}

		// Captured before settings_errors() prints and clears them, so a field
		// can also show its error next to the input.
		$errors_by_code = array();
		foreach ( (array) get_settings_errors( 'aksmb_wizard' ) as $wizard_error ) {
			if ( ! empty( $wizard_error['code'] ) ) {
				$errors_by_code[ (string) $wizard_error['code'] ] = (string) $wizard_error['message'];
			}
		}
		settings_errors( 'aksmb_wizard' );

		$state = $this->get_state();
		$step  = isset( $_GET['step'] ) ? absint( $_GET['step'] ) : (int) $state['step']; // phpcs:ignore WordPress.Security.NonceVerification.Recommended
		if ( $step < 1 || $step > 5 ) {
			$step = (int) $state['step'];
		}

		$env      = ( new CogsEnvironment() )->detect();
		$coverage = ( new CostCoverageService() )->summarize( 25 );
		$cost     = get_option( Constants::OPTION_COST_SETTINGS, array() );
		if ( ! is_array( $cost ) ) {
			$cost = array();
		}

		$labels      = self::step_labels();
		$total_steps = count( self::STEPS );
		?>
		<div class="aksmb-wizard">
		<p class="aksmb-tagline">
			<?php echo esc_html__( 'Configure how MarginBeacon resolves tax-exclusive product costs. Missing cost never becomes Safe.', 'marginbeacon' ); ?>
		</p>

			<div class="aksmb-wizard-header">
				<p class="aksmb-wizard-progress">
					<?php
					echo esc_html(
						sprintf(
							/* translators: 1: current step number, 2: total steps, 3: step name */
							__( 'Step %1$d of %2$d — %3$s', 'marginbeacon' ),
							$step,
							$total_steps,
							$labels[ $step ]
						)
					);
					?>
				</p>
				<div
					class="aksmb-wizard-progress-bar"
					role="progressbar"
					aria-valuemin="1"
					aria-valuemax="<?php echo esc_attr( (string) $total_steps ); ?>"
					aria-valuenow="<?php echo esc_attr( (string) $step ); ?>"
					aria-label="<?php echo esc_attr__( 'COGS setup progress', 'marginbeacon' ); ?>"
				>
					<span class="aksmb-wizard-progress-bar__fill" style="width:<?php echo esc_attr( (string) round( ( $step / $total_steps ) * 100 ) ); ?>%"></span>
				</div>
			</div>

			<ol class="aksmb-wizard-steps" aria-label="<?php echo esc_attr__( 'COGS setup steps', 'marginbeacon' ); ?>">
				<?php foreach ( self::STEPS as $num => $slug ) : ?>
					<?php
					$step_state = $num === $step ? 'current' : ( $num < $step ? 'done' : 'upcoming' );
					?>
					<li
						class="aksmb-wizard-steps__item is-<?php echo esc_attr( $step_state ); ?>"
						<?php echo $num === $step ? ' aria-current="step"' : ''; ?>
					>
						<span class="aksmb-wizard-steps__num" aria-hidden="true">
							<?php echo 'done' === $step_state ? '✓' : esc_html( (string) $num ); ?>
						</span>
						<span class="aksmb-wizard-steps__label"><?php echo esc_html( $labels[ $num ] ); ?></span>
						<span class="screen-reader-text">
							<?php
							echo esc_html(
								'done' === $step_state
									? __( '(completed)', 'marginbeacon' )
									: ( 'current' === $step_state ? __( '(current step)', 'marginbeacon' ) : __( '(not started)', 'marginbeacon' ) )
							);
							?>
						</span>
					</li>
				<?php endforeach; ?>
			</ol>

			<form method="post" class="aksmb-wizard-panel aksmb-panel--dashboard" novalidate>
				<?php wp_nonce_field( 'aksmb_cogs_wizard', 'aksmb_wizard_nonce' ); ?>
				<input type="hidden" name="wizard_step" value="<?php echo esc_attr( (string) $step ); ?>" />

				<?php
				switch ( $step ) {
					case 1:
						$this->render_step_environment( $env );
						break;
					case 2:
						$this->render_step_source( $cost, $env, $errors_by_code );
						break;
					case 3:
						$this->render_step_coverage( $coverage );
						break;
					case 4:
						$this->render_step_acknowledge( $cost, $errors_by_code );
						break;
					case 5:
						$this->render_step_complete( $coverage, $state );
						break;
				}
				?>

				<?php if ( 5 !== $step ) : ?>
					<p class="aksmb-wizard-actions">
						<?php if ( $step > 1 ) : ?>
							<button type="submit" name="wizard_action" value="back" class="button"><?php echo esc_html__( 'Back', 'marginbeacon' ); ?></button>
						<?php endif; ?>
						<button type="submit" name="wizard_action" value="next" class="button button-primary">
							<?php echo esc_html( 4 === $step ? __( 'Finish setup', 'marginbeacon' ) : __( 'Continue', 'marginbeacon' ) ); ?>
						</button>
					</p>
				<?php endif; ?>
			</form>
		</div>
		<?php
	}

	/**
	 * Step 1 — environment detection panel.
	 *
	 * @param array $env Environment.
	 * @return void
	 */
	private function render_step_environment( array $env ) {
		?>
		<div class="aksmb-section-header">
			<h2><?php echo esc_html__( '1. Environment check', 'marginbeacon' ); ?></h2>
		</div>
		<p class="aksmb-panel__lead"><?php echo esc_html__( 'Confirm the store can supply tax-exclusive costs before you configure sources and coverage.', 'marginbeacon' ); ?></p>

		<ul class="aksmb-kv aksmb-kv--compact">
			<li><span><?php echo esc_html__( 'WooCommerce', 'marginbeacon' ); ?></span><strong><?php echo esc_html( (string) $env['wc_version'] ); ?></strong></li>
			<li>
				<span><?php echo esc_html__( 'Native WooCommerce COGS', 'marginbeacon' ); ?></span>
				<strong>
					<?php
					if ( 'enabled' === $env['native_cogs_status'] ) {
						echo esc_html__( 'Enabled', 'marginbeacon' );
					} elseif ( 'available_disabled' === $env['native_cogs_status'] ) {
						echo esc_html__( 'Available but disabled', 'marginbeacon' );
					} else {
						echo esc_html__( 'Not available on this version', 'marginbeacon' );
					}
					?>
				</strong>
			</li>
		</ul>

		<?php if ( ! empty( $env['has_third_party_cogs'] ) ) : ?>
			<div class="notice notice-warning inline aksmb-wizard-notice">
				<p>
					<?php echo esc_html__( 'Third-party cost plugin detected. MarginBeacon V1 prefers native WooCommerce COGS or MarginBeacon manual cost. Third-party values are not assumed to be Exact.', 'marginbeacon' ); ?>
				</p>
				<ul>
					<?php foreach ( $env['third_party_cogs'] as $plugin ) : ?>
						<li><?php echo esc_html( $plugin['name'] ); ?></li>
					<?php endforeach; ?>
				</ul>
			</div>
		<?php endif; ?>

		<div class="aksmb-callout">
			<p><?php echo esc_html__( 'MarginBeacon calculates gross product margin estimates only — not net profit, shipping cost, tax, or fees. Results are not financial advice.', 'marginbeacon' ); ?></p>
			<p><?php echo esc_html__( 'Exact = resolved from native/manual cost. Estimated = assumed-cost fallback. Missing = Unknown, never Safe.', 'marginbeacon' ); ?></p>
		</div>
		<?php
	}

	/**
	 * Step 2 — cost source configuration panel.
	 *
	 * @param array $cost   Cost settings.
	 * @param array $env    Environment.
	 * @param array $errors Settings errors keyed by code, shown next to fields.
	 * @return void
	 */
	private function render_step_source( array $cost, array $env, array $errors = array() ) {
		$percent_error = isset( $errors['percent'] ) ? (string) $errors['percent'] : '';
		$current       = isset( $cost['canonical_cost_source'] )
			? (string) $cost['canonical_cost_source']
			: ( ! empty( $env['native_cogs_enabled'] ) ? CanonicalCostSource::WOOCOMMERCE : CanonicalCostSource::MARGINBEACON );
		?>
		<div class="aksmb-section-header">
			<h2><?php echo esc_html__( '2. Choose cost source', 'marginbeacon' ); ?></h2>
		</div>
		<p class="aksmb-panel__lead"><?php echo esc_html__( 'Pick one canonical Exact cost source. Only one source is active at a time.', 'marginbeacon' ); ?></p>

		<table class="form-table aksmb-form-table">
			<tr>
				<th scope="row"><?php echo esc_html__( 'Canonical cost source', 'marginbeacon' ); ?></th>
				<td>
					<fieldset>
						<label>
							<input type="radio" name="canonical_cost_source" value="woocommerce" <?php checked( $current, CanonicalCostSource::WOOCOMMERCE ); ?> <?php disabled( empty( $env['native_cogs_enabled'] ) ); ?> />
							<?php echo esc_html__( 'WooCommerce COGS', 'marginbeacon' ); ?>
						</label><br />
						<label>
							<input type="radio" name="canonical_cost_source" value="marginbeacon" <?php checked( $current, CanonicalCostSource::MARGINBEACON ); ?> />
							<?php echo esc_html__( 'MarginBeacon Cost', 'marginbeacon' ); ?>
						</label>
					</fieldset>
					<?php if ( empty( $env['native_cogs_enabled'] ) ) : ?>
						<p class="description">
							<?php echo esc_html__( 'Native COGS is not enabled. You can use MarginBeacon Cost now, or enable WooCommerce COGS and revisit migration later.', 'marginbeacon' ); ?>
							<a href="<?php echo esc_url( $env['csv_importer_url'] ); ?>"><?php echo esc_html__( 'Open product importer', 'marginbeacon' ); ?></a>
						</p>
					<?php else : ?>
						<p class="description">
							<a href="<?php echo esc_url( $env['csv_importer_url'] ); ?>"><?php echo esc_html__( 'Bulk update via WooCommerce Product CSV Importer', 'marginbeacon' ); ?></a>
							·
							<a href="<?php echo esc_url( Tabs::url( Tabs::COST_SETUP, array( 'view' => 'migration' ) ) ); ?>"><?php echo esc_html__( 'COGS Migration Review', 'marginbeacon' ); ?></a>
						</p>
					<?php endif; ?>
				</td>
			</tr>
			<tr>
				<th scope="row"><?php echo esc_html__( 'Global assumed-cost fallback', 'marginbeacon' ); ?></th>
				<td>
					<label>
						<input type="checkbox" id="aksmb_fallback_enabled" name="fallback_enabled" value="1" <?php checked( ! empty( $cost['fallback_enabled'] ) ); ?> />
						<?php echo esc_html__( 'Enable estimated fallback for items without Exact cost (MarginBeacon source only)', 'marginbeacon' ); ?>
					</label>
					<p>
						<label for="aksmb_assumed_percent"><?php echo esc_html__( 'Assumed cost as % of regular price', 'marginbeacon' ); ?></label>
						<?php
						$input_class = 'small-text';
						$aria_attrs  = '';
						if ( '' !== $percent_error ) {
							$input_class = 'small-text aksmb-field--invalid';
							$aria_attrs  = ' aria-invalid="true" aria-describedby="aksmb-assumed-percent-error"';
						}
						?>
						<input type="number" id="aksmb_assumed_percent" min="0" max="100" step="0.01" name="global_assumed_cost_percent" class="<?php echo esc_attr( $input_class ); ?>"<?php echo $aria_attrs; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- static ARIA keys only. ?> value="<?php echo esc_attr( isset( $cost['global_assumed_cost_percent'] ) ? (string) $cost['global_assumed_cost_percent'] : '' ); ?>" />
						<?php if ( '' !== $percent_error ) : ?>
							<span id="aksmb-assumed-percent-error" class="aksmb-field-error" role="alert"><?php echo esc_html( $percent_error ); ?></span>
						<?php endif; ?>
					</p>
					<p class="description"><?php echo esc_html__( 'Results using this rule are marked Estimated. Category assumed-cost rules are Pro-only.', 'marginbeacon' ); ?></p>
				</td>
			</tr>
			<tr>
				<th scope="row"><label for="aksmb_custom_meta_key"><?php echo esc_html__( 'Custom product meta key (optional)', 'marginbeacon' ); ?></label></th>
				<td>
					<input type="text" id="aksmb_custom_meta_key" name="custom_meta_key" class="regular-text"
						value="<?php echo esc_attr( isset( $cost['custom_meta_key'] ) ? (string) $cost['custom_meta_key'] : '' ); ?>"
						placeholder="_my_cost_meta" />
					<p class="description"><?php echo esc_html__( 'Read a numeric tax-exclusive cost from this meta key when native/manual values are empty.', 'marginbeacon' ); ?></p>
				</td>
			</tr>
		</table>

		<p class="aksmb-panel__note">
			<?php echo esc_html__( 'You can also set “MarginBeacon cost” on each product or variation in the product editor. MarginBeacon never writes native WooCommerce COGS automatically.', 'marginbeacon' ); ?>
		</p>
		<?php
	}

	/**
	 * Step 3 — catalog cost coverage preview.
	 *
	 * @param array $coverage Coverage summary.
	 * @return void
	 */
	private function render_step_coverage( array $coverage ) {
		$coverage_pct = isset( $coverage['coverage_percent'] ) ? (string) $coverage['coverage_percent'] : '0';
		$total        = isset( $coverage['total'] ) ? (int) $coverage['total'] : 0;
		?>
		<div class="aksmb-section-header">
			<h2><?php echo esc_html__( '3. Preview coverage', 'marginbeacon' ); ?></h2>
		</div>
		<p class="aksmb-panel__lead"><?php echo esc_html__( 'Review how many supported catalog items already resolve to Exact or Estimated cost.', 'marginbeacon' ); ?></p>

		<?php if ( 0 === $total ) : ?>
			<div class="aksmb-empty">
				<p class="aksmb-empty__title"><?php echo esc_html__( 'No supported products found yet.', 'marginbeacon' ); ?></p>
				<p><?php echo esc_html__( 'Add a product with a price, then return here to see exact, estimated, and missing cost coverage.', 'marginbeacon' ); ?></p>
			</div>
		<?php else : ?>
			<div class="aksmb-coverage">
				<div class="aksmb-stat-row">
					<div class="aksmb-stat">
						<p class="aksmb-stat__value"><?php echo esc_html( $coverage_pct ); ?><span class="aksmb-stat__unit">%</span></p>
						<p class="aksmb-stat__label"><?php echo esc_html__( 'Resolved costs', 'marginbeacon' ); ?></p>
					</div>
					<div class="aksmb-stat-row__copy">
						<p class="aksmb-coverage__summary"><strong><?php echo esc_html( $coverage['summary_line'] ); ?></strong></p>
						<p class="aksmb-coverage__breakdown"><?php echo esc_html( $coverage['breakdown_line'] ); ?></p>
					</div>
				</div>
				<div
					class="aksmb-coverage__bar"
					role="img"
					aria-label="<?php echo esc_attr( $coverage['summary_line'] . ' ' . $coverage['breakdown_line'] ); ?>"
				>
					<span class="is-exact" style="width:<?php echo esc_attr( (string) $coverage['exact_percent'] ); ?>%"></span>
					<span class="is-estimated" style="width:<?php echo esc_attr( (string) $coverage['estimated_percent'] ); ?>%"></span>
					<span class="is-missing" style="width:<?php echo esc_attr( (string) $coverage['missing_percent'] ); ?>%"></span>
				</div>
				<ul class="aksmb-coverage__legend">
					<li><span class="aksmb-coverage__swatch is-exact" aria-hidden="true"></span><?php echo esc_html__( 'Exact', 'marginbeacon' ); ?></li>
					<li><span class="aksmb-coverage__swatch is-estimated" aria-hidden="true"></span><?php echo esc_html__( 'Estimated', 'marginbeacon' ); ?></li>
					<li><span class="aksmb-coverage__swatch is-missing" aria-hidden="true"></span><?php echo esc_html__( 'Missing', 'marginbeacon' ); ?></li>
				</ul>
			</div>
		<?php endif; ?>

		<?php if ( ! empty( $coverage['missing_items'] ) ) : ?>
			<h3 class="aksmb-panel__subheading"><?php echo esc_html__( 'Missing cost sample', 'marginbeacon' ); ?></h3>
			<div class="aksmb-table-scroll">
				<table class="widefat striped aksmb-table">
					<thead>
						<tr>
							<th scope="col"><?php echo esc_html__( 'Product', 'marginbeacon' ); ?></th>
							<th scope="col"><?php echo esc_html__( 'Reason', 'marginbeacon' ); ?></th>
							<th scope="col"><?php echo esc_html__( 'Edit', 'marginbeacon' ); ?></th>
						</tr>
					</thead>
					<tbody>
						<?php foreach ( $coverage['missing_items'] as $item ) : ?>
							<tr>
								<td><?php echo esc_html( $item['name'] ); ?></td>
								<td><code><?php echo esc_html( $item['reason_code'] ); ?></code></td>
								<td>
									<?php if ( ! empty( $item['edit_url'] ) ) : ?>
										<a href="<?php echo esc_url( $item['edit_url'] ); ?>"><?php echo esc_html__( 'Edit', 'marginbeacon' ); ?></a>
									<?php else : ?>
										—
									<?php endif; ?>
								</td>
							</tr>
						<?php endforeach; ?>
					</tbody>
				</table>
			</div>
			<p class="aksmb-panel__note"><?php echo esc_html__( 'Low coverage does not block activation, but Safe is never assigned while cost is missing.', 'marginbeacon' ); ?></p>
		<?php elseif ( $total > 0 ) : ?>
			<p class="aksmb-panel__note"><?php echo esc_html__( 'No missing supported items in the current catalog sample.', 'marginbeacon' ); ?></p>
		<?php endif; ?>
		<?php
	}

	/**
	 * Step 4 — required acknowledgement checkboxes.
	 *
	 * @param array $cost   Cost settings.
	 * @param array $errors Settings errors keyed by code, shown as summary + near fields.
	 * @return void
	 */
	private function render_step_acknowledge( array $cost, array $errors = array() ) {
		$ack_error = isset( $errors['ack'] ) ? (string) $errors['ack'] : '';
		?>
		<div class="aksmb-section-header">
			<h2><?php echo esc_html__( '4. Acknowledgement', 'marginbeacon' ); ?></h2>
		</div>
		<p class="aksmb-panel__lead"><?php echo esc_html__( 'Confirm the evaluation scope and tax basis before MarginBeacon marks setup complete.', 'marginbeacon' ); ?></p>

		<?php if ( '' !== $ack_error ) : ?>
			<div class="aksmb-callout aksmb-callout--critical" role="alert">
				<p><?php echo esc_html( $ack_error ); ?></p>
			</div>
		<?php endif; ?>

		<div class="aksmb-callout">
			<ul>
				<li><?php echo esc_html__( 'Calculated: gross product margin from merchandise line revenue and resolved unit costs.', 'marginbeacon' ); ?></li>
				<li><?php echo esc_html__( 'Not calculated: shipping, tax, payment fees, overhead, or net profit.', 'marginbeacon' ); ?></li>
				<li><?php echo esc_html__( 'MarginBeacon never blocks checkout or modifies customer coupons.', 'marginbeacon' ); ?></li>
				<li><?php echo esc_html__( 'Base-currency only in V1 for deterministic evaluation; multi-currency orders become Unknown.', 'marginbeacon' ); ?></li>
			</ul>
		</div>

		<table class="form-table aksmb-form-table">
			<tr>
				<th scope="row"><?php echo esc_html__( 'COGS tax basis', 'marginbeacon' ); ?></th>
				<td>
					<label class="aksmb-choice">
						<input type="radio" name="cogs_tax_basis" value="exclusive" <?php checked( empty( $cost['cogs_tax_basis'] ) || 'exclusive' === $cost['cogs_tax_basis'] ); ?> />
						<?php echo esc_html__( 'My cost values are tax-exclusive (required for Safe)', 'marginbeacon' ); ?>
					</label>
					<label class="aksmb-choice">
						<input type="radio" name="cogs_tax_basis" value="inclusive" <?php checked( isset( $cost['cogs_tax_basis'] ) && 'inclusive' === $cost['cogs_tax_basis'] ); ?> />
						<?php echo esc_html__( 'My cost values include tax (blocks Safe until corrected)', 'marginbeacon' ); ?>
					</label>
				</td>
			</tr>
		</table>

		<fieldset class="aksmb-ack-fieldset">
			<legend class="screen-reader-text"><?php echo esc_html__( 'Required acknowledgements', 'marginbeacon' ); ?></legend>
			<p><label><input type="checkbox" name="ack_scope" value="1" required /> <?php echo esc_html__( 'I understand MarginBeacon reports gross product margin estimates only, not financial or accounting advice.', 'marginbeacon' ); ?></label></p>
			<p><label><input type="checkbox" name="ack_incomplete" value="1" required /> <?php echo esc_html__( 'I understand incomplete cost coverage never produces a Safe result.', 'marginbeacon' ); ?></label></p>
			<p><label><input type="checkbox" name="ack_tax_exclusive" value="1" required /> <?php echo esc_html__( 'I confirm the tax-basis choice above and that Safe requires tax-exclusive costs.', 'marginbeacon' ); ?></label></p>
		</fieldset>
		<?php
	}

	/**
	 * Step 5 — completion summary and next actions.
	 *
	 * @param array $coverage Coverage.
	 * @param array $state    Wizard state.
	 * @return void
	 */
	private function render_step_complete( array $coverage, array $state ) {
		$coverage_pct = isset( $coverage['coverage_percent'] ) ? (string) $coverage['coverage_percent'] : '0';
		?>
		<div class="aksmb-section-header">
			<h2><?php echo esc_html__( '5. Setup saved', 'marginbeacon' ); ?></h2>
			<span class="aksmb-badge aksmb-badge--safe"><?php echo esc_html__( 'Complete', 'marginbeacon' ); ?></span>
		</div>
		<p class="aksmb-panel__lead"><?php echo esc_html__( 'Cost settings are stored. Free next step: run a selected-coupon preflight (coming next in V0.9).', 'marginbeacon' ); ?></p>

		<div class="aksmb-coverage">
			<div class="aksmb-stat-row">
				<div class="aksmb-stat">
					<p class="aksmb-stat__value"><?php echo esc_html( $coverage_pct ); ?><span class="aksmb-stat__unit">%</span></p>
					<p class="aksmb-stat__label"><?php echo esc_html__( 'Resolved costs', 'marginbeacon' ); ?></p>
				</div>
				<div class="aksmb-stat-row__copy">
					<p class="aksmb-coverage__summary"><strong><?php echo esc_html( $coverage['summary_line'] ); ?></strong></p>
					<p class="aksmb-coverage__breakdown"><?php echo esc_html( $coverage['breakdown_line'] ); ?></p>
				</div>
			</div>
		</div>
		<?php if ( ! empty( $state['completed_at_gmt'] ) ) : ?>
			<p class="aksmb-panel__note"><?php echo esc_html( sprintf( /* translators: %s: GMT datetime */ __( 'Completed at %s GMT', 'marginbeacon' ), $state['completed_at_gmt'] ) ); ?></p>
		<?php endif; ?>
		<p class="aksmb-wizard-actions">
			<a class="button button-primary" href="<?php echo esc_url( Tabs::url( Tabs::PREFLIGHT ) ); ?>"><?php echo esc_html__( 'Run first coupon preflight', 'marginbeacon' ); ?></a>
			<a class="button" href="<?php echo esc_url( Tabs::url( Tabs::DASHBOARD ) ); ?>"><?php echo esc_html__( 'Back to Dashboard', 'marginbeacon' ); ?></a>
			<a class="button" href="<?php echo esc_url( admin_url( 'edit.php?post_type=product' ) ); ?>"><?php echo esc_html__( 'Edit products / costs', 'marginbeacon' ); ?></a>
			<a class="button" href="<?php echo esc_url( Tabs::url( Tabs::COST_SETUP, array( 'step' => 1 ) ) ); ?>"><?php echo esc_html__( 'Revisit wizard', 'marginbeacon' ); ?></a>
		</p>
		<?php
	}

	/**
	 * Load persisted wizard state with defaults.
	 *
	 * @return array
	 */
	private function get_state() {
		$state = get_option( Constants::OPTION_WIZARD_STATE, array() );
		if ( ! is_array( $state ) ) {
			$state = array();
		}
		return array_merge(
			array(
				'step'      => 1,
				'completed' => false,
			),
			$state
		);
	}

	/**
	 * Persist wizard state to options.
	 *
	 * @param array $state State.
	 * @return void
	 */
	private function save_state( array $state ) {
		update_option( Constants::OPTION_WIZARD_STATE, $state, false );
	}

	/**
	 * Redirect back to wizard tab for the given step.
	 *
	 * @param int $step Step.
	 * @return void
	 */
	private function redirect_step( $step ) {
		wp_safe_redirect( Tabs::url( Tabs::COST_SETUP, array( 'step' => (int) $step ) ) );
		exit;
	}
}