<?php
/**
 * AF Translate — Administrative Editor View Interface Bootstrap Controller
 */

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

class AF_Translate_Editor_View {

    /**
     * Bootstraps metrics and safely passes data directly to the isolated markup view script.
     * Fully compatible with standard plugins, themes, and complex WordPress core structures.
     */
    public static function render( $slug, $type ) {
        if ( ! current_user_can( 'manage_options' ) ) {
            wp_die( esc_html__( 'Security Exception: Insufficient privileges to execute operations.', 'af-translate' ) );
        }

        $slug = sanitize_key( $slug ); // Text domain or WordPress core sub-group identifier
        $type = ( 'themes' === $type ) ? 'theme' : ( ( 'plugins' === $type ) ? 'plugin' : sanitize_key( $type ) ); 
        
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only parameter used strictly to filter display context; no state mutations are executed in this view rendering lifecycle.
        $selected_lang = isset( $_GET['lang'] ) ? sanitize_key( wp_unslash( $_GET['lang'] ) ) : '';
        
        // 1. Map filename conventions dynamically based on structural framework rules
        if ( 'wordpress' === $type ) {
            switch ( $slug ) {
                case 'admin-network':
                    $target_filename = "admin-network-{$selected_lang}.po";
                    break;
                case 'admin':
                    $target_filename = "admin-{$selected_lang}.po";
                    break;
                case 'continents-cities':
                    $target_filename = "continents-cities-{$selected_lang}.po";
                    break;
                case 'default':
                default:
                    $target_filename = "{$selected_lang}.po";
                    break;
            }
            $bundle_folder = 'core';
        } else {
            $target_filename = "{$slug}-{$selected_lang}.po";
            $bundle_folder   = ( 'plugin' === $type ) ? 'plugins' : 'themes';
        }

        $upload_dir       = wp_upload_dir();
        $safe_upload_path = wp_normalize_path( trailingslashit( $upload_dir['basedir'] ) . "af-translate/{$bundle_folder}/" );
        
        // Standardized Safe Path Configuration
        $custom_sandbox_po = $safe_upload_path . $target_filename;
        $po_file           = '';

        // CRITICAL CHECK: Always look in the custom uploads directory first!
        if ( file_exists( $custom_sandbox_po ) ) {
            $po_file = $custom_sandbox_po;
        } else {
            // Fallback: Scan the structural track layouts for localized ingestion targets
            $dirs = AF_Translate_Analyzer::locate_translation_dirs( $slug, $type );
            foreach ( $dirs as $key => $path ) {
                if ( 'wordpress' === $type ) {
                    $check_file = trailingslashit( $path ) . $target_filename;
                } else {
                    $check_file = ( 'author' === $key ) ? trailingslashit( $path ) . "{$selected_lang}.po" : trailingslashit( $path ) . "{$slug}-{$selected_lang}.po";
                }

                if ( file_exists( $check_file ) ) {
                    $po_file = $check_file;
                    break;
                }
            }
        }

        // Structural Directory Containment Validation
        if ( ! empty( $po_file ) ) {
            // Fall back to config-level containment rule to maintain consistent trailing slash checks
            if ( class_exists( 'AF_Translate_Project_Config' ) ) {
                $is_safe = AF_Translate_Project_Config::validate_file_path_containment( $po_file );
            } else {
                $is_safe = AF_Translate_Path_Validator::validate_containment( $po_file, false );
            }

            if ( ! $is_safe ) {
                wp_die( esc_html__( 'Security Exception: Target data stream layout points outside authorized system space.', 'af-translate' ) );
            }
        }

        // Parse PO map structures safely using our isolated extraction engine
        $strings     = ! empty( $po_file ) ? AF_Translate_PO_Processor::parse_file( $po_file ) : array();
        $total_count = count( $strings );
        $mod_time    = ! empty( $po_file ) && file_exists( $po_file ) ? date_i18n( get_option( 'date_format' ) . ' ' . get_option( 'time_format' ), filemtime( $po_file ) ) : esc_html__( 'Unknown Runtime State', 'af-translate' );
        
        // Set up the appropriate return navigation channel mapping context
        $target_page = 'af-translate';
        if ( 'plugin' === $type ) {
            $target_page = 'af-translate-plugins';
        } elseif ( 'theme' === $type ) {
            $target_page = 'af-translate-themes';
        }

        // Load the detached HTML template
        $template_path = plugin_dir_path( __FILE__ ) . 'views/html-editor-workbench.php';
        if ( file_exists( $template_path ) ) {
            include $template_path;
        } else {
            echo '<div class="error"><p>' . esc_html__( 'Critical Exception: Editor workspace layout template not found.', 'af-translate' ) . '</p></div>';
        }
    }
}