<?php
/**
 * Courier order status module.
 *
 * @package Rahkar\WP
 */

declare( strict_types = 1 );

namespace Rahkar\WP\Modules\CourierStatus;

use Rahkar\WP\Modules\BaseModule;
use Rahkar\WP\Plugin;

defined( 'ABSPATH' ) || exit;

/**
 * Adds «پیک موتوری» as a WooCommerce order status.
 *
 * Ported out of `rahkartheme`, where it was a structural mistake rather than a
 * stylistic one: a theme that registers an order status takes the orders with
 * it when it is switched off. See {@see CourierStatus} for what that breaks.
 *
 * No settings. The module card's on/off switch is the whole configuration,
 * which is right for a store that does not do same-city motorbike delivery —
 * turning it off is the correct way to not have the status, rather than hiding
 * it behind an option inside a module that is loaded anyway.
 *
 * The context mask is wide because a status is not a screen: it has to be
 * registered wherever an order can change state, which includes REST, cron and
 * WP-CLI, not just the orders list. The cost is bounded all the same — the
 * module registers four callbacks and constructs nothing until one fires.
 */
final class CourierStatusModule extends BaseModule {

	public const SLUG = 'courier_status';

	/**
	 * Every hook here is a WooCommerce hook, and the status only means anything
	 * inside WooCommerce's order machinery.
	 *
	 * @var bool
	 */
	protected bool $requiresWooCommerce = true;

	/**
	 * {@inheritDoc}
	 */
	public function slug(): string {
		return self::SLUG;
	}

	/**
	 * {@inheritDoc}
	 */
	public function name(): string {
		return __( 'وضعیت سفارش پیک موتوری', 'rahkar-toolkit' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function description(): string {
		return __( 'یک وضعیت سفارش تازه بین «در حال انجام» و «تکمیل شده» برای سفارش‌هایی که به پیک موتوری تحویل داده شده‌اند. در فهرست سفارش‌ها به‌صورت دسته‌جمعی قابل تغییر است و نشان رنگی جدا دارد.', 'rahkar-toolkit' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function register(): void {
		add_action(
			'init',
			static fn() => Plugin::make( CourierStatus::class )->register()
		);

		add_filter(
			'wc_order_statuses',
			static fn( $statuses ): array => Plugin::make( CourierStatus::class )->addToDropdown( $statuses )
		);

		// Both order list tables: HPOS and the legacy post table.
		foreach ( [ 'bulk_actions-woocommerce_page_wc-orders', 'bulk_actions-edit-shop_order' ] as $filter ) {
			add_filter(
				$filter,
				static fn( $actions ): array => Plugin::make( CourierStatus::class )->addBulkAction( $actions )
			);
		}

		add_action(
			'admin_head',
			static fn() => Plugin::make( CourierStatus::class )->badgeStyle()
		);
	}
}