<?php
/**
 * Core On-The-Fly POT Template Generator Engine
 *
 * @package af-translate
 */

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

class AF_Translate_POT_Generator {

    /**
     * Scans a target component directory, extracts all translatable strings,
     * and compiles a valid .pot template file directly into the sandbox space.
     *
     * @param string $component        The plugin or theme text-domain/slug.
     * @param string $type             The component type ('theme' or 'plugin').
     * @param string $destination_path Absolute file path where the POT should be saved.
     * @return bool True on success, false on failure.
     */
    public static function generate_master_pot( $component, $type, $destination_path ) {
        $source_dir = ( 'plugin' === $type ) ? trailingslashit( WP_PLUGIN_DIR ) . $component : trailingslashit( get_theme_root() ) . $component;
        
        if ( ! is_dir( $source_dir ) ) {
            return false;
        }

        $discovered_strings = array();

        try {
            // Standard explicit directory iterator immune to environment-specific engine bugs
            $directory = new RecursiveDirectoryIterator( $source_dir, RecursiveDirectoryIterator::SKIP_DOTS );
            $iterator  = new RecursiveIteratorIterator( $directory );

            // Robust pattern that isolates the first argument of standard WP i18n hooks
            $pattern = '/\b(?:__|_e|esc_html__|esc_html_e|esc_attr__|esc_attr_e)\s*\(\s*(?|\'((?:[^\'\\\\]|\\\\.)*)\'|"((?:[^"\\\\]|\\\\.)*)")/s';

            foreach ( $iterator as $file_info ) {
                // Explicit extension matching safely bypasses RegexIterator environment quirks
                if ( $file_info->isFile() && 'php' === strtolower( $file_info->getExtension() ) ) {
                    $file_path = $file_info->getPathname();
                    
                    // phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents
                    $file_content = file_get_contents( $file_path );
                    if ( empty( $file_content ) ) {
                        continue;
                    }

                    if ( preg_match_all( $pattern, $file_content, $matches ) ) {
                        foreach ( $matches[1] as $raw_string ) {
                            if ( '' !== $raw_string ) {
                                // Strip execution slashes to obtain the clean textual string representation
                                $clean_string = stripcslashes( $raw_string );
                                $discovered_strings[ $clean_string ] = true;
                            }
                        }
                    }
                }
            }
        } catch ( Exception $e ) {
            return false;
        }

        // --- CONSTRUCT GETTEXT POT HEADERS ---
        $pot_content  = "# Copyright (C) " . gmdate( 'Y' ) . " AF Themes\n";
        $pot_content .= "# This file is distributed under the same license as the {$component} package.\n";
        $pot_content .= "msgid \"\"\n";
        $pot_content .= "msgstr \"\"\n";
        $pot_content .= "\"Project-Id-Version: {$component} Templates\\n\"\n";
        $pot_content .= "\"Report-Msgid-Bugs-To: https://wordpress.org/support/\\n\"\n";
        $pot_content .= "\"POT-Creation-Date: " . gmdate( 'Y-m-d H:i:sO' ) . "\\n\"\n";
        $pot_content .= "\"MIME-Version: 1.0\\n\"\n";
        $pot_content .= "\"Content-Type: text/plain; charset=UTF-8\\n\"\n";
        $pot_content .= "\"Content-Transfer-Encoding: 8bit\\n\"\n";
        $pot_content .= "\"X-Generator: AF Translate Run Time Engine\\n\"\n\n";

        // --- POPULATE DATA MAP ENTRIES ---
        if ( ! empty( $discovered_strings ) ) {
            foreach ( array_keys( $discovered_strings ) as $raw_string ) {
                // Format safely for Gettext standards by escaping double quotes and backslashes
                $escaped_string = addcslashes( $raw_string, "\"\\" );
                $pot_content .= "msgid \"{$escaped_string}\"\n";
                $pot_content .= "msgstr \"\"\n\n";
            }
        }

        return false !== file_put_contents( $destination_path, $pot_content );
    }
}