<?php
/**
 * Fully Compliant Custom Storage AJAX Processors for WordPress.org Submission
 * Includes Secure Activity Auditing Layers
 *
 * @package af-translate
 */

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

/**
 * Class AF_Translate_Path_Resolver
 * Centralized structural mapping component to decouple filesystem logic from AJAX controllers.
 */
class AF_Translate_Path_Resolver {

    /**
     * Set of core system bundle variant contexts.
     */
    public static $core_types = array( 'wordpress', 'core', 'default', 'admin', 'admin-network', 'continents-cities', 'network', 'continents', 'cities' );

    /**
     * Resolves complete workspace environment data blocks for a given context.
     */
    public static function resolve_workspace_meta( $component, $type, $locale ) {
        $is_core      = in_array( $type, self::$core_types, true );
        $is_main_core = ( $is_core && ( empty( $component ) || 'default' === $component || 'core' === $component || 'wordpress' === $component ) );
        $sub_folder   = $is_core ? 'core' : ( ( 'plugin' === $type ) ? 'plugins' : 'themes' );
        
        $wp_upload_info = wp_upload_dir();
        $target_dir     = trailingslashit( $wp_upload_info['basedir'] ) . 'af-translate/' . $sub_folder;
        
        $po_filename = $is_main_core ? "{$locale}.po" : "{$component}-{$locale}.po";
        $po_target   = trailingslashit( $target_dir ) . $po_filename;
        $mo_target   = str_replace( '.po', '.mo', $po_target );

        // Resolve absolute installation source base path structures
        $base_dir = '';
        if ( ! $is_core && ! empty( $component ) ) {
            if ( 'plugin' === $type ) {
                $base_dir = trailingslashit( WP_PLUGIN_DIR ) . $component;
            } else {
                $theme_obj = wp_get_theme( $component );
                $base_dir  = $theme_obj->exists() ? $theme_obj->get_stylesheet_directory() : trailingslashit( get_theme_root() ) . $component;
            }
        }

        return array(
            'is_core'      => $is_core,
            'is_main_core' => $is_main_core,
            'target_dir'   => $target_dir,
            'po_filename'  => $po_filename,
            'po_target'    => $po_target,
            'mo_target'    => $mo_target,
            'base_dir'     => $base_dir,
        );
    }

    /**
     * Standardizes tracking engine checks for legacy lowercase entries on Linux.
     */
    public static function run_case_migration( $meta, $locale, $component ) {
        if ( file_exists( $meta['po_target'] ) ) {
            return;
        }

        $lowercase_locale   = strtolower( $locale );
        $lowercase_filename = $meta['is_main_core'] ? "{$lowercase_locale}.po" : "{$component}-{$lowercase_locale}.po";
        $lowercase_po       = trailingslashit( $meta['target_dir'] ) . $lowercase_filename;

        if ( file_exists( $lowercase_po ) ) {
            global $wp_filesystem;
            if ( empty( $wp_filesystem ) ) {
                require_once ABSPATH . 'wp-admin/includes/file.php';
                WP_Filesystem();
            }

            if ( $wp_filesystem ) {
                $wp_filesystem->move( $lowercase_po, $meta['po_target'], true );
                $lowercase_mo = str_replace( '.po', '.mo', $lowercase_po );
                if ( $wp_filesystem->exists( $lowercase_mo ) ) {
                    $wp_filesystem->move( $lowercase_mo, $meta['mo_target'], true );
                }
            } else {
                // Fallback for environments where WP_Filesystem fails to initialize directly
                // phpcs:ignore WordPress.WP.AlternativeFunctions.rename_rename
                @rename( $lowercase_po, $meta['po_target'] );
                $lowercase_mo = str_replace( '.po', '.mo', $lowercase_po );
                if ( file_exists( $lowercase_mo ) ) {
                    // phpcs:ignore WordPress.WP.AlternativeFunctions.rename_rename
                    @rename( $lowercase_mo, $meta['mo_target'] );
                }
            }
        }
    }

    /**
     * Collects baseline distribution bundle lookups for active extensions.
     */
    public static function get_bundle_candidates( $meta, $component, $locale ) {
        if ( $meta['is_core'] ) {
            return array( trailingslashit( WP_LANG_DIR ) . $meta['po_filename'] );
        }

        return array(
            $meta['base_dir'] . "/languages/{$component}-{$locale}.po",
            $meta['base_dir'] . "/languages/{$locale}.po",
            $meta['base_dir'] . "/language/{$component}-{$locale}.po",
            $meta['base_dir'] . "/language/{$locale}.po",
            $meta['base_dir'] . "/{$component}-{$locale}.po",
            $meta['base_dir'] . "/{$locale}.po",
        );
    }
}