Spec: Custom Shipping Method with Pickup Points & Interactive Map Integration

<?php
declare(strict_types=1);

if (!defined('ABSPATH')) exit;

class WC_Shipping_Pvz extends \WC_Shipping_Method {
    public function __construct(int $instance_id = 0) {
        $this->id                 = 'pvz_shipping';
        $this->instance_id        = $instance_id;
        $this->method_title       = __('Доставка в ПВЗ (Самовывоз)', 'agenticlab');
        $this->method_description = __('Доставка до пункта выдачи с динамическим расчетом по весу и картой.', 'agenticlab');
        $this->supports           = ['shipping-zones', 'instance-settings'];

        $this->init();
    }

    public function init(): void {
        $this->init_form_fields();
        $this->init_settings();

        $this->title = $this->get_option('title', 'Самовывоз из ПВЗ');
        $this->enabled = $this->get_option('enabled', 'yes');

        add_action('woocommerce_update_options_shipping_' . $this->id, [$this, 'process_admin_options']);
    }

    public function init_form_fields(): void {
        $this->form_fields = [
            'enabled' => [
                'title'   => __('Включить', 'agenticlab'),
                'type'    => 'checkbox',
                'default' => 'yes',
            ],
            'title' => [
                'title'   => __('Название на чекауте', 'agenticlab'),
                'type'    => 'text',
                'default' => __('Пункт выдачи заказов (ПВЗ)', 'agenticlab'),
            ],
            'base_cost' => [
                'title'   => __('Базовая стоимость ($)', 'agenticlab'),
                'type'    => 'price',
                'default' => '250',
            ],
            'cost_per_kg' => [
                'title'   => __('Доплата за каждый 1 кг ($)', 'agenticlab'),
                'type'    => 'price',
                'default' => '50',
            ],
        ];
    }

    public function calculate_shipping($package = []): void {
        $base_cost = (float) $this->get_option('base_cost', 250);
        $cost_per_kg = (float) $this->get_option('cost_per_kg', 50);

        $total_weight = 0.0;
        foreach ($package['contents'] as $item) {
            /** @var \WC_Product $product */
            $product = $item['data'];
            $weight = (float) $product->get_weight();
            $total_weight += ($weight * (int) $item['quantity']);
        }

        $final_cost = $base_cost + ($total_weight * $cost_per_kg);

        $this->add_rate([
            'id'        => $this->get_rate_id(),
            'label'     => $this->title,
            'cost'      => $final_cost,
            'package'   => $package,
        ]);
    }
}

add_filter('woocommerce_shipping_methods', function ($methods) {
    $methods['pvz_shipping'] = 'WC_Shipping_Pvz';
    return $methods;
});