<?php

declare(strict_types=1);

namespace DS82\ThreeDPrintShowcase\Admin;

use DS82\ThreeDPrintShowcase\Core\Settings;
use DS82\ThreeDPrintShowcase\Integrations\IntegrationRegistry;
use DS82\ThreeDPrintShowcase\Integrations\AddonCatalog;
use DS82\ThreeDPrintShowcase\Materials\Material;
use DS82\ThreeDPrintShowcase\Materials\InternalMaterialProvider;
use DS82\ThreeDPrintShowcase\Materials\MaterialProviderRegistry;
use DS82\ThreeDPrintShowcase\Materials\MaterialRepository;
use DS82\ThreeDPrintShowcase\Materials\MaterialOverrideStore;

defined('ABSPATH') || exit;

final class AdminPages
{
    public function __construct(
        private readonly MaterialRepository $materials,
        private readonly MaterialProviderRegistry $providers,
        private readonly IntegrationRegistry $integrations,
        private readonly MaterialOverrideStore $overrides
    ) {}

    public function register(): void
    {
        add_action('admin_menu', [$this, 'menu'], 90);
        add_action('admin_enqueue_scripts', [$this, 'assets']);
        add_action('admin_post_ds82_3dps_save_settings', [$this, 'save_settings']);
        add_action('admin_post_ds82_3dps_sync_materials', [$this, 'sync_materials']);
        add_action('admin_post_ds82_3dps_test_provider', [$this, 'test_provider']);
        add_action('admin_post_ds82_3dps_clear_cache', [$this, 'clear_cache']);
        add_action('admin_post_ds82_3dps_export_settings', [$this, 'export_settings']);
        add_action('admin_post_ds82_3dps_import_settings', [$this, 'import_settings']);
        add_action('admin_post_ds82_3dps_reset_settings', [$this, 'reset_settings']);
        add_action('admin_post_ds82_3dps_save_internal_material', [$this, 'save_internal_material']);
        add_action('admin_post_ds82_3dps_delete_internal_material', [$this, 'delete_internal_material']);
        add_action('admin_post_ds82_3dps_save_material_override', [$this, 'save_material_override']);
        add_action('admin_post_ds82_3dps_reset_material_override', [$this, 'reset_material_override']);
        add_action('admin_post_ds82_3dps_addon_action', [$this, 'addon_action']);
        add_action('admin_post_ds82_3dps_refresh_addons', [$this, 'refresh_addons']);
    }

    public function menu(): void
    {
        $parent = 'ds82-3dps';
        $capability = $this->capability();

        add_menu_page(
            __('3D Print Showcase', '3d-print-showcase'),
            __('3D Print Showcase', '3d-print-showcase'),
            $capability,
            $parent,
            [$this, 'info_page'],
            $this->menu_icon(),
            58
        );

        // Keep the WordPress administration menu focused on the three primary pages.
        add_submenu_page($parent, __('Info', '3d-print-showcase'), __('Info', '3d-print-showcase'), $capability, $parent, [$this, 'info_page']);
        add_submenu_page($parent, __('Settings', '3d-print-showcase'), __('Settings', '3d-print-showcase'), $capability, 'ds82-3dps-settings', [$this, 'settings_page']);
        add_submenu_page($parent, __('User 3D Viewer', '3d-print-showcase'), __('User 3D Viewer', '3d-print-showcase'), $capability, 'ds82-3dps-user-viewer', [$this, 'user_viewer_page']);

        // Register detail pages as hidden admin pages. They remain available through
        // the internal Settings navigation without extending the left admin menu.
        add_submenu_page(null, __('Materials', '3d-print-showcase'), __('Materials', '3d-print-showcase'), $capability, 'ds82-3dps-materials', [$this, 'materials_page']);
        add_submenu_page(null, __('Shortcode Builder', '3d-print-showcase'), __('Shortcode Builder', '3d-print-showcase'), $capability, 'ds82-3dps-shortcode-builder', [$this, 'shortcode_builder_page']);
        add_submenu_page(null, __('Addons', '3d-print-showcase'), __('Addons', '3d-print-showcase'), $capability, 'ds82-3dps-integrations', [$this, 'integrations_page']);
        add_submenu_page(null, __('Diagnostics', '3d-print-showcase'), __('Diagnostics', '3d-print-showcase'), $capability, 'ds82-3dps-diagnostics', [$this, 'diagnostics_page']);
        add_submenu_page(null, __('Tools', '3d-print-showcase'), __('Tools', '3d-print-showcase'), $capability, 'ds82-3dps-tools', [$this, 'tools_page']);
        add_submenu_page(null, __('Documentation', '3d-print-showcase'), __('Documentation', '3d-print-showcase'), $capability, 'ds82-3dps-documentation', [$this, 'documentation_page']);
    }


    private function menu_icon(): string
    {
        // WordPress allocates a 20 × 20 px menu icon box. The artwork is inset
        // to approximately 16 × 16 px so it visually matches native Dashicons.
        $svg = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 20" aria-hidden="true"><g transform="translate(2 2) scale(.6666667)" fill="none" stroke="currentColor" stroke-width="1.65" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2.25 20 6.6v9L12 21.75 4 17.4V6.6Z"/><path d="m4 6.6 8 4.35 8-4.35M12 10.95v10.8"/></g><path fill="currentColor" d="M7.1 11.65h3.05c1.95 0 3.1.86 3.1 2.23 0 .83-.43 1.47-1.22 1.82.94.3 1.45 1.02 1.45 1.98 0 1.61-1.25 2.57-3.38 2.57h-3v-1.84h2.9c.8 0 1.23-.31 1.23-.9 0-.57-.42-.87-1.27-.87H8.5v-1.73h1.38c.74 0 1.12-.29 1.12-.8 0-.52-.39-.79-1.17-.79H7.1Zm7.12 0h2.57c2.46 0 4.05 1.65 4.05 4.29 0 2.69-1.59 4.31-4.05 4.31h-2.57Zm2.08 1.82v4.96h.39c1.28 0 2.03-.88 2.03-2.48 0-1.59-.75-2.48-2.03-2.48Z" transform="translate(3.85 4.5) scale(.45)"/></svg>';

        return 'data:image/svg+xml;base64,' . base64_encode($svg);
    }

    public function assets(string $hook): void
    {
        $page = sanitize_key((string) filter_input(INPUT_GET, 'page', FILTER_UNSAFE_RAW));
        if (!str_starts_with($page, 'ds82-3dps')) {
            return;
        }
        wp_enqueue_style('ds82-3dps-admin', DS82_3DPS_URL . 'assets/css/admin.css', [], DS82_3DPS_VERSION);

        // Keep the primary 3D Print Showcase navigation identical on every
        // core/add-on administration page. Add-ons may have their own local
        // sub-navigation, but the primary navigation always comes from the
        // main plugin's canonical tab registry.
        wp_enqueue_script('ds82-3dps-admin-navigation', DS82_3DPS_URL . 'assets/js/admin/navigation.js', [], DS82_3DPS_VERSION, true);
        $canonicalTabs = [];
        foreach ($this->tabs() as $slug => $label) {
            $canonicalTabs[] = [
                'slug' => (string) $slug,
                'label' => (string) $label,
                'url' => admin_url('admin.php?page=' . $slug),
            ];
        }
        wp_localize_script('ds82-3dps-admin-navigation', 'DS823DPSAdminNavigation', [
            'tabs' => $canonicalTabs,
            'currentPage' => $page,
        ]);

        if ('ds82-3dps-materials' === $page) {
            wp_enqueue_script('ds82-3dps-material-admin', DS82_3DPS_URL . 'assets/js/admin/materials.js', [], DS82_3DPS_VERSION, true);
        }
    }

    public function info_page(): void
    {
        $this->guard_page();

        $installedVersion = DS82_3DPS_VERSION;
        $remoteVersion = $this->available_plugin_version();
        $versionStatus = 'unknown';

        if (is_string($remoteVersion) && '' !== $remoteVersion) {
            $versionStatus = version_compare($installedVersion, $remoteVersion, '>=') ? 'current' : 'update';
        }

        $this->header(__('Info', '3d-print-showcase'));
        ?>
        <div class="ds82-3dps-version-grid">
            <div class="ds82-3dps-card ds82-3dps-version-card">
                <span class="ds82-3dps-version-label"><?php esc_html_e('Installed version', '3d-print-showcase'); ?></span>
                <strong class="ds82-3dps-version-number"><?php echo esc_html($installedVersion); ?></strong>
            </div>

            <div class="ds82-3dps-card ds82-3dps-version-card">
                <span class="ds82-3dps-version-label"><?php esc_html_e('Available version', '3d-print-showcase'); ?></span>
                <?php if (is_string($remoteVersion) && '' !== $remoteVersion) : ?>
                    <strong class="ds82-3dps-version-number"><?php echo esc_html($remoteVersion); ?></strong>
                <?php else : ?>
                    <strong class="ds82-3dps-version-number ds82-3dps-version-unavailable">—</strong>
                    <span class="description"><?php esc_html_e('The available version could not be retrieved from the update server.', '3d-print-showcase'); ?></span>
                <?php endif; ?>
            </div>

            <div class="ds82-3dps-card ds82-3dps-version-card">
                <span class="ds82-3dps-version-label"><?php esc_html_e('Update status', '3d-print-showcase'); ?></span>
                <?php if ('current' === $versionStatus) : ?>
                    <strong class="ds82-3dps-version-status ds82-3dps-status-ok"><?php esc_html_e('Up to date', '3d-print-showcase'); ?></strong>
                <?php elseif ('update' === $versionStatus) : ?>
                    <strong class="ds82-3dps-version-status ds82-3dps-status-warning"><?php esc_html_e('New version available', '3d-print-showcase'); ?></strong>
                <?php else : ?>
                    <strong class="ds82-3dps-version-status ds82-3dps-status-muted"><?php esc_html_e('Status unavailable', '3d-print-showcase'); ?></strong>
                <?php endif; ?>
            </div>
        </div>

        <div class="ds82-3dps-card ds82-3dps-changelog-card">
            <h2><?php esc_html_e('Changelog', '3d-print-showcase'); ?></h2>
            <?php echo $this->render_changelog(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>
        </div>
        <?php
        $this->footer();
    }

    private function available_plugin_version(): ?string
    {
        $cacheKey = 'ds82_3dps_available_version';
        $cached = get_transient($cacheKey);
        if (is_string($cached) && '' !== $cached) {
            return $cached;
        }

        $response = wp_remote_get(
            'https://api.wpresstech.cz/wp-json/wp/v2/ds82-pluginy',
            [
                'timeout' => 10,
                'redirection' => 3,
                'headers' => [
                    'Accept' => 'application/json',
                ],
                'user-agent' => '3D Print Showcase/' . DS82_3DPS_VERSION . '; ' . home_url('/'),
            ]
        );

        if (is_wp_error($response) || 200 !== wp_remote_retrieve_response_code($response)) {
            return null;
        }

        $data = json_decode(wp_remote_retrieve_body($response), true);
        if (!is_array($data) || [] === $data) {
            return null;
        }

        $targetSlug = '3d-print-showcase-display-3d-models-with-realistic-filaments';
        foreach ($data as $record) {
            if (!is_array($record) || $targetSlug !== ($record['slug'] ?? '')) {
                continue;
            }

            $rawVersion = $record['acf']['np_verze_pluginu'] ?? null;
            if (!is_scalar($rawVersion)) {
                return null;
            }

            $version = $this->normalize_version((string) $rawVersion);
            if (null !== $version) {
                set_transient($cacheKey, $version, 15 * MINUTE_IN_SECONDS);
            }

            return $version;
        }

        return null;
    }

    private function normalize_version(string $value): ?string
    {
        if (preg_match('/(?<!\d)(\d+\.\d+(?:\.\d+){0,3})(?!\d)/', $value, $matches)) {
            return $matches[1];
        }

        return null;
    }

    private function render_changelog(): string
    {
        $path = DS82_3DPS_PATH . 'CHANGELOG.md';
        if (!is_readable($path)) {
            return '<p>' . esc_html__('The changelog file is not available.', '3d-print-showcase') . '</p>';
        }

        $contents = file_get_contents($path);
        if (!is_string($contents) || '' === trim($contents)) {
            return '<p>' . esc_html__('The changelog is empty.', '3d-print-showcase') . '</p>';
        }

        $html = '';
        $listOpen = false;
        foreach (preg_split('/\R/', $contents) ?: [] as $line) {
            $line = trim($line);

            if ('' === $line) {
                if ($listOpen) {
                    $html .= '</ul>';
                    $listOpen = false;
                }
                continue;
            }

            if (str_starts_with($line, '# ')) {
                if ($listOpen) {
                    $html .= '</ul>';
                    $listOpen = false;
                }
                $html .= '<h3>' . esc_html(substr($line, 2)) . '</h3>';
                continue;
            }

            if (str_starts_with($line, '## ')) {
                if ($listOpen) {
                    $html .= '</ul>';
                    $listOpen = false;
                }
                $html .= '<h4>' . esc_html(substr($line, 3)) . '</h4>';
                continue;
            }

            if (str_starts_with($line, '- ')) {
                if (!$listOpen) {
                    $html .= '<ul>';
                    $listOpen = true;
                }
                $item = esc_html(substr($line, 2));
                $item = preg_replace('/\*\*(.+?)\*\*/', '<strong>$1</strong>', $item) ?? $item;
                $html .= '<li>' . wp_kses($item, ['strong' => []]) . '</li>';
                continue;
            }

            if ($listOpen) {
                $html .= '</ul>';
                $listOpen = false;
            }
            $html .= '<p>' . esc_html($line) . '</p>';
        }

        if ($listOpen) {
            $html .= '</ul>';
        }

        return '<div class="ds82-3dps-changelog">' . $html . '</div>';
    }

    public function settings_page(): void
    {
        $this->guard_page();
        $settings = Settings::all();
        $this->header(__('Settings', '3d-print-showcase'));
        ?>
        <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
            <input type="hidden" name="action" value="ds82_3dps_save_settings">
            <input type="hidden" name="redirect_page" value="ds82-3dps-settings">
            <?php wp_nonce_field('ds82_3dps_save_settings'); ?>
            <div class="ds82-3dps-admin-grid">
                <div>
                    <div class="ds82-3dps-card">
                        <h2><?php esc_html_e('Viewer', '3d-print-showcase'); ?></h2>
                        <table class="form-table" role="presentation">
                            <tr><th><label for="ds82-height"><?php esc_html_e('Viewer height', '3d-print-showcase'); ?></label></th><td><input id="ds82-height" type="number" min="240" max="1200" step="10" name="settings[height]" value="<?php echo esc_attr((string) $settings['height']); ?>"> px</td></tr>
                            <tr><th><label for="ds82-bg"><?php esc_html_e('Background color', '3d-print-showcase'); ?></label></th><td><input id="ds82-bg" type="color" name="settings[background_color]" value="<?php echo esc_attr((string) $settings['background_color']); ?>"></td></tr>
                            <tr><th><label for="ds82-model-color"><?php esc_html_e('Default model color', '3d-print-showcase'); ?></label></th><td><input id="ds82-model-color" type="color" name="settings[default_model_color]" value="<?php echo esc_attr((string) $settings['default_model_color']); ?>"></td></tr>
                            <tr><th><label for="ds82-preview-model-url"><?php esc_html_e('Live preview model URL', '3d-print-showcase'); ?></label></th><td><input id="ds82-preview-model-url" type="url" class="large-text" name="settings[preview_model_url]" value="<?php echo esc_attr((string) $settings['preview_model_url']); ?>" placeholder="https://example.com/model.stl"><p class="description"><?php esc_html_e('STL, 3MF, GLB or GLTF model used in the live material preview. If left empty, a lightweight preview model generated by the plugin is used.', '3d-print-showcase'); ?></p></td></tr>
                            <tr><th><?php esc_html_e('Auto rotation', '3d-print-showcase'); ?></th><td><label><input type="checkbox" name="settings[auto_rotate]" value="yes" <?php checked($settings['auto_rotate'], 'yes'); ?>> <?php esc_html_e('Rotate models automatically by default.', '3d-print-showcase'); ?></label></td></tr>
                            <tr><th><?php esc_html_e('Live preview auto rotation', '3d-print-showcase'); ?></th><td><label><input type="checkbox" name="settings[preview_auto_rotate]" value="yes" <?php checked($settings['preview_auto_rotate'], 'yes'); ?>> <?php esc_html_e('Rotate the model automatically in the live material preview.', '3d-print-showcase'); ?></label><p class="description"><?php esc_html_e('This setting affects only the preview in the appearance editor. The public viewer uses the separate Auto rotation setting above.', '3d-print-showcase'); ?></p></td></tr>
                            <tr><th><?php esc_html_e('Fullscreen', '3d-print-showcase'); ?></th><td><label><input type="checkbox" name="settings[fullscreen]" value="yes" <?php checked($settings['fullscreen'], 'yes'); ?>> <?php esc_html_e('Show the fullscreen control.', '3d-print-showcase'); ?></label></td></tr>
                            <tr><th><?php esc_html_e('Lazy loading', '3d-print-showcase'); ?></th><td><label><input type="checkbox" name="settings[lazy_loading]" value="yes" <?php checked($settings['lazy_loading'], 'yes'); ?>> <?php esc_html_e('Load the viewer shortly before it enters the viewport.', '3d-print-showcase'); ?></label></td></tr>
                            <tr><th><label for="ds82-ratio"><?php esc_html_e('Maximum pixel ratio', '3d-print-showcase'); ?></label></th><td><input id="ds82-ratio" type="number" min="1" max="3" step="0.1" name="settings[max_pixel_ratio]" value="<?php echo esc_attr((string) $settings['max_pixel_ratio']); ?>"></td></tr>
                            <tr><th><label for="ds82-fps"><?php esc_html_e('FPS limit', '3d-print-showcase'); ?></label></th><td><input id="ds82-fps" type="number" min="15" max="60" step="1" name="settings[fps_limit]" value="<?php echo esc_attr((string) $settings['fps_limit']); ?>"></td></tr>
                        </table>
                    </div>
                    <div class="ds82-3dps-card">
                        <h2><?php esc_html_e('Disclaimer', '3d-print-showcase'); ?></h2>
                        <p><label><input type="checkbox" name="settings[disclaimer_enabled]" value="yes" <?php checked($settings['disclaimer_enabled'], 'yes'); ?>> <?php esc_html_e('Show the material preview disclaimer.', '3d-print-showcase'); ?></label></p>
                        <textarea class="large-text" rows="4" name="settings[disclaimer_text]"><?php echo esc_textarea((string) $settings['disclaimer_text']); ?></textarea>
                    </div>
                </div>
                <div>
                    <div class="ds82-3dps-card">
                        <h2><?php esc_html_e('System', '3d-print-showcase'); ?></h2>
                        <p><label><input type="checkbox" name="settings[debug]" value="yes" <?php checked($settings['debug'], 'yes'); ?>> <?php esc_html_e('Enable debug logging.', '3d-print-showcase'); ?></label></p>
                        <p><label><input type="checkbox" name="settings[delete_data_on_uninstall]" value="yes" <?php checked($settings['delete_data_on_uninstall'], 'yes'); ?>> <?php esc_html_e('Delete plugin data when the base plugin is uninstalled.', '3d-print-showcase'); ?></label></p>
                    </div>
                </div>
            </div>
            <?php submit_button(__('Save settings', '3d-print-showcase')); ?>
        </form>
        <?php
        $this->footer();
    }


    public function user_viewer_page(): void
    {
        $this->guard_page();
        $settings = Settings::all();
        $materials = $this->materials->all();
        $selected = array_map('strval', (array) ($settings['user_viewer_materials'] ?? []));
        $this->header(__('User 3D Viewer', '3d-print-showcase'));
        ?>
        <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
            <input type="hidden" name="action" value="ds82_3dps_save_settings">
            <input type="hidden" name="redirect_page" value="ds82-3dps-user-viewer">
            <?php wp_nonce_field('ds82_3dps_save_settings'); ?>
            <div class="ds82-3dps-card">
                <h2><?php esc_html_e('User 3D Viewer', '3d-print-showcase'); ?></h2>
                <p><?php esc_html_e('Visitors can load their own 3D model directly in the browser and preview it with the materials you allow. The model is not uploaded to or stored on your server.', '3d-print-showcase'); ?></p>
                <table class="form-table" role="presentation">
                    <tr><th><?php esc_html_e('Enable user viewer', '3d-print-showcase'); ?></th><td><label><input type="checkbox" name="settings[user_viewer_enabled]" value="yes" <?php checked($settings['user_viewer_enabled'], 'yes'); ?>> <?php esc_html_e('Allow the user viewer shortcode.', '3d-print-showcase'); ?></label></td></tr>
                    <tr><th><?php esc_html_e('Shortcode', '3d-print-showcase'); ?></th><td><code>[ds82_3d_user_viewer]</code><p class="description"><?php esc_html_e('Insert this shortcode on any page where visitors should be able to preview their own model.', '3d-print-showcase'); ?></p></td></tr>
                    <tr><th><?php esc_html_e('Maximum file size', '3d-print-showcase'); ?></th><td><input type="number" min="1" max="200" name="settings[user_viewer_max_size]" value="<?php echo esc_attr((string) $settings['user_viewer_max_size']); ?>"> MB</td></tr>
                    <tr><th><?php esc_html_e('Allowed formats', '3d-print-showcase'); ?></th><td><?php foreach (['stl' => 'STL', 'glb' => 'GLB', '3mf' => '3MF'] as $key => $label) : ?><label style="margin-right:18px"><input type="checkbox" name="settings[user_viewer_formats][]" value="<?php echo esc_attr($key); ?>" <?php checked(in_array($key, (array) $settings['user_viewer_formats'], true)); ?>> <?php echo esc_html($label); ?></label><?php endforeach; ?><p class="description"><?php esc_html_e('GLTF is not included because it can depend on separate BIN and texture files. Use GLB instead.', '3d-print-showcase'); ?></p></td></tr>
                    <tr><th><?php esc_html_e('Available materials and colors', '3d-print-showcase'); ?></th><td>
                        <label><input type="radio" name="settings[user_viewer_material_mode]" value="all" <?php checked($settings['user_viewer_material_mode'], 'all'); ?>> <?php esc_html_e('All materials and colors', '3d-print-showcase'); ?></label><br>
                        <label><input type="radio" name="settings[user_viewer_material_mode]" value="include" <?php checked($settings['user_viewer_material_mode'], 'include'); ?>> <?php esc_html_e('Only selected materials and colors', '3d-print-showcase'); ?></label><br>
                        <label><input type="radio" name="settings[user_viewer_material_mode]" value="exclude" <?php checked($settings['user_viewer_material_mode'], 'exclude'); ?>> <?php esc_html_e('All except selected materials and colors', '3d-print-showcase'); ?></label>
                        <p><select name="settings[user_viewer_materials][]" multiple size="10" style="width:min(520px,100%)"><?php foreach ($materials as $material) : if (!$material instanceof Material) continue; $id=$material->identifier(); ?><option value="<?php echo esc_attr($id); ?>" <?php selected(in_array($id, $selected, true)); ?>><?php echo esc_html($material->label()); ?></option><?php endforeach; ?></select></p>
                        <p class="description"><?php esc_html_e('Use Ctrl or Cmd to select multiple items. In exclusion mode, select only the colors you want to hide.', '3d-print-showcase'); ?></p>
                    </td></tr>
                </table>
            </div>
            <?php submit_button(__('Save settings', '3d-print-showcase')); ?>
        </form>
        <?php
        $this->footer();
    }


    public function shortcode_builder_page(): void
    {
        $this->guard_page();
        $this->header(__('Shortcode Builder', '3d-print-showcase'));
        ?>
        <div class="ds82-3dps-card ds82-3dps-coming-soon-card">
            <span class="ds82-3dps-coming-soon-badge"><?php esc_html_e('Coming soon', '3d-print-showcase'); ?></span>
            <h2><?php esc_html_e('Visual shortcode builder', '3d-print-showcase'); ?></h2>
            <p><?php esc_html_e('We are preparing a visual shortcode builder that will let you configure the viewer and copy a ready-to-use shortcode without writing parameters manually.', '3d-print-showcase'); ?></p>

            <div class="ds82-3dps-shortcode-builder-preview" aria-disabled="true">
                <table class="form-table" role="presentation">
                    <tr>
                        <th><label for="ds82-shortcode-model"><?php esc_html_e('3D model', '3d-print-showcase'); ?></label></th>
                        <td><input id="ds82-shortcode-model" type="text" class="regular-text" value="" placeholder="model.stl" disabled></td>
                    </tr>
                    <tr>
                        <th><label for="ds82-shortcode-height"><?php esc_html_e('Viewer height', '3d-print-showcase'); ?></label></th>
                        <td><input id="ds82-shortcode-height" type="number" value="600" disabled> px</td>
                    </tr>
                    <tr>
                        <th><label for="ds82-shortcode-material"><?php esc_html_e('Material', '3d-print-showcase'); ?></label></th>
                        <td><select id="ds82-shortcode-material" disabled><option><?php esc_html_e('Select a material', '3d-print-showcase'); ?></option></select></td>
                    </tr>
                    <tr>
                        <th><?php esc_html_e('Color availability', '3d-print-showcase'); ?></th>
                        <td>
                            <fieldset class="ds82-3dps-color-availability-preview" disabled>
                                <label>
                                    <input type="radio" name="ds82-shortcode-color-mode" checked disabled>
                                    <strong><?php esc_html_e('All colors', '3d-print-showcase'); ?></strong>
                                </label>
                                <p class="description"><?php esc_html_e('Every color available in the system will be shown.', '3d-print-showcase'); ?></p>

                                <label>
                                    <input type="radio" name="ds82-shortcode-color-mode" disabled>
                                    <strong><?php esc_html_e('Only selected colors', '3d-print-showcase'); ?></strong>
                                </label>
                                <p class="description"><?php esc_html_e('Only the colors selected below will be available.', '3d-print-showcase'); ?></p>
                                <select multiple size="4" disabled aria-label="<?php esc_attr_e('Select allowed colors', '3d-print-showcase'); ?>">
                                    <option><?php esc_html_e('Black', '3d-print-showcase'); ?></option>
                                    <option><?php esc_html_e('White', '3d-print-showcase'); ?></option>
                                    <option><?php esc_html_e('Red', '3d-print-showcase'); ?></option>
                                    <option><?php esc_html_e('Blue', '3d-print-showcase'); ?></option>
                                </select>

                                <label>
                                    <input type="radio" name="ds82-shortcode-color-mode" disabled>
                                    <strong><?php esc_html_e('All except selected colors', '3d-print-showcase'); ?></strong>
                                </label>
                                <p class="description"><?php esc_html_e('All system colors will be available except the colors selected below.', '3d-print-showcase'); ?></p>
                                <select multiple size="4" disabled aria-label="<?php esc_attr_e('Select excluded colors', '3d-print-showcase'); ?>">
                                    <option><?php esc_html_e('Silk Gold', '3d-print-showcase'); ?></option>
                                    <option><?php esc_html_e('Rainbow', '3d-print-showcase'); ?></option>
                                    <option><?php esc_html_e('Wood', '3d-print-showcase'); ?></option>
                                    <option><?php esc_html_e('Carbon', '3d-print-showcase'); ?></option>
                                </select>
                                <p class="description ds82-3dps-color-mode-note"><?php esc_html_e('This mode is useful when you have many colors and only need to hide a few of them.', '3d-print-showcase'); ?></p>
                            </fieldset>
                        </td>
                    </tr>
                </table>
                <p><button type="button" class="button button-primary" disabled><?php esc_html_e('Generate shortcode', '3d-print-showcase'); ?></button></p>
            </div>
        </div>
        <?php
        $this->footer();
    }

    public function documentation_page(): void
    {
        $this->guard_page();
        $this->header(__('Documentation', '3d-print-showcase'));
        ?>
        <div class="ds82-3dps-card">
            <h2><?php esc_html_e('Shortcodes', '3d-print-showcase'); ?></h2>
            <p><?php esc_html_e('Use the viewer shortcode in posts, pages, widgets, or page builders that support WordPress shortcodes.', '3d-print-showcase'); ?></p>
            <h3><?php esc_html_e('Model from the Media Library', '3d-print-showcase'); ?></h3>
            <p><code>[ds82_3d_print_showcase model_id="123"]</code></p>
            <p><?php esc_html_e('Replace 123 with the attachment ID of an STL, 3MF, GLB, or GLTF file.', '3d-print-showcase'); ?></p>
            <h3><?php esc_html_e('Model from a URL', '3d-print-showcase'); ?></h3>
            <p><code>[ds82_3d_print_showcase model_url="https://example.com/model.stl"]</code></p>
            <h3><?php esc_html_e('Complete example', '3d-print-showcase'); ?></h3>
            <p><code>[ds82_3d_print_showcase model_id="123" height="650" material="internal:az1" fallback_url="https://example.com/fallback.jpg" auto_rotate="true"]</code></p>
        </div>
        <div class="ds82-3dps-card">
            <h2><?php esc_html_e('Available parameters', '3d-print-showcase'); ?></h2>
            <table class="widefat striped"><thead><tr><th><?php esc_html_e('Parameter', '3d-print-showcase'); ?></th><th><?php esc_html_e('Description', '3d-print-showcase'); ?></th><th><?php esc_html_e('Example', '3d-print-showcase'); ?></th></tr></thead><tbody>
                <tr><td><code>model_id</code></td><td><?php esc_html_e('Attachment ID of the 3D model in the Media Library.', '3d-print-showcase'); ?></td><td><code>model_id="123"</code></td></tr>
                <tr><td><code>model_url</code></td><td><?php esc_html_e('Direct URL of the 3D model. Use either model_id or model_url.', '3d-print-showcase'); ?></td><td><code>model_url="https://example.com/model.3mf"</code></td></tr>
                <tr><td><code>height</code></td><td><?php esc_html_e('Viewer height in pixels. Allowed range: 240–1200.', '3d-print-showcase'); ?></td><td><code>height="600"</code></td></tr>
                <tr><td><code>material</code></td><td><?php esc_html_e('Identifier of the appearance or material used for the initial preview.', '3d-print-showcase'); ?></td><td><code>material="internal:az1"</code></td></tr>
                <tr><td><code>fallback_url</code></td><td><?php esc_html_e('Fallback image displayed when the 3D model cannot be loaded.', '3d-print-showcase'); ?></td><td><code>fallback_url="https://example.com/model.jpg"</code></td></tr>
                <tr><td><code>auto_rotate</code></td><td><?php esc_html_e('Overrides automatic rotation for this viewer. Accepted true values: 1, yes, true.', '3d-print-showcase'); ?></td><td><code>auto_rotate="true"</code></td></tr>
            </tbody></table>
            <p><strong><?php esc_html_e('Note:', '3d-print-showcase'); ?></strong> <?php esc_html_e('Background color, fullscreen control, lazy loading, pixel ratio, and FPS limit use the global viewer settings.', '3d-print-showcase'); ?></p>
        </div>
        <div class="ds82-3dps-card">
            <h2><?php esc_html_e('Supported formats', '3d-print-showcase'); ?></h2>
            <p><code>STL</code>, <code>3MF</code>, <code>GLB</code>, <code>GLTF</code></p>
            <p><?php esc_html_e('The shortcode requires either model_id or model_url. If both are supplied, model_url takes precedence.', '3d-print-showcase'); ?></p>
        </div>
        <?php
        $this->footer();
    }

    public function integrations_page(): void
    {
        $this->guard_page();
        $this->header(__('Addons', '3d-print-showcase'));
        $availableAddons = AddonCatalog::items();
        ?>
        <div class="ds82-3dps-card ds82-3dps-addons-page">
            <div class="ds82-3dps-addons-heading">
                <div>
                    <h2><?php esc_html_e('Available addons', '3d-print-showcase'); ?></h2>
                    <p class="description"><?php esc_html_e('Rozšiřte 3D Print Showcase o další funkce – konfiguraci produktů, správu materiálů, sklad filamentů, tiskárny a další specializované nástroje. Dostupné dodatky můžete instalovat, aktivovat a aktualizovat přímo zde.', '3d-print-showcase'); ?></p>
                </div>
                <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
                    <input type="hidden" name="action" value="ds82_3dps_refresh_addons">
                    <?php wp_nonce_field('ds82_3dps_refresh_addons'); ?>
                    <button class="button button-secondary" type="submit"><?php esc_html_e('Obnovit katalog', '3d-print-showcase'); ?></button>
                </form>
            </div>
            <?php if (!$availableAddons) : ?>
                <div class="notice notice-warning inline"><p><?php esc_html_e('The remote addon catalog is currently unavailable or contains no compatible records.', '3d-print-showcase'); ?></p></div>
            <?php else : ?>
            <div class="ds82-3dps-addons-grid">
                <?php foreach ($availableAddons as $addon) :
                    $installed = AddonCatalog::installed($addon);
                    $canDownload = !empty($addon['downloadable']) && !empty($addon['download']);
                    $hasUpdate = $installed['file'] && $canDownload && !empty($addon['version']) && version_compare((string)$addon['version'], $installed['version'], '>');
                    ?>
                    <article class="ds82-3dps-addon-card">
                        <?php if (!empty($addon['banner'])) : ?><img class="ds82-3dps-addon-card__banner" src="<?php echo esc_url($addon['banner']); ?>" alt=""><?php endif; ?>
                        <div class="ds82-3dps-addon-card__header">
                            <div class="ds82-3dps-addon-card__title">
                                <?php if (!empty($addon['icon'])) : ?><img class="ds82-3dps-addon-card__icon" src="<?php echo esc_url($addon['icon']); ?>" alt=""><?php endif; ?>
                                <h3><?php echo esc_html($addon['name']); ?></h3>
                            </div>
                        </div>
                        <p><?php echo esc_html($addon['description']); ?></p>
                        <div class="ds82-3dps-addon-card__footer">
                            <div class="ds82-3dps-addon-versions">
                                <?php if ($installed['file']) : ?>
                                    <span class="ds82-3dps-addon-version-row">
                                        <span class="ds82-3dps-addon-version-label"><?php esc_html_e('Nainstalováno', '3d-print-showcase'); ?></span>
                                        <strong><?php echo esc_html($installed['version']); ?></strong>
                                    </span>
                                    <?php if (!empty($addon['version'])) : ?>
                                        <span class="ds82-3dps-addon-version-row">
                                            <span class="ds82-3dps-addon-version-label"><?php esc_html_e('Dostupná verze', '3d-print-showcase'); ?></span>
                                            <strong><?php echo esc_html($addon['version']); ?></strong>
                                        </span>
                                    <?php endif; ?>
                                <?php endif; ?>
                            </div>
                            <?php if (!$installed['file']) : ?>
                                <?php if ($canDownload) : ?>
                                    <?php $this->addon_action_button($addon['slug'], 'install', __('Install', '3d-print-showcase'), 'button-primary'); ?>
                                <?php else : ?>
                                    <button class="button" type="button" disabled><?php esc_html_e('Coming soon', '3d-print-showcase'); ?></button>
                                <?php endif; ?>
                            <?php elseif (!$installed['active']) : ?>
                                <?php $this->addon_action_button($addon['slug'], 'activate', __('Activate', '3d-print-showcase'), 'button-primary'); ?>
                            <?php elseif ($hasUpdate) : ?>
                                <?php $this->addon_action_button($addon['slug'], 'update', __('Update', '3d-print-showcase'), 'button-primary'); ?>
                            <?php elseif (!$canDownload && !empty($addon['version']) && version_compare((string)$addon['version'], $installed['version'], '>')) : ?>
                                <button class="button" type="button" disabled><?php esc_html_e('Coming soon', '3d-print-showcase'); ?></button>
                            <?php else : ?>
                                <button class="button" type="button" disabled><?php esc_html_e('Up to date', '3d-print-showcase'); ?></button>
                            <?php endif; ?>
                        </div>
                    </article>
                <?php endforeach; ?>
            </div>
            <?php endif; ?>
        </div>
        <?php
        $this->footer();
    }

    private function addon_action_button(string $slug, string $operation, string $label, string $class = ''): void
    {
        $url = wp_nonce_url(admin_url('admin-post.php?action=ds82_3dps_addon_action&operation=' . rawurlencode($operation) . '&addon=' . rawurlencode($slug)), 'ds82_3dps_addon_action_' . $operation . '_' . $slug);
        echo '<a class="button ' . esc_attr($class) . '" href="' . esc_url($url) . '">' . esc_html($label) . '</a>';
    }

    public function refresh_addons(): void
    {
        $this->guard_action('ds82_3dps_refresh_addons');
        check_admin_referer('ds82_3dps_refresh_addons');
        AddonCatalog::clear_cache();
        AddonCatalog::items(true);
        delete_site_transient('update_plugins');
        $this->redirect('ds82-3dps-integrations', 'addons-refreshed');
    }

    public function addon_action(): void
    {
        $this->guard_action('ds82_3dps_addon_action');
        $operation = sanitize_key((string) filter_input(INPUT_GET, 'operation', FILTER_UNSAFE_RAW));
        $slug = sanitize_key((string) filter_input(INPUT_GET, 'addon', FILTER_UNSAFE_RAW));
        check_admin_referer('ds82_3dps_addon_action_' . $operation . '_' . $slug);
        $addon = AddonCatalog::find($slug);
        if (!$addon) wp_die(esc_html__('Addon was not found in the remote catalog.', '3d-print-showcase'));
        $installed = AddonCatalog::installed($addon);

        if ('activate' === $operation) {
            if (!$installed['file']) wp_die(esc_html__('The addon is not installed.', '3d-print-showcase'));
            $result = activate_plugin($installed['file']);
            if (is_wp_error($result)) wp_die(esc_html($result->get_error_message()));
            $this->redirect('ds82-3dps-integrations', 'addon-activated');
        }

        if (!in_array($operation, ['install','update'], true)) wp_die(esc_html__('Unsupported addon action.', '3d-print-showcase'));
        if (empty($addon['downloadable']) || empty($addon['download'])) wp_die(esc_html__('This addon is not currently available for download.', '3d-print-showcase'));
        if ('update' === $operation && !$installed['file']) wp_die(esc_html__('The addon is not installed.', '3d-print-showcase'));

        require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
        require_once ABSPATH . 'wp-admin/includes/file.php';
        require_once ABSPATH . 'wp-admin/includes/plugin-install.php';
        $skin = new \Automatic_Upgrader_Skin();
        $upgrader = new \Plugin_Upgrader($skin);
        $result = $upgrader->install((string)$addon['download'], ['overwrite_package' => 'update' === $operation]);
        if (is_wp_error($result)) wp_die(esc_html($result->get_error_message()));
        if (!$result) wp_die(esc_html__('WordPress could not install the addon package.', '3d-print-showcase'));
        AddonCatalog::clear_cache();
        delete_site_transient('update_plugins');
        $this->redirect('ds82-3dps-integrations', 'update' === $operation ? 'addon-updated' : 'addon-installed');
    }

    /**
     * @param array<string,array<string,string>> $installedPlugins
     * @param array<int,string> $exactFiles
     * @param array<int,string> $nameFragments
     */
    private function find_installed_plugin(array $installedPlugins, array $exactFiles, array $nameFragments): string
    {
        foreach ($exactFiles as $pluginFile) {
            if (isset($installedPlugins[$pluginFile])) {
                return $pluginFile;
            }
        }

        foreach ($installedPlugins as $pluginFile => $data) {
            $pluginName = (string) ($data['Name'] ?? '');
            foreach ($nameFragments as $fragment) {
                if ('' !== $fragment && false !== stripos($pluginName, $fragment)) {
                    return (string) $pluginFile;
                }
            }
        }

        return '';
    }

    public function materials_page(): void
    {
        $this->guard_page();
        $provider = $this->materials->provider();
        $isInternal = $provider instanceof InternalMaterialProvider;
        $materials = $this->materials->cached();
        $editSlug = sanitize_key((string) filter_input(INPUT_GET, 'edit_material', FILTER_UNSAFE_RAW));
        $editing = $isInternal && $editSlug !== '' ? $provider->raw($editSlug) : [];
        $editExternalRaw = filter_input(INPUT_GET, 'edit_external', FILTER_UNSAFE_RAW);
        $editExternal = is_string($editExternalRaw) ? rawurldecode($editExternalRaw) : '';
        $editingExternalMaterial = (!$isInternal && '' !== $editExternal) ? $provider->get_material($editExternal) : null;
        $editingExternal = $editingExternalMaterial instanceof Material ? $this->overrides->editing_values($editingExternalMaterial) : [];
        $settings = Settings::all();
        $this->header(__('Materials', '3d-print-showcase'));
        $sources = $this->providers->definitions();
        $activeSourceId = $this->materials->provider()->get_id();
        ?>
        <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
            <input type="hidden" name="action" value="ds82_3dps_save_settings">
            <input type="hidden" name="redirect_page" value="ds82-3dps-materials">
            <?php wp_nonce_field('ds82_3dps_save_settings'); ?>
            <div class="ds82-3dps-card">
                <h2><?php esc_html_e('Appearance settings', '3d-print-showcase'); ?></h2>
                <div class="ds82-3dps-settings-columns">
                    <section>
                        <h3><?php esc_html_e('Appearance source', '3d-print-showcase'); ?></h3>
                        <?php if (!$sources) : ?><p><?php esc_html_e('No material source add-on is installed.', '3d-print-showcase'); ?></p><?php endif; ?>
                        <?php foreach ($sources as $id => $definition) : ?>
                            <p><label><input type="radio" name="settings[material_source]" value="<?php echo esc_attr($id); ?>" <?php checked($activeSourceId, $id); ?>> <strong><?php echo esc_html($definition['label']); ?></strong></label><br><span class="description"><?php echo esc_html($definition['description']); ?></span><?php if ($definition['settings_url']) : ?> <a href="<?php echo esc_url($definition['settings_url']); ?>"><?php esc_html_e('Configure', '3d-print-showcase'); ?></a><?php endif; ?></p>
                        <?php endforeach; ?>
                        <div class="ds82-3dps-custom-rest-url" style="margin-top:16px;">
                            <label for="ds82-custom-rest-url"><strong><?php esc_html_e('Custom REST / JSON URL', '3d-print-showcase'); ?></strong></label><br>
                            <input type="url" id="ds82-custom-rest-url" class="large-text" name="settings[custom_rest_url]" value="<?php echo esc_attr((string) ($settings['custom_rest_url'] ?? '')); ?>" placeholder="https://example.com/wp-json/wp/v2/filament">
                            <p class="description"><?php esc_html_e('Optional. Use any endpoint that returns the compatible filament JSON structure. The built-in Denis3D source above always remains available separately.', '3d-print-showcase'); ?></p>
                        </div>
                    </section>
                    <section>
                        <h3><?php esc_html_e('Model appearances', '3d-print-showcase'); ?></h3>
                        <p><label><input type="checkbox" name="settings[appearance_switching]" value="yes" <?php checked($settings['appearance_switching'], 'yes'); ?>> <strong><?php esc_html_e('Allow appearance switching', '3d-print-showcase'); ?></strong></label><br><span class="description"><?php esc_html_e('When enabled, visitors can switch between available appearances. When disabled, only the default appearance is used.', '3d-print-showcase'); ?></span></p>
                        <p><label><input type="checkbox" name="settings[remember_appearance]" value="yes" <?php checked($settings['remember_appearance'], 'yes'); ?>> <?php esc_html_e('Remember the last selected appearance', '3d-print-showcase'); ?></label><br><span class="description"><?php esc_html_e('Stores the last selected appearance in the visitor browser and restores it on the next visit.', '3d-print-showcase'); ?></span></p>
                        <p><label for="ds82-appearance-display"><strong><?php esc_html_e('Appearance selector display', '3d-print-showcase'); ?></strong></label><br><select id="ds82-appearance-display" name="settings[appearance_display]"><option value="labels" <?php selected($settings['appearance_display'], 'labels'); ?>><?php esc_html_e('Color swatches with names', '3d-print-showcase'); ?></option><option value="swatches" <?php selected($settings['appearance_display'], 'swatches'); ?>><?php esc_html_e('Color swatches only', '3d-print-showcase'); ?></option></select></p>
                        <p><label><input type="checkbox" name="settings[appearance_tooltips]" value="yes" <?php checked($settings['appearance_tooltips'], 'yes'); ?>> <?php esc_html_e('Show appearance name in a tooltip', '3d-print-showcase'); ?></label></p>
                    </section>
                    <section>
                        <h3><?php esc_html_e('Appearance selection source', '3d-print-showcase'); ?></h3>
                        <p class="description"><?php esc_html_e('Choose how visitors change the model appearance.', '3d-print-showcase'); ?></p>
                        <p><label><input type="radio" name="settings[appearance_source]" value="builtin" <?php checked($settings['appearance_source'], 'builtin'); ?>> <strong><?php esc_html_e('Built-in selector', '3d-print-showcase'); ?></strong></label><br><span class="description"><?php esc_html_e('Visitors choose an appearance directly below the 3D viewer.', '3d-print-showcase'); ?></span></p>
                        <p><label><input type="radio" name="settings[appearance_source]" value="variations" <?php checked($settings['appearance_source'], 'variations'); ?> <?php disabled(!defined('DS82_3DPS_WOO_VERSION')); ?>> <strong><?php esc_html_e('WooCommerce variations', '3d-print-showcase'); ?></strong></label><br><span class="description"><?php esc_html_e('The model appearance changes from mapped WooCommerce variations.', '3d-print-showcase'); ?></span></p>
                        <p><label><input type="radio" name="settings[appearance_source]" value="combined" <?php checked($settings['appearance_source'], 'combined'); ?> <?php disabled(!defined('DS82_3DPS_WOO_VERSION')); ?>> <strong><?php esc_html_e('Combined mode', '3d-print-showcase'); ?></strong></label><br><span class="description"><?php esc_html_e('The built-in selector and mapped WooCommerce variations work together.', '3d-print-showcase'); ?></span></p>
                        <?php if (!defined('DS82_3DPS_WOO_VERSION')) : ?><p><em><?php esc_html_e('WooCommerce variation modes require the WooCommerce Integration add-on.', '3d-print-showcase'); ?></em></p><?php endif; ?>
                        <input type="hidden" name="settings[selection_mode]" value="builtin">
                    </section>
                </div>
                <?php submit_button(__('Save appearance settings', '3d-print-showcase'), 'primary', 'submit', false); ?>
            </div>
        </form>
        <?php if ($isInternal) : ?>
            <div class="ds82-3dps-admin-grid">
                <div>
                    <div class="ds82-3dps-card">
                        <h2><?php echo esc_html($editing ? __('Edit material', '3d-print-showcase') : __('Add material', '3d-print-showcase')); ?></h2>
                        <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
                            <input type="hidden" name="action" value="ds82_3dps_save_internal_material">
                            <input type="hidden" name="material[original_slug]" value="<?php echo esc_attr($editSlug); ?>">
                            <?php wp_nonce_field('ds82_3dps_save_internal_material'); ?>
                            <div class="ds82-3dps-editor-tabs" role="tablist">
                                <button type="button" class="button is-active" data-tab="general"><?php esc_html_e('General', '3d-print-showcase'); ?></button>
                                <button type="button" class="button" data-tab="surface"><?php esc_html_e('Surface', '3d-print-showcase'); ?></button>
                                <button type="button" class="button" data-tab="lighting"><?php esc_html_e('Lighting', '3d-print-showcase'); ?></button>
                                <button type="button" class="button" data-tab="textures"><?php esc_html_e('Textures', '3d-print-showcase'); ?></button>
                            </div>
                            <table id="ds82-material-editor-table" class="form-table" role="presentation">
                                <tr data-editor-tab="general"><th><label for="ds82-material-id"><?php esc_html_e('Filament ID', '3d-print-showcase'); ?></label></th><td><input required id="ds82-material-id" class="regular-text" name="material[slug]" value="<?php echo esc_attr((string) ($editing['slug'] ?? '')); ?>" placeholder="AZ16"><p class="description"><?php esc_html_e('Unique ID used for pairing and selection.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="general"><th><label for="ds82-material-name"><?php esc_html_e('Color name', '3d-print-showcase'); ?></label></th><td><input required id="ds82-material-name" class="regular-text" name="material[name]" value="<?php echo esc_attr((string) ($editing['name'] ?? '')); ?>"></td></tr>
                                <tr data-editor-tab="general"><th><label for="ds82-color-mode"><?php esc_html_e('Number of colors', '3d-print-showcase'); ?></label></th><td><select id="ds82-color-mode" name="material[color_mode]"><?php foreach (['single' => __('One color', '3d-print-showcase'), 'dual' => __('Two colors', '3d-print-showcase'), 'triple' => __('Three colors', '3d-print-showcase'), 'quad' => __('Four colors', '3d-print-showcase')] as $value => $label) : ?><option value="<?php echo esc_attr($value); ?>" <?php selected((string) ($editing['color_mode'] ?? 'single'), $value); ?>><?php echo esc_html($label); ?></option><?php endforeach; ?></select><p class="description"><?php esc_html_e('The plugin saves and renders exactly this number of colors.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="general"><th><label for="ds82-color-mode-type"><?php esc_html_e('Color layout', '3d-print-showcase'); ?></label></th><td><select id="ds82-color-mode-type" name="material[color_mode_type]"><?php foreach (['standard' => __('Standard', '3d-print-showcase'), 'gradient' => __('Gradient', '3d-print-showcase'), 'rainbow' => __('Rainbow', '3d-print-showcase'), 'layered' => __('Layered', '3d-print-showcase')] as $value => $label) : ?><option value="<?php echo esc_attr($value); ?>" <?php selected((string) ($editing['color_mode_type'] ?? 'standard'), $value); ?>><?php echo esc_html($label); ?></option><?php endforeach; ?></select><p id="ds82-standard-layout-note" class="description"<?php echo ((string) ($editing['color_mode_type'] ?? 'standard') === 'standard') ? '' : ' hidden'; ?>><?php esc_html_e('Standard layout allows only one color. To create a multicolor appearance, change the color layout.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="general" class="ds82-3dps-flow-row" <?php echo in_array((string) ($editing['color_mode_type'] ?? 'standard'), ['gradient', 'rainbow'], true) ? '' : 'hidden'; ?>><th><label for="ds82-color-direction"><?php esc_html_e('Color direction', '3d-print-showcase'); ?></label></th><td><select id="ds82-color-direction" name="material[color_direction]"><?php foreach (['left_right' => __('Left to right', '3d-print-showcase'), 'right_left' => __('Right to left', '3d-print-showcase'), 'front_back' => __('Front to back', '3d-print-showcase'), 'back_front' => __('Back to front', '3d-print-showcase'), 'bottom_top' => __('Bottom to top', '3d-print-showcase'), 'top_bottom' => __('Top to bottom', '3d-print-showcase')] as $value => $label) : ?><option value="<?php echo esc_attr($value); ?>" <?php selected((string) ($editing['color_direction'] ?? (((string) ($editing['color_mode_type'] ?? 'standard') === 'rainbow') ? 'bottom_top' : 'left_right')), $value); ?>><?php echo esc_html($label); ?></option><?php endforeach; ?></select><p class="description"><?php esc_html_e('Color 1 starts on the first named side. The last color ends on the opposite side.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="general" class="ds82-3dps-flow-row" <?php echo in_array((string) ($editing['color_mode_type'] ?? 'standard'), ['gradient', 'rainbow'], true) ? '' : 'hidden'; ?>><th><label for="ds82-color-blend-percent"><?php esc_html_e('Transition softness', '3d-print-showcase'); ?></label></th><td><input id="ds82-color-blend-percent" type="range" min="0" max="100" step="1" name="material[color_blend_percent]" value="<?php echo esc_attr((string) ($editing['color_blend_percent'] ?? '45')); ?>"><output><?php echo esc_html(number_format((float) ($editing['color_blend_percent'] ?? 45), 0)); ?></output> %<p class="description"><?php esc_html_e('Controls how softly neighboring color areas blend into each other.', '3d-print-showcase'); ?></p></td></tr>
                                <?php for ($shareIndex = 1; $shareIndex <= 4; $shareIndex++) : ?>
                                    <tr data-editor-tab="general" class="ds82-3dps-flow-row ds82-3dps-color-share-row" data-color-index="<?php echo esc_attr((string) $shareIndex); ?>" <?php echo in_array((string) ($editing['color_mode_type'] ?? 'standard'), ['gradient', 'rainbow'], true) ? '' : 'hidden'; ?>><th><label for="ds82-color-share-<?php echo esc_attr((string) $shareIndex); ?>"><?php
                                        /* translators: %d: Color position number. */
                                        echo esc_html(sprintf(__('Color %d share', '3d-print-showcase'), $shareIndex));
                                    ?></label></th><td><input id="ds82-color-share-<?php echo esc_attr((string) $shareIndex); ?>" type="number" min="1" max="100" step="1" name="material[color_share_<?php echo esc_attr((string) $shareIndex); ?>]" value="<?php echo esc_attr((string) ($editing['color_shares'][$shareIndex - 1] ?? 25)); ?>"> %<?php if (4 === $shareIndex) : ?><p class="description"><?php esc_html_e('Shares are normalized automatically, so they do not need to add up to exactly 100%.', '3d-print-showcase'); ?></p><?php endif; ?></td></tr>
                                <?php endfor; ?>
                                <tr data-editor-tab="general" class="ds82-3dps-layered-row" <?php echo ((string) ($editing['color_mode_type'] ?? 'standard') === 'layered') ? '' : 'hidden'; ?>><th><label for="ds82-layer-band-percent"><?php esc_html_e('Colored band height', '3d-print-showcase'); ?></label></th><td><input id="ds82-layer-band-percent" type="range" min="0.25" max="50" step="0.25" name="material[layer_band_percent]" value="<?php echo esc_attr((string) ($editing['layer_band_percent'] ?? '1')); ?>"><output><?php echo esc_html(number_format((float) ($editing['layer_band_percent'] ?? 1), 2)); ?></output> %<p class="description"><?php esc_html_e('Sets the average height of one colored band relative to the total model height. Use about 1% for fine layers or 25% for four broad color bands.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="general" class="ds82-3dps-layered-row" <?php echo ((string) ($editing['color_mode_type'] ?? 'standard') === 'layered') ? '' : 'hidden'; ?>><th><label for="ds82-layer-variation-percent"><?php esc_html_e('Natural variation', '3d-print-showcase'); ?></label></th><td><input id="ds82-layer-variation-percent" type="range" min="0" max="25" step="1" name="material[layer_variation_percent]" value="<?php echo esc_attr((string) ($editing['layer_variation_percent'] ?? '10')); ?>"><output><?php echo esc_html(number_format((float) ($editing['layer_variation_percent'] ?? 10), 0)); ?></output> %<p class="description"><?php esc_html_e('Adds a small deterministic variation to band boundaries for a more natural filament appearance.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="general" class="ds82-3dps-layered-row" <?php echo ((string) ($editing['color_mode_type'] ?? 'standard') === 'layered') ? '' : 'hidden'; ?>><th><label for="ds82-layer-blend-percent"><?php esc_html_e('Edge blending', '3d-print-showcase'); ?></label></th><td><input id="ds82-layer-blend-percent" type="range" min="0" max="20" step="1" name="material[layer_blend_percent]" value="<?php echo esc_attr((string) ($editing['layer_blend_percent'] ?? '6')); ?>"><output><?php echo esc_html(number_format((float) ($editing['layer_blend_percent'] ?? 6), 0)); ?></output> %<p class="description"><?php esc_html_e('Softens only a small part of each band edge. Set to 0 for completely sharp stripes.', '3d-print-showcase'); ?></p></td></tr>
                                <?php $storedColors = array_merge([(string) ($editing['base_color'] ?? '#b7b7b7')], (array) ($editing['secondary_colors'] ?? [])); ?>
                                <tr data-editor-tab="general" class="ds82-3dps-form-section"><th colspan="2"><h3><?php esc_html_e('Model colors', '3d-print-showcase'); ?></h3></th></tr>
                                <?php for ($i = 1; $i <= 4; $i++) : ?>
                                    <?php
                                    /* translators: %d: Color position number. */
                                    $colorLabel = sprintf(__('Color %d', '3d-print-showcase'), $i);
                                    $colorFieldName = 1 === $i ? 'base_color' : 'color_' . $i;
                                    $colorValue = sanitize_hex_color((string) ($storedColors[$i - 1] ?? '#b7b7b7')) ?: '#b7b7b7';
                                    ?>
                                    <tr data-editor-tab="general" class="ds82-3dps-color-row" data-color-index="<?php echo esc_attr((string) $i); ?>">
                                        <th><label for="ds82-color-<?php echo esc_attr((string) $i); ?>"><?php echo esc_html($colorLabel); ?></label></th>
                                        <td><div class="ds82-3dps-color-control"><input id="ds82-color-<?php echo esc_attr((string) $i); ?>" type="color" name="material[<?php echo esc_attr($colorFieldName); ?>]" value="<?php echo esc_attr($colorValue); ?>"><code class="ds82-3dps-color-value"><?php echo esc_html(strtoupper($colorValue)); ?></code></div></td>
                                    </tr>
                                <?php endfor; ?>
                                <tr data-editor-tab="general" class="ds82-3dps-form-section"><th colspan="2"><h3><?php esc_html_e('Preview background', '3d-print-showcase'); ?></h3></th></tr>
                                <tr data-editor-tab="general"><th><label for="ds82-background-color"><?php esc_html_e('Viewer background color', '3d-print-showcase'); ?></label></th><td><div class="ds82-3dps-color-control"><input id="ds82-background-color" type="color" name="material[background_color]" value="<?php echo esc_attr(sanitize_hex_color((string) ($editing['background_color'] ?? '')) ?: '#f7f7f7'); ?>"><code class="ds82-3dps-color-value"><?php echo esc_html(strtoupper(sanitize_hex_color((string) ($editing['background_color'] ?? '')) ?: '#f7f7f7')); ?></code></div><p class="description"><?php esc_html_e('Used when this appearance is displayed. If no custom value is saved, the global viewer background is used.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="surface"><th><label for="ds82-appearance-type"><?php esc_html_e('Surface appearance', '3d-print-showcase'); ?></label></th><td><?php
                                    $availableSurfaceTypes = [
                                        'standard' => __('Standard', '3d-print-showcase'),
                                        'matte' => __('Matte', '3d-print-showcase'),
                                        'glossy' => __('Glossy', '3d-print-showcase'),
                                        'silk' => __('Silk', '3d-print-showcase'),
                                        'satin' => __('Satin', '3d-print-showcase'),
                                        'metallic' => __('Metallic', '3d-print-showcase'),
                                        'pearl' => __('Pearlescent', '3d-print-showcase'),
                                        'transparent' => __('Transparent', '3d-print-showcase'),
                                    ];
                                    $comingSoonSurfaceTypes = [
                                        'glitter' => __('Glitter', '3d-print-showcase'),
                                        'carbon' => __('Carbon', '3d-print-showcase'),
                                        'wood' => __('Wood', '3d-print-showcase'),
                                    ];
                                    $selectedSurfaceType = (string) ($editing['appearance_type'] ?? 'standard');
                                    if (isset($comingSoonSurfaceTypes[$selectedSurfaceType])) {
                                        $selectedSurfaceType = 'standard';
                                    }
                                    ?><select id="ds82-appearance-type" name="material[appearance_type]"><?php foreach ($availableSurfaceTypes as $value => $label) : ?><option value="<?php echo esc_attr($value); ?>" <?php selected($selectedSurfaceType, $value); ?>><?php echo esc_html($label); ?></option><?php endforeach; ?><?php foreach ($comingSoonSurfaceTypes as $value => $label) : ?><option value="<?php echo esc_attr($value); ?>" disabled><?php echo esc_html(sprintf(__('%s — Coming soon', '3d-print-showcase'), $label)); ?></option><?php endforeach; ?></select><p class="description"><?php esc_html_e('Options marked as Coming soon are disabled and will be available in a future version.', '3d-print-showcase'); ?></p></td></tr>
                                <tr data-editor-tab="textures"><th><label for="ds82-preview-image"><?php esc_html_e('Preview image URL', '3d-print-showcase'); ?></label></th><td><input id="ds82-preview-image" type="url" class="large-text" name="material[preview_image_url]" value="<?php echo esc_attr((string) ($editing['preview_image_url'] ?? '')); ?>"></td></tr>
                                <tr data-editor-tab="textures"><th><label for="ds82-texture-url"><?php esc_html_e('Texture URL', '3d-print-showcase'); ?></label></th><td><input id="ds82-texture-url" type="url" class="large-text" name="material[texture_url]" value="<?php echo esc_attr((string) ($editing['texture_url'] ?? '')); ?>"></td></tr>
                                <tr data-editor-tab="textures"><th><label for="ds82-normal-url"><?php esc_html_e('Normal map URL', '3d-print-showcase'); ?></label></th><td><input id="ds82-normal-url" type="url" class="large-text" name="material[normal_map_url]" value="<?php echo esc_attr((string) ($editing['normal_map_url'] ?? '')); ?>"></td></tr>
                                <tr data-editor-tab="surface"><th><?php esc_html_e('Advanced material settings', '3d-print-showcase'); ?></th><td><label><input id="ds82-advanced-material" type="checkbox" name="material[advanced_enabled]" value="yes" <?php checked(!empty($editing['advanced_enabled'])); ?>> <?php esc_html_e('Show and use advanced physical material controls.', '3d-print-showcase'); ?></label></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-clearcoat"><?php esc_html_e('Clearcoat', '3d-print-showcase'); ?></label></th><td><input id="ds82-clearcoat" type="range" min="0" max="1" step="0.01" name="material[clearcoat]" value="<?php echo esc_attr((string) ($editing['clearcoat'] ?? '0')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-sheen"><?php esc_html_e('Sheen', '3d-print-showcase'); ?></label></th><td><input id="ds82-sheen" type="range" min="0" max="1" step="0.01" name="material[sheen]" value="<?php echo esc_attr((string) ($editing['sheen'] ?? '0')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-iridescence"><?php esc_html_e('Iridescence', '3d-print-showcase'); ?></label></th><td><input id="ds82-iridescence" type="range" min="0" max="1" step="0.01" name="material[iridescence]" value="<?php echo esc_attr((string) ($editing['iridescence'] ?? '0')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-transmission"><?php esc_html_e('Transmission', '3d-print-showcase'); ?></label></th><td><input id="ds82-transmission" type="range" min="0" max="1" step="0.01" name="material[transmission]" value="<?php echo esc_attr((string) ($editing['transmission'] ?? '0')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-ior"><?php esc_html_e('Index of refraction (IOR)', '3d-print-showcase'); ?></label></th><td><input id="ds82-ior" type="range" min="1" max="2.5" step="0.01" name="material[ior]" value="<?php echo esc_attr((string) ($editing['ior'] ?? '1.5')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-roughness"><?php esc_html_e('Roughness', '3d-print-showcase'); ?></label></th><td><input id="ds82-roughness" type="number" min="0" max="1" step="0.01" name="material[roughness]" value="<?php echo esc_attr((string) ($editing['roughness'] ?? '0.55')); ?>"></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-metalness"><?php esc_html_e('Metalness', '3d-print-showcase'); ?></label></th><td><input id="ds82-metalness" type="number" min="0" max="1" step="0.01" name="material[metalness]" value="<?php echo esc_attr((string) ($editing['metalness'] ?? '0.05')); ?>"></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><label for="ds82-opacity"><?php esc_html_e('Opacity', '3d-print-showcase'); ?></label></th><td><input id="ds82-opacity" type="number" min="0" max="1" step="0.01" name="material[opacity]" value="<?php echo esc_attr((string) ($editing['opacity'] ?? '1')); ?>"></td></tr>
                                <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><?php esc_html_e('Transparency', '3d-print-showcase'); ?></th><td><label><input type="checkbox" name="material[transparent]" value="yes" <?php checked(!empty($editing['transparent'])); ?>> <?php esc_html_e('Render as transparent', '3d-print-showcase'); ?></label></td></tr>
                                <tr data-editor-tab="lighting"><th><label for="ds82-light-key"><?php esc_html_e('Key light', '3d-print-showcase'); ?></label></th><td><input id="ds82-light-key" type="range" min="0" max="3" step="0.05" name="material[light_key]" value="<?php echo esc_attr((string) ($editing['light_key'] ?? '1.55')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="lighting"><th><label for="ds82-light-fill"><?php esc_html_e('Fill light', '3d-print-showcase'); ?></label></th><td><input id="ds82-light-fill" type="range" min="0" max="2" step="0.05" name="material[light_fill]" value="<?php echo esc_attr((string) ($editing['light_fill'] ?? '0.55')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="lighting"><th><label for="ds82-light-ambient"><?php esc_html_e('Ambient light', '3d-print-showcase'); ?></label></th><td><input id="ds82-light-ambient" type="range" min="0" max="2" step="0.05" name="material[light_ambient]" value="<?php echo esc_attr((string) ($editing['light_ambient'] ?? '0.85')); ?>"><output></output></td></tr>
                                <tr data-editor-tab="lighting"><th><label for="ds82-exposure"><?php esc_html_e('Exposure', '3d-print-showcase'); ?></label></th><td><input id="ds82-exposure" type="range" min="0.25" max="2" step="0.05" name="material[exposure]" value="<?php echo esc_attr((string) ($editing['exposure'] ?? '1')); ?>"><output></output><p class="description"><?php esc_html_e('Lighting values are stored with this appearance and update the live model immediately.', '3d-print-showcase'); ?></p></td></tr>
                            </table>
                            <?php submit_button($editing ? __('Save material', '3d-print-showcase') : __('Add material', '3d-print-showcase')); ?>
                            <?php if ($editing) : ?><a class="button" href="<?php echo esc_url(admin_url('admin.php?page=ds82-3dps-materials')); ?>"><?php esc_html_e('Cancel editing', '3d-print-showcase'); ?></a><?php endif; ?>
                        </form>
                    </div>
                </div>
                <div>
                    <div class="ds82-3dps-card ds82-3dps-live-preview-card">
                        <h2><?php esc_html_e('Live color preview', '3d-print-showcase'); ?></h2>
                        <p><?php esc_html_e('This preview shows the selected model colors against the saved viewer background.', '3d-print-showcase'); ?></p>
                        <div class="ds82-3dps-live-preview" id="ds82-material-live-preview" aria-label="<?php esc_attr_e('Live color preview', '3d-print-showcase'); ?>"><span></span></div>
                        <h3 class="ds82-3dps-model-preview-title"><?php esc_html_e('Live model preview', '3d-print-showcase'); ?></h3>
                        <p><?php esc_html_e('The model updates immediately when you change colors, background or surface appearance.', '3d-print-showcase'); ?></p>
                        <div id="ds82-material-model-preview" class="ds82-3dps-model-preview">
                            <?php
                            $previewModelUrl = esc_url((string) ($settings['preview_model_url'] ?? ''));
                            $previewAutoRotate = 'yes' === ($settings['preview_auto_rotate'] ?? 'no') ? 'true' : 'false';
                            echo do_shortcode('[ds82_3d_print_showcase model_url="' . $previewModelUrl . '" height="360" auto_rotate="' . $previewAutoRotate . '"]'); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
                            ?>
                        </div>
                    </div>
                    <div class="ds82-3dps-card"><h2><?php esc_html_e('Internal library', '3d-print-showcase'); ?></h2><p><?php esc_html_e('Materials created here work without any add-on. An installed ACF/REST integration can be selected as an alternative source on the Integrations page.', '3d-print-showcase'); ?></p></div>
                </div>
            </div>
        <?php else : ?>
            <?php if ($editingExternalMaterial instanceof Material) : ?>
                <?php $this->render_external_material_editor($editingExternalMaterial, $editingExternal); ?>
            <?php endif; ?>
            <p><a class="button button-primary" href="<?php echo esc_url($this->action_url('ds82_3dps_sync_materials')); ?>"><?php esc_html_e('Synchronize materials', '3d-print-showcase'); ?></a> <a class="button" href="<?php echo esc_url($this->action_url('ds82_3dps_clear_cache')); ?>"><?php esc_html_e('Clear material cache', '3d-print-showcase'); ?></a></p>
        <?php endif; ?>

        <h2><?php esc_html_e('Material library', '3d-print-showcase'); ?></h2>
        <?php if (!$materials) : ?>
            <div class="notice notice-info inline"><p><?php echo esc_html($isInternal ? __('No materials have been created yet. Use the form above to add the first material.', '3d-print-showcase') : __('No synchronized materials are available from the selected source.', '3d-print-showcase')); ?></p></div>
        <?php else : ?>
            <?php
            uasort($materials, static fn (Material $a, Material $b): int => strnatcasecmp($a->display_id(), $b->display_id()));
            // Optional stock data is supplied by Filament Storage. The base plugin stays
            // independent, so any compatible add-on can provide the same normalized map.
            $stockMap = apply_filters('ds82_3dps_material_stock_map', []);
            $stockMap = is_array($stockMap) ? $stockMap : [];
            $showStock = !empty($stockMap) || has_filter('ds82_3dps_material_stock_map');
            ?>
            <div class="ds82-3dps-materials-table-wrap"><table class="widefat striped ds82-3dps-materials-table">
                <thead><tr><th><?php esc_html_e('ID', '3d-print-showcase'); ?></th><th><?php esc_html_e('Preview', '3d-print-showcase'); ?></th><th><?php esc_html_e('Color name', '3d-print-showcase'); ?></th><th><?php esc_html_e('Number of colors', '3d-print-showcase'); ?></th><th><?php esc_html_e('Color layout', '3d-print-showcase'); ?></th><th><?php esc_html_e('Colors', '3d-print-showcase'); ?></th><th><?php esc_html_e('Surface appearance', '3d-print-showcase'); ?></th><?php if (!$isInternal) : ?><th><?php esc_html_e('Material', '3d-print-showcase'); ?></th><th><?php esc_html_e('Manufacturer', '3d-print-showcase'); ?></th><?php endif; ?><?php if ($showStock) : ?><th><?php esc_html_e('Available filament', '3d-print-showcase'); ?></th><?php endif; ?><th><?php esc_html_e('Identifier', '3d-print-showcase'); ?></th><th><?php esc_html_e('Actions', '3d-print-showcase'); ?></th></tr></thead>
                <tbody><?php foreach ($materials as $identifier => $material) : ?><tr>
                    <td><strong><?php echo esc_html($material->display_id()); ?></strong></td><td><?php if ($material->previewImageUrl) : ?><img class="ds82-3dps-material-thumb" src="<?php echo esc_url($material->previewImageUrl); ?>" alt=""><?php endif; ?></td><td><?php echo esc_html($material->name); ?></td><td><?php echo esc_html($this->color_mode_label((string) $material->colorMode)); ?></td><td><?php echo esc_html($this->color_layout_label((string) $material->colorModeType)); ?></td><td><?php echo $this->color_preview($material); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?></td><td><?php $surfaceDisplay = (!$isInternal && in_array($material->source, ['remote_rest', 'custom_rest'], true) && !empty($material->sourceData['remote_material_variant'])) ? (string) $material->sourceData['remote_material_variant'] : $this->appearance_label((string) $material->appearanceType); echo esc_html($surfaceDisplay); ?></td><?php if (!$isInternal) : ?><td><?php echo esc_html((string) $material->materialType); ?></td><td><?php echo esc_html((string) $material->manufacturer); ?></td><?php endif; ?><?php if ($showStock) : ?><?php
                        $stock = $stockMap[(string) $identifier] ?? $stockMap[$material->display_id()] ?? null;
                        $grams = is_array($stock) ? max(0.0, (float) ($stock['remaining_weight_g'] ?? 0)) : 0.0;
                        $spoolCount = is_array($stock) ? max(0, (int) ($stock['spool_count'] ?? 0)) : 0;
                        $stockClass = $grams <= 0 ? 'is-empty' : ($grams < 200 ? 'is-low' : 'is-available');
                    ?><td><strong class="ds82-3dps-stock <?php echo esc_attr($stockClass); ?>"><?php echo esc_html(number_format_i18n($grams, $grams == floor($grams) ? 0 : 2) . ' g'); ?></strong><?php if ($spoolCount > 0) : ?><br><small><?php echo esc_html(sprintf(_n('%d spool', '%d spools', $spoolCount, '3d-print-showcase'), $spoolCount)); ?></small><?php endif; ?></td><?php endif; ?><td><code><?php echo esc_html((string) $identifier); ?></code></td>
                    <td><?php if ($isInternal) : ?><a href="<?php echo esc_url(add_query_arg(['page' => 'ds82-3dps-materials', 'edit_material' => $material->slug], admin_url('admin.php'))); ?>"><?php esc_html_e('Edit', '3d-print-showcase'); ?></a> | <a class="submitdelete" onclick="return confirm('<?php echo esc_js(__('Delete this material?', '3d-print-showcase')); ?>')" href="<?php echo esc_url(wp_nonce_url(admin_url('admin-post.php?action=ds82_3dps_delete_internal_material&slug=' . rawurlencode($material->slug)), 'ds82_3dps_delete_internal_material')); ?>"><?php esc_html_e('Delete', '3d-print-showcase'); ?></a><?php else : ?><a href="<?php echo esc_url(add_query_arg(['page'=>'ds82-3dps-materials','edit_external'=>rawurlencode((string)$identifier)],admin_url('admin.php'))); ?>"><?php esc_html_e('Edit 3D settings', '3d-print-showcase'); ?></a><?php endif; ?></td>
                </tr><?php endforeach; ?></tbody>
            </table></div>
        <?php endif; ?>
        <?php
        $this->footer();
    }

    private function render_external_material_editor(Material $material, array $editing): void
    {
        $colors = array_values(array_filter(array_map(
            static fn (string $color): string => sanitize_hex_color($color) ?: '',
            $material->colors()
        )));
        if (!$colors) {
            $colors = ['#b7b7b7'];
        }

        $colorCount = max(1, min(4, count($colors)));
        $colorMode = (string) ($material->colorMode ?: match ($colorCount) {
            2 => 'dual',
            3 => 'triple',
            4 => 'quad',
            default => 'single',
        });
        $surfaceTypes = [
            'standard' => __('Standard', '3d-print-showcase'),
            'matte' => __('Matte', '3d-print-showcase'),
            'glossy' => __('Glossy', '3d-print-showcase'),
            'silk' => __('Silk', '3d-print-showcase'),
            'satin' => __('Satin', '3d-print-showcase'),
            'metallic' => __('Metallic', '3d-print-showcase'),
            'pearl' => __('Pearlescent', '3d-print-showcase'),
            'transparent' => __('Transparent', '3d-print-showcase'),
        ];
        $settings = Settings::all();
        ?>
        <div class="ds82-3dps-admin-grid ds82-3dps-external-material-editor">
            <div>
                <div class="ds82-3dps-card">
                    <h2><?php echo esc_html(sprintf(__('3D settings: %s', '3d-print-showcase'), $material->label())); ?></h2>
                    <p class="description"><?php esc_html_e('ID, name and colors come from the active external material source. The settings below are stored locally by 3D Print Showcase and are not overwritten by synchronization.', '3d-print-showcase'); ?></p>
                    <form method="post" action="<?php echo esc_url(admin_url('admin-post.php')); ?>">
                        <input type="hidden" name="action" value="ds82_3dps_save_material_override">
                        <input type="hidden" name="identifier" value="<?php echo esc_attr($material->identifier()); ?>">
                        <?php wp_nonce_field('ds82_3dps_save_material_override'); ?>

                        <?php /* Hidden source colors feed the exact same live-preview JavaScript used by internal materials. */ ?>
                        <div class="ds82-3dps-external-source-colors" hidden aria-hidden="true">
                            <input type="hidden" id="ds82-color-mode" value="<?php echo esc_attr($colorMode); ?>">
                            <?php foreach (array_slice($colors, 0, 4) as $index => $color) : ?>
                                <div class="ds82-3dps-color-row" data-color-index="<?php echo esc_attr((string) ($index + 1)); ?>">
                                    <input type="color" value="<?php echo esc_attr($color); ?>" tabindex="-1">
                                </div>
                            <?php endforeach; ?>
                        </div>

                        <div class="ds82-3dps-editor-tabs" role="tablist">
                            <button type="button" class="button is-active" data-tab="general"><?php esc_html_e('Layout', '3d-print-showcase'); ?></button>
                            <button type="button" class="button" data-tab="surface"><?php esc_html_e('Surface', '3d-print-showcase'); ?></button>
                            <button type="button" class="button" data-tab="lighting"><?php esc_html_e('Lighting', '3d-print-showcase'); ?></button>
                            <button type="button" class="button" data-tab="textures"><?php esc_html_e('Textures', '3d-print-showcase'); ?></button>
                        </div>
                        <table id="ds82-material-editor-table" class="form-table" role="presentation">
                            <tr data-editor-tab="general"><th><?php esc_html_e('Source data', '3d-print-showcase'); ?></th><td><strong><?php echo esc_html($material->display_id() . ' — ' . $material->name); ?></strong><br><?php foreach ($colors as $c) : ?><span style="display:inline-block;width:22px;height:22px;border:1px solid #aaa;background:<?php echo esc_attr($c); ?>;vertical-align:middle;margin:4px"></span><code><?php echo esc_html(strtoupper($c)); ?></code> <?php endforeach; ?></td></tr>
                            <tr data-editor-tab="general"><th><label for="ds82-color-mode-type"><?php esc_html_e('Color layout', '3d-print-showcase'); ?></label></th><td><select id="ds82-color-mode-type" name="material[color_mode_type]"><?php foreach (['standard' => __('Standard', '3d-print-showcase'), 'gradient' => __('Gradient', '3d-print-showcase'), 'rainbow' => __('Rainbow', '3d-print-showcase'), 'layered' => __('Layered', '3d-print-showcase')] as $v => $l) : ?><option value="<?php echo esc_attr($v); ?>" <?php selected((string) ($editing['color_mode_type'] ?? 'standard'), $v); ?>><?php echo esc_html($l); ?></option><?php endforeach; ?></select><p id="ds82-standard-layout-note" class="description"><?php esc_html_e('Colors themselves remain controlled by the external source.', '3d-print-showcase'); ?></p></td></tr>
                            <tr data-editor-tab="general" class="ds82-3dps-flow-row"><th><?php esc_html_e('Color direction', '3d-print-showcase'); ?></th><td><select id="ds82-color-direction" name="material[color_direction]"><?php foreach (['left_right' => __('Left to right', '3d-print-showcase'), 'right_left' => __('Right to left', '3d-print-showcase'), 'front_back' => __('Front to back', '3d-print-showcase'), 'back_front' => __('Back to front', '3d-print-showcase'), 'bottom_top' => __('Bottom to top', '3d-print-showcase'), 'top_bottom' => __('Top to bottom', '3d-print-showcase')] as $v => $l) : ?><option value="<?php echo esc_attr($v); ?>" <?php selected((string) ($editing['color_direction'] ?? 'left_right'), $v); ?>><?php echo esc_html($l); ?></option><?php endforeach; ?></select></td></tr>
                            <tr data-editor-tab="general" class="ds82-3dps-flow-row"><th><?php esc_html_e('Transition softness', '3d-print-showcase'); ?></th><td><input id="ds82-color-blend-percent" type="range" min="0" max="100" step="1" name="material[color_blend_percent]" value="<?php echo esc_attr((string) ($editing['color_blend_percent'] ?? 45)); ?>"><output></output> %</td></tr>
                            <?php for ($i = 1; $i <= 4; $i++) : ?><tr data-editor-tab="general" class="ds82-3dps-flow-row ds82-3dps-color-share-row" data-color-index="<?php echo esc_attr((string) $i); ?>"><th><?php echo esc_html(sprintf(__('Color %d share', '3d-print-showcase'), $i)); ?></th><td><input id="ds82-color-share-<?php echo esc_attr((string) $i); ?>" type="number" min="1" max="100" name="material[color_share_<?php echo esc_attr((string) $i); ?>]" value="<?php echo esc_attr((string) ($editing['color_shares'][$i - 1] ?? 25)); ?>"> %</td></tr><?php endfor; ?>
                            <tr data-editor-tab="general" class="ds82-3dps-layered-row"><th><?php esc_html_e('Colored band height', '3d-print-showcase'); ?></th><td><input id="ds82-layer-band-percent" type="range" min="0.25" max="50" step="0.25" name="material[layer_band_percent]" value="<?php echo esc_attr((string) ($editing['layer_band_percent'] ?? 1)); ?>"><output></output> %</td></tr>
                            <tr data-editor-tab="general" class="ds82-3dps-layered-row"><th><?php esc_html_e('Natural variation', '3d-print-showcase'); ?></th><td><input id="ds82-layer-variation-percent" type="range" min="0" max="25" name="material[layer_variation_percent]" value="<?php echo esc_attr((string) ($editing['layer_variation_percent'] ?? 10)); ?>"><output></output> %</td></tr>
                            <tr data-editor-tab="general" class="ds82-3dps-layered-row"><th><?php esc_html_e('Edge blending', '3d-print-showcase'); ?></th><td><input id="ds82-layer-blend-percent" type="range" min="0" max="20" name="material[layer_blend_percent]" value="<?php echo esc_attr((string) ($editing['layer_blend_percent'] ?? 6)); ?>"><output></output> %</td></tr>
                            <tr data-editor-tab="general"><th><?php esc_html_e('Viewer background color', '3d-print-showcase'); ?></th><td><input id="ds82-background-color" type="color" name="material[background_color]" value="<?php echo esc_attr(sanitize_hex_color((string) ($editing['background_color'] ?? '')) ?: '#f7f7f7'); ?>"></td></tr>
                            <tr data-editor-tab="surface"><th><?php esc_html_e('Surface appearance', '3d-print-showcase'); ?></th><td><select id="ds82-appearance-type" name="material[appearance_type]"><?php foreach ($surfaceTypes as $v => $l) : ?><option value="<?php echo esc_attr($v); ?>" <?php selected((string) ($editing['appearance_type'] ?? 'standard'), $v); ?>><?php echo esc_html($l); ?></option><?php endforeach; ?></select></td></tr>
                            <tr data-editor-tab="surface"><th><?php esc_html_e('Advanced material settings', '3d-print-showcase'); ?></th><td><label><input id="ds82-advanced-material" type="checkbox" name="material[advanced_enabled]" value="yes" <?php checked(!empty($editing['advanced_enabled'])); ?>> <?php esc_html_e('Show and use advanced physical material controls.', '3d-print-showcase'); ?></label></td></tr>
                            <?php foreach (['clearcoat' => [__('Clearcoat', '3d-print-showcase'), 0, 1, .01], 'sheen' => [__('Sheen', '3d-print-showcase'), 0, 1, .01], 'iridescence' => [__('Iridescence', '3d-print-showcase'), 0, 1, .01], 'transmission' => [__('Transmission', '3d-print-showcase'), 0, 1, .01], 'ior' => [__('Index of refraction (IOR)', '3d-print-showcase'), 1, 2.5, .01]] as $key => $cfg) : ?><tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><?php echo esc_html($cfg[0]); ?></th><td><input id="ds82-<?php echo esc_attr($key); ?>" type="range" min="<?php echo esc_attr((string) $cfg[1]); ?>" max="<?php echo esc_attr((string) $cfg[2]); ?>" step="<?php echo esc_attr((string) $cfg[3]); ?>" name="material[<?php echo esc_attr($key); ?>]" value="<?php echo esc_attr((string) ($editing[$key] ?? ($key === 'ior' ? 1.5 : 0))); ?>"><output></output></td></tr><?php endforeach; ?>
                            <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><?php esc_html_e('Roughness', '3d-print-showcase'); ?></th><td><input id="ds82-roughness" type="number" min="0" max="1" step="0.01" name="material[roughness]" value="<?php echo esc_attr((string) ($editing['roughness'] ?? .55)); ?>"></td></tr>
                            <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><?php esc_html_e('Metalness', '3d-print-showcase'); ?></th><td><input id="ds82-metalness" type="number" min="0" max="1" step="0.01" name="material[metalness]" value="<?php echo esc_attr((string) ($editing['metalness'] ?? .05)); ?>"></td></tr>
                            <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><?php esc_html_e('Opacity', '3d-print-showcase'); ?></th><td><input id="ds82-opacity" type="number" min="0" max="1" step="0.01" name="material[opacity]" value="<?php echo esc_attr((string) ($editing['opacity'] ?? 1)); ?>"></td></tr>
                            <tr data-editor-tab="surface" class="ds82-3dps-advanced-row"><th><?php esc_html_e('Transparency', '3d-print-showcase'); ?></th><td><label><input type="checkbox" name="material[transparent]" value="yes" <?php checked(!empty($editing['transparent'])); ?>> <?php esc_html_e('Render as transparent', '3d-print-showcase'); ?></label></td></tr>
                            <?php foreach (['light_key' => [__('Key light', '3d-print-showcase'), 0, 3, .05, 1.55], 'light_fill' => [__('Fill light', '3d-print-showcase'), 0, 2, .05, .55], 'light_ambient' => [__('Ambient light', '3d-print-showcase'), 0, 2, .05, .85], 'exposure' => [__('Exposure', '3d-print-showcase'), .25, 2, .05, 1]] as $key => $cfg) : ?><tr data-editor-tab="lighting"><th><?php echo esc_html($cfg[0]); ?></th><td><input id="ds82-<?php echo esc_attr(str_replace('_', '-', $key)); ?>" type="range" min="<?php echo esc_attr((string) $cfg[1]); ?>" max="<?php echo esc_attr((string) $cfg[2]); ?>" step="<?php echo esc_attr((string) $cfg[3]); ?>" name="material[<?php echo esc_attr($key); ?>]" value="<?php echo esc_attr((string) ($editing[$key] ?? $cfg[4])); ?>"><output></output></td></tr><?php endforeach; ?>
                            <tr data-editor-tab="textures"><th><?php esc_html_e('Texture URL', '3d-print-showcase'); ?></th><td><input type="url" class="large-text" name="material[texture_url]" value="<?php echo esc_attr((string) ($editing['texture_url'] ?? '')); ?>"></td></tr>
                            <tr data-editor-tab="textures"><th><?php esc_html_e('Normal map URL', '3d-print-showcase'); ?></th><td><input type="url" class="large-text" name="material[normal_map_url]" value="<?php echo esc_attr((string) ($editing['normal_map_url'] ?? '')); ?>"></td></tr>
                        </table>
                        <?php submit_button(__('Save 3D settings', '3d-print-showcase')); ?>
                        <a class="button" href="<?php echo esc_url(admin_url('admin.php?page=ds82-3dps-materials')); ?>"><?php esc_html_e('Cancel editing', '3d-print-showcase'); ?></a>
                        <a class="button button-link-delete" href="<?php echo esc_url(wp_nonce_url(admin_url('admin-post.php?action=ds82_3dps_reset_material_override&identifier=' . rawurlencode($material->identifier())), 'ds82_3dps_reset_material_override')); ?>"><?php esc_html_e('Reset local 3D settings', '3d-print-showcase'); ?></a>
                    </form>
                </div>
            </div>
            <div>
                <div class="ds82-3dps-card ds82-3dps-live-preview-card">
                    <h2><?php esc_html_e('Live color preview', '3d-print-showcase'); ?></h2>
                    <p><?php esc_html_e('This preview shows the selected model colors against the saved viewer background.', '3d-print-showcase'); ?></p>
                    <div class="ds82-3dps-live-preview" id="ds82-material-live-preview" aria-label="<?php esc_attr_e('Live color preview', '3d-print-showcase'); ?>"><span></span></div>
                    <h3 class="ds82-3dps-model-preview-title"><?php esc_html_e('Live model preview', '3d-print-showcase'); ?></h3>
                    <p><?php esc_html_e('The model updates immediately when you change colors, background or surface appearance.', '3d-print-showcase'); ?></p>
                    <div id="ds82-material-model-preview" class="ds82-3dps-model-preview">
                        <?php
                        $previewModelUrl = esc_url((string) ($settings['preview_model_url'] ?? ''));
                        $previewAutoRotate = 'yes' === ($settings['preview_auto_rotate'] ?? 'no') ? 'true' : 'false';
                        echo do_shortcode('[ds82_3d_print_showcase model_url="' . $previewModelUrl . '" height="360" auto_rotate="' . $previewAutoRotate . '"]'); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
                        ?>
                    </div>
                </div>
            </div>
        </div>
        <?php
    }

    public function diagnostics_page(): void
    {
        $this->guard_page();
        $provider = $this->materials->provider();
        $status = method_exists($provider, 'status') ? (array) $provider->status() : [];
        $this->header(__('Diagnostics', '3d-print-showcase'));
        ?>
        <div class="ds82-3dps-admin-grid">
            <div class="ds82-3dps-card">
                <h2><?php esc_html_e('Active material provider', '3d-print-showcase'); ?></h2>
                <p><code><?php echo esc_html($provider->get_id()); ?></code></p>
                <p><?php echo esc_html((string) ($status['message'] ?? __('No diagnostic result is available.', '3d-print-showcase'))); ?></p>
                <p><a class="button" href="<?php echo esc_url($this->action_url('ds82_3dps_test_provider')); ?>"><?php esc_html_e('Test material provider', '3d-print-showcase'); ?></a></p>
            </div>
            <div class="ds82-3dps-card">
                <h2><?php esc_html_e('Environment', '3d-print-showcase'); ?></h2>
                <p>WordPress: <code><?php echo esc_html(get_bloginfo('version')); ?></code></p>
                <p>PHP: <code><?php echo esc_html(PHP_VERSION); ?></code></p>
                <p><?php esc_html_e('Registered material sources', '3d-print-showcase'); ?>: <code><?php echo esc_html(implode(', ', $this->providers->ids()) ?: '—'); ?></code></p>
            </div>
        </div>
        <?php
        $this->footer();
    }

    public function tools_page(): void
    {
        $this->guard_page();
        $this->header(__('Tools', '3d-print-showcase'));
        ?>
        <div class="ds82-3dps-admin-grid">
            <div>
                <div class="ds82-3dps-card"><h2><?php esc_html_e('Import settings', '3d-print-showcase'); ?></h2><form method="post" enctype="multipart/form-data" action="<?php echo esc_url(admin_url('admin-post.php')); ?>"><input type="hidden" name="action" value="ds82_3dps_import_settings"><?php wp_nonce_field('ds82_3dps_import_settings'); ?><input type="file" name="settings_file" accept="application/json,.json" required> <?php submit_button(__('Import settings', '3d-print-showcase'), 'secondary', 'submit', false); ?></form></div>
                <div class="ds82-3dps-card"><h2><?php esc_html_e('Export settings', '3d-print-showcase'); ?></h2><p><a class="button" href="<?php echo esc_url($this->action_url('ds82_3dps_export_settings')); ?>"><?php esc_html_e('Download JSON export', '3d-print-showcase'); ?></a></p></div>
            </div>
            <div><div class="ds82-3dps-card"><h2><?php esc_html_e('Reset', '3d-print-showcase'); ?></h2><p><?php esc_html_e('Reset global base-plugin settings. Product metadata and add-on settings are not deleted.', '3d-print-showcase'); ?></p><p><a class="button button-link-delete" onclick="return confirm('<?php echo esc_js(__('Reset plugin settings?', '3d-print-showcase')); ?>')" href="<?php echo esc_url($this->action_url('ds82_3dps_reset_settings')); ?>"><?php esc_html_e('Reset settings', '3d-print-showcase'); ?></a></p></div></div>
        </div>
        <?php
        $this->footer();
    }

    public function save_settings(): void
    {
        $this->guard_action('ds82_3dps_save_settings');
        check_admin_referer('ds82_3dps_save_settings');
        $postedSettings = filter_input(INPUT_POST, 'settings', FILTER_DEFAULT, FILTER_REQUIRE_ARRAY);
        $input = is_array($postedSettings) ? $this->sanitize_input_array($postedSettings) : [];
        $redirectPageInput = filter_input(INPUT_POST, 'redirect_page', FILTER_UNSAFE_RAW);
        $redirectPage = sanitize_key(is_string($redirectPageInput) ? $redirectPageInput : 'ds82-3dps');
        if (in_array($redirectPage, ['ds82-3dps-integrations', 'ds82-3dps-materials'], true)) {
            $input = array_merge(Settings::all(), $input);
        }
        $sanitized = Settings::sanitize($input, $this->providers->ids(), $this->integrations->ids_by_type('selection'));
        update_option(Settings::OPTION, $sanitized, false);
        $this->redirect($redirectPage, 'settings-saved');
    }

    public function save_internal_material(): void
    {
        $this->guard_action('ds82_3dps_save_internal_material');
        check_admin_referer('ds82_3dps_save_internal_material');
        $provider = $this->providers->get('internal');
        if (!$provider instanceof InternalMaterialProvider) {
            $this->redirect('ds82-3dps-materials', 'material-save-failed');
        }
        $postedMaterial = filter_input(INPUT_POST, 'material', FILTER_DEFAULT, FILTER_REQUIRE_ARRAY);
        $input = is_array($postedMaterial) ? $this->sanitize_input_array($postedMaterial) : [];
        $provider->save($input);
        $this->redirect('ds82-3dps-materials', 'material-saved');
    }

    public function save_material_override(): void
    {
        $this->guard_action('ds82_3dps_save_material_override');
        check_admin_referer('ds82_3dps_save_material_override');
        $identifierRaw = filter_input(INPUT_POST, 'identifier', FILTER_UNSAFE_RAW);
        $identifier = is_string($identifierRaw) ? sanitize_text_field(wp_unslash($identifierRaw)) : '';
        $provider = $this->materials->provider();
        $material = $identifier ? $provider->get_material($identifier) : null;
        if (!$material instanceof Material || 'internal' === $material->source) {
            $this->redirect('ds82-3dps-materials','material-save-failed');
        }
        $posted = filter_input(INPUT_POST, 'material', FILTER_DEFAULT, FILTER_REQUIRE_ARRAY);
        $input = is_array($posted) ? $this->sanitize_input_array($posted) : [];
        $this->overrides->save($material,$input);
        $this->redirect('ds82-3dps-materials','material-saved');
    }

    public function reset_material_override(): void
    {
        $this->guard_action('ds82_3dps_reset_material_override');
        check_admin_referer('ds82_3dps_reset_material_override');
        $identifierRaw = filter_input(INPUT_GET, 'identifier', FILTER_UNSAFE_RAW);
        $identifier = is_string($identifierRaw) ? sanitize_text_field(wp_unslash($identifierRaw)) : '';
        if ($identifier) $this->overrides->delete($identifier);
        $this->redirect('ds82-3dps-materials','settings-saved');
    }

    public function delete_internal_material(): void
    {
        $this->guard_action('ds82_3dps_delete_internal_material');
        check_admin_referer('ds82_3dps_delete_internal_material');
        $provider = $this->providers->get('internal');
        if ($provider instanceof InternalMaterialProvider) {
            $slug = filter_input(INPUT_GET, 'slug', FILTER_UNSAFE_RAW);
            $provider->delete(sanitize_key(is_string($slug) ? $slug : ''));
        }
        $this->redirect('ds82-3dps-materials', 'material-deleted');
    }

    public function sync_materials(): void
    {
        $this->guard_action('ds82_3dps_sync_materials');
        check_admin_referer('ds82_3dps_sync_materials');
        $this->materials->all(true);
        $this->redirect('ds82-3dps-materials', 'materials-synchronized');
    }

    public function test_provider(): void
    {
        $this->guard_action('ds82_3dps_test_provider');
        check_admin_referer('ds82_3dps_test_provider');
        $provider = $this->materials->provider();
        if (method_exists($provider, 'test_connection')) {
            $provider->test_connection();
        }
        $this->redirect('ds82-3dps-diagnostics', 'connection-tested');
    }

    public function clear_cache(): void
    {
        $this->guard_action('ds82_3dps_clear_cache');
        check_admin_referer('ds82_3dps_clear_cache');
        $provider = $this->materials->provider();
        if (method_exists($provider, 'clear_cache')) {
            $provider->clear_cache();
        }
        $this->redirect('ds82-3dps-materials', 'cache-cleared');
    }

    public function export_settings(): void
    {
        $this->guard_action('ds82_3dps_export_settings');
        check_admin_referer('ds82_3dps_export_settings');
        $payload = ['plugin' => '3d-print-showcase', 'version' => DS82_3DPS_VERSION, 'exported_at' => gmdate('c'), 'settings' => Settings::all()];
        nocache_headers();
        header('Content-Type: application/json; charset=utf-8');
        header('Content-Disposition: attachment; filename="ds82-3dps-settings-' . gmdate('Y-m-d') . '.json"');
        echo wp_json_encode($payload, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
        exit;
    }

    public function import_settings(): void
    {
        $this->guard_action('ds82_3dps_import_settings');
        check_admin_referer('ds82_3dps_import_settings');
        $uploadedFile = isset($_FILES['settings_file']) && is_array($_FILES['settings_file']) ? $_FILES['settings_file'] : []; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
        $uploadError = isset($uploadedFile['error']) ? absint($uploadedFile['error']) : UPLOAD_ERR_NO_FILE;
        $temporaryName = isset($uploadedFile['tmp_name']) ? sanitize_text_field(wp_unslash((string) $uploadedFile['tmp_name'])) : '';
        $originalName = isset($uploadedFile['name']) ? sanitize_file_name(wp_unslash((string) $uploadedFile['name'])) : '';
        if (UPLOAD_ERR_OK !== $uploadError || '' === $temporaryName || !is_uploaded_file($temporaryName) || 'json' !== strtolower((string) pathinfo($originalName, PATHINFO_EXTENSION))) {
            $this->redirect('ds82-3dps-tools', 'import-failed');
        }
        $raw = file_get_contents($temporaryName); // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
        $decoded = json_decode((string) $raw, true);
        $input = is_array($decoded['settings'] ?? null) ? $decoded['settings'] : (is_array($decoded) ? $decoded : []);
        if (!$input) {
            $this->redirect('ds82-3dps-tools', 'import-failed');
        }
        update_option(Settings::OPTION, Settings::sanitize($input, $this->providers->ids(), $this->integrations->ids_by_type('selection')), false);
        $this->redirect('ds82-3dps-tools', 'settings-imported');
    }

    public function reset_settings(): void
    {
        $this->guard_action('ds82_3dps_reset_settings');
        check_admin_referer('ds82_3dps_reset_settings');
        update_option(Settings::OPTION, Settings::defaults(), false);
        $this->redirect('ds82-3dps-tools', 'settings-reset');
    }

    private function header(string $title): void
    {
        $notice = sanitize_key((string) filter_input(INPUT_GET, 'ds82_3dps_notice', FILTER_UNSAFE_RAW));
        ?>
        <?php /* translators: %s: Current administration page title. */ ?>
        <div class="wrap"><h1><?php echo esc_html(sprintf(__('3D Print Showcase — %s', '3d-print-showcase'), $title)); ?></h1>
        <?php if ($notice) : ?><div class="notice notice-success is-dismissible"><p><?php echo esc_html($this->notice_text($notice)); ?></p></div><?php endif; ?>
        <nav class="nav-tab-wrapper">
            <?php foreach ($this->tabs() as $slug => $label) : ?><a class="nav-tab <?php echo $this->current_page() === $slug ? 'nav-tab-active' : ''; ?>" href="<?php echo esc_url(admin_url('admin.php?page=' . $slug)); ?>"><?php echo esc_html($label); ?></a><?php endforeach; ?>
        </nav>
        <?php
    }

    private function footer(): void { echo '</div>'; }

    private function tabs(): array
    {
        $coreTabs = [
            'ds82-3dps' => __('Info', '3d-print-showcase'),
            'ds82-3dps-settings' => __('Settings', '3d-print-showcase'),
            'ds82-3dps-materials' => __('Materials', '3d-print-showcase'),
            'ds82-3dps-shortcode-builder' => __('Shortcode Builder', '3d-print-showcase'),
            'ds82-3dps-diagnostics' => __('Diagnostics', '3d-print-showcase'),
            'ds82-3dps-tools' => __('Tools', '3d-print-showcase'),
            'ds82-3dps-documentation' => __('Documentation', '3d-print-showcase'),
            'ds82-3dps-user-viewer' => __('User 3D Viewer', '3d-print-showcase'),
        ];

        // Add-ons may append their own administration tabs through this filter.
        // The Addons catalog is removed from the filtered result and appended
        // afterwards so it always remains the final navigation item.
        $tabs = apply_filters('ds82_3dps_admin_tabs', $coreTabs);
        if (!is_array($tabs)) {
            $tabs = $coreTabs;
        }
        unset($tabs['ds82-3dps-integrations']);
        $tabs['ds82-3dps-integrations'] = __('Addons', '3d-print-showcase');

        return $tabs;
    }

    private function color_preview(Material $material): string
    {
        $colors = $material->colors();
        if (!$colors) {
            $colors = ['#b7b7b7'];
        }
        $type = strtolower((string) $material->colorModeType);
        $safeColors = array_values(array_filter(array_map('sanitize_hex_color', $colors)));
        if (1 === count($safeColors)) {
            $background = $safeColors[0];
        } elseif (str_contains($type, 'layered') || str_contains($type, 'vrstven')) {
            $bandSize = min(50.0, max(0.25, (float) ($material->sourceData['layer_band_percent'] ?? 1)));
            $stops = [];
            $bandCount = (int) ceil(100 / $bandSize);
            for ($band = 0; $band < $bandCount; $band++) {
                $color = $safeColors[$band % count($safeColors)];
                $start = min(100, round($band * $bandSize, 2));
                $end = min(100, round(($band + 1) * $bandSize, 2));
                $stops[] = $color . ' ' . $start . '%';
                $stops[] = $color . ' ' . $end . '%';
            }
            $background = 'linear-gradient(to top,' . implode(',', $stops) . ')';
        } elseif (str_contains($type, 'duhov') || str_contains($type, 'rainbow')) {
            $background = 'linear-gradient(to top,' . implode(',', $safeColors) . ')';
        } elseif (str_contains($type, 'přech') || str_contains($type, 'gradient')) {
            $background = 'linear-gradient(to right,' . implode(',', $safeColors) . ')';
        } else {
            $background = 'conic-gradient(' . implode(',', $safeColors) . ')';
        }
        return '<span class="ds82-3dps-multi-color-chip" style="background:' . esc_attr($background) . '"></span><span class="ds82-3dps-color-codes">' . esc_html(implode(' · ', $colors)) . '</span>';
    }

    private function color_mode_label(string $value): string
    {
        return match (sanitize_key($value)) {
            'dual' => __('Two colors', '3d-print-showcase'),
            'triple' => __('Three colors', '3d-print-showcase'),
            'quad', 'multi' => __('Four colors', '3d-print-showcase'),
            default => __('One color', '3d-print-showcase'),
        };
    }

    private function color_layout_label(string $value): string
    {
        return match (sanitize_key($value)) {
            'gradient' => __('Gradient', '3d-print-showcase'),
            'rainbow' => __('Rainbow', '3d-print-showcase'),
            'layered' => __('Layered', '3d-print-showcase'),
            default => __('Standard', '3d-print-showcase'),
        };
    }

    private function appearance_label(string $value): string
    {
        $labels = [
            'standard' => __('Standard', '3d-print-showcase'),
            'matte' => __('Matte', '3d-print-showcase'),
            'glossy' => __('Glossy', '3d-print-showcase'),
            'silk' => __('Silk', '3d-print-showcase'),
            'satin' => __('Satin', '3d-print-showcase'),
            'glitter' => __('Glitter', '3d-print-showcase'),
            'metallic' => __('Metallic', '3d-print-showcase'),
            'pearl' => __('Pearlescent', '3d-print-showcase'),
            'transparent' => __('Transparent', '3d-print-showcase'),
            'carbon' => __('Carbon', '3d-print-showcase'),
            'wood' => __('Wood', '3d-print-showcase'),
        ];
        return $labels[sanitize_key($value)] ?? ($value !== '' ? $value : $labels['standard']);
    }

    private function action_url(string $action): string
    {
        return wp_nonce_url(admin_url('admin-post.php?action=' . $action), $action);
    }

    private function capability(): string
    {
        return class_exists('WooCommerce') ? 'manage_woocommerce' : 'manage_options';
    }

    private function guard_page(): void
    {
        if (!current_user_can($this->capability())) {
            wp_die(esc_html__('You are not allowed to access this page.', '3d-print-showcase'));
        }
    }

    private function sanitize_input_array(array $input): array
    {
        $sanitized = [];
        foreach ($input as $key => $value) {
            $safeKey = sanitize_key((string) $key);
            if (is_array($value)) {
                $sanitized[$safeKey] = $this->sanitize_input_array($value);
            } else {
                $sanitized[$safeKey] = sanitize_text_field((string) $value);
            }
        }
        return $sanitized;
    }

    private function guard_action(string $action): void
    {
        $this->guard_page();
    }

    private function redirect(string $page, string $notice): never
    {
        wp_safe_redirect(add_query_arg(['page' => $page, 'ds82_3dps_notice' => $notice], admin_url('admin.php')));
        exit;
    }

    private function current_page(): string
    {
        $page = filter_input(INPUT_GET, 'page', FILTER_UNSAFE_RAW);
        return sanitize_key(is_string($page) && '' !== $page ? $page : 'ds82-3dps');
    }

    private function notice_text(string $notice): string
    {
        return match ($notice) {
            'settings-saved' => __('Settings saved.', '3d-print-showcase'),
            'materials-synchronized' => __('Materials synchronized.', '3d-print-showcase'),
            'material-saved' => __('Material saved.', '3d-print-showcase'),
            'material-deleted' => __('Material deleted.', '3d-print-showcase'),
            'material-save-failed' => __('Material could not be saved.', '3d-print-showcase'),
            'connection-tested' => __('Connection test completed.', '3d-print-showcase'),
            'cache-cleared' => __('Material cache cleared.', '3d-print-showcase'),
            'settings-imported' => __('Settings imported.', '3d-print-showcase'),
            'settings-reset' => __('Settings reset.', '3d-print-showcase'),
            'import-failed' => __('Settings import failed.', '3d-print-showcase'),
            'addons-refreshed' => __('Addon catalog refreshed.', '3d-print-showcase'),
            'addon-installed' => __('Addon installed successfully.', '3d-print-showcase'),
            'addon-activated' => __('Addon activated successfully.', '3d-print-showcase'),
            'addon-updated' => __('Addon updated successfully.', '3d-print-showcase'),
            default => __('Operation completed.', '3d-print-showcase'),
        };
    }
}