<?php
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class MetaForge_ImportExport {

	public function __construct() {
		add_action( 'admin_menu', array( $this, 'admin_menu' ), 45 );
		add_action( 'admin_init', array( $this, 'process_export' ) );
		add_action( 'admin_init', array( $this, 'process_import' ) );
		add_action( 'admin_init', array( $this, 'process_clear_logs' ) );
		add_action( 'admin_init', array( $this, 'process_direct_migration' ) );
	}

	public function admin_menu() {
		add_submenu_page( 'metaforge', 'Tools', 'Tools', 'manage_metaforge', 'metaforge_tools', array( $this, 'admin_page' ) );
	}

	// ── Helpers ─────────────────────────────────────────────────────────────

	/** Return all published metaforge_group posts as [ post_id => [post, config] ] */
	private function get_all_groups() {
		$posts = get_posts(
			array(
				'post_type'      => 'metaforge_group',
				'posts_per_page' => -1,
				'post_status'    => 'publish',
				'orderby'        => 'menu_order',
				'order'          => 'ASC',
			)
		);

		$groups = array();
		foreach ( $posts as $post ) {
			$config = get_post_meta( $post->ID, '_metaforge_group_config', true );
			if ( is_array( $config ) ) {
				$groups[ $post->ID ] = array(
					'post'   => $post,
					'config' => $config,
				);
			}
		}
		return $groups;
	}

	private function get_all_post_types() {
		return get_option( 'metaforge_post_types', array() );
	}

	private function get_all_taxonomies() {
		return get_option( 'metaforge_taxonomies', array() );
	}

	private function get_all_options_pages() {
		return get_option( 'metaforge_options_pages', array() );
	}

	// ── Export ───────────────────────────────────────────────────────────────

	public function process_export() {
		if ( ! isset( $_GET['metaforge_action'] ) || $_GET['metaforge_action'] !== 'export' ) {
			return;
		}
		if ( ! isset( $_GET['nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_GET['nonce'] ) ), 'metaforge_export_nonce' ) ) {
			wp_die( 'Invalid nonce' );
		}
		if ( ! current_user_can( 'manage_metaforge' ) ) {
			wp_die( 'Insufficient permissions.' );
		}

		// ── Multi-select export via parameters ──
		$ids_raw = isset( $_GET['metaforge_ids'] ) ? sanitize_text_field( wp_unslash( $_GET['metaforge_ids'] ) ) : '';
		$ids     = array_filter( array_map( 'intval', explode( ',', $ids_raw ) ) );

		$pts_raw  = isset( $_GET['metaforge_pts'] ) ? sanitize_text_field( wp_unslash( $_GET['metaforge_pts'] ) ) : '';
		$pt_slugs = array_filter( array_map( 'sanitize_key', explode( ',', $pts_raw ) ) );

		$taxs_raw  = isset( $_GET['metaforge_taxs'] ) ? sanitize_text_field( wp_unslash( $_GET['metaforge_taxs'] ) ) : '';
		$tax_slugs = array_filter( array_map( 'sanitize_key', explode( ',', $taxs_raw ) ) );

		$opts_raw  = isset( $_GET['metaforge_opts'] ) ? sanitize_text_field( wp_unslash( $_GET['metaforge_opts'] ) ) : '';
		$opt_slugs = array_filter( array_map( 'sanitize_key', explode( ',', $opts_raw ) ) );

		if ( ! empty( $ids ) || ! empty( $pt_slugs ) || ! empty( $tax_slugs ) || ! empty( $opt_slugs ) ) {
			$export_data = array(
				'metaforge_version' => METAFORGE_VERSION,
				'exported_at'       => gmdate( 'Y-m-d\TH:i:s\Z' ),
				'export_type'       => 'selective',
			);

			if ( ! empty( $ids ) ) {
				$groups = array();
				foreach ( $ids as $pid ) {
					$post = get_post( $pid );
					if ( ! $post || $post->post_type !== 'metaforge_group' ) {
						continue;
					}
					$c = get_post_meta( $pid, '_metaforge_group_config', true );
					if ( is_array( $c ) ) {
						$groups[] = $c;
					}
				}
				$export_data['metaforge_field_groups'] = $groups;
			}

			if ( ! empty( $pt_slugs ) ) {
				$all_pts = get_option( 'metaforge_post_types', array() );
				$pts     = array();
				foreach ( $all_pts as $pt ) {
					if ( in_array( $pt['slug'] ?? '', $pt_slugs ) ) {
						$pts[] = $pt;
					}
				}
				$export_data['metaforge_post_types'] = $pts;
			}

			if ( ! empty( $tax_slugs ) ) {
				$all_taxs = get_option( 'metaforge_taxonomies', array() );
				$taxs     = array();
				foreach ( $all_taxs as $tax ) {
					if ( in_array( $tax['slug'] ?? '', $tax_slugs ) ) {
						$taxs[] = $tax;
					}
				}
				$export_data['metaforge_taxonomies'] = $taxs;
			}

			if ( ! empty( $opt_slugs ) ) {
				$all_opts = get_option( 'metaforge_options_pages', array() );
				$opts     = array();
				foreach ( $all_opts as $opt ) {
					if ( in_array( $opt['slug'] ?? '', $opt_slugs ) ) {
						$opts[] = $opt;
					}
				}
				$export_data['metaforge_options_pages'] = $opts;
			}

			MetaForge_Logger::log(
				'data_selective_exported',
				array(
					'groups'     => count( $export_data['metaforge_field_groups'] ?? array() ),
					'post_types' => count( $export_data['metaforge_post_types'] ?? array() ),
					'taxonomies' => count( $export_data['metaforge_taxonomies'] ?? array() ),
					'options'    => count( $export_data['metaforge_options_pages'] ?? array() ),
				)
			);

			$this->send_download( $export_data, 'metaforge-selective-export-' . gmdate( 'Y-m-d' ) . '.json' );
			return;
		}

		// ── Full export (all data) ──
		$groups = array();
		foreach ( get_posts(
			array(
				'post_type'      => 'metaforge_group',
				'posts_per_page' => -1,
				'post_status'    => 'publish',
				'orderby'        => 'menu_order',
				'order'          => 'ASC',
			)
		) as $post ) {
			$c = get_post_meta( $post->ID, '_metaforge_group_config', true );
			if ( is_array( $c ) ) {
				$groups[] = $c;
			}
		}

		$this->send_download(
			array(
				'metaforge_version'       => METAFORGE_VERSION,
				'exported_at'             => gmdate( 'Y-m-d\TH:i:s\Z' ),
				'export_type'             => 'full',
				'metaforge_field_groups'  => $groups,
				'metaforge_post_types'    => get_option( 'metaforge_post_types', array() ),
				'metaforge_taxonomies'    => get_option( 'metaforge_taxonomies', array() ),
				'metaforge_options_pages' => get_option( 'metaforge_options_pages', array() ),
			),
			'metaforge-full-export-' . gmdate( 'Y-m-d' ) . '.json'
		);
	}

	private function send_download( $data, $filename ) {
		$json = wp_json_encode( $data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE );
		nocache_headers();
		header( 'Content-Type: application/json; charset=' . get_option( 'blog_charset' ) );
		header( 'Content-Disposition: attachment; filename="' . sanitize_file_name( $filename ) . '"' );
		header( 'Content-Length: ' . strlen( $json ) );
		echo wp_json_encode( $data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE );
		exit;
	}

	// ── Import ───────────────────────────────────────────────────────────────

	public function process_import() {
		if ( ! isset( $_POST['metaforge_action'] ) || $_POST['metaforge_action'] !== 'import' ) {
			return;
		}
		if ( ! isset( $_POST['metaforge_import_nonce_field'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['metaforge_import_nonce_field'] ) ), 'metaforge_import_nonce' ) ) {
			wp_die( 'Invalid nonce' );
		}
		if ( ! current_user_can( 'manage_metaforge' ) ) {
			wp_die( 'Insufficient permissions.' );
		}

		$json = '';
		if ( ! empty( $_FILES['metaforge_import_file']['tmp_name'] ) ) {
            // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- File structure validated via finfo mime check below.
			$f = $_FILES['metaforge_import_file'];
			if ( $f['error'] !== UPLOAD_ERR_OK ) {
				wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=upload_error' ) );
				exit; }
			if ( $f['size'] > 2097152 ) {
				wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=too_large' ) );
				exit; }
			if ( strtolower( pathinfo( $f['name'], PATHINFO_EXTENSION ) ) !== 'json' ) {
				wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=bad_file_type' ) );
				exit; }

			// S-4: Verify the actual MIME type server-side (extension alone is trivially spoofed).
			$detected_mime = '';
			if ( function_exists( 'finfo_file' ) ) {
				$finfo         = finfo_open( FILEINFO_MIME_TYPE );
				$detected_mime = finfo_file( $finfo, $f['tmp_name'] );
				finfo_close( $finfo );
			} elseif ( function_exists( 'mime_content_type' ) ) {
				$detected_mime = mime_content_type( $f['tmp_name'] );
			}
			$allowed_mimes = array( 'application/json', 'text/plain', 'text/json', 'application/octet-stream' );
			if ( $detected_mime && ! in_array( $detected_mime, $allowed_mimes, true ) ) {
				wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=bad_file_type' ) );
				exit;
			}

			global $wp_filesystem;
			if ( empty( $wp_filesystem ) ) {
				require_once ABSPATH . 'wp-admin/includes/file.php';
				WP_Filesystem();
			}
			$json = $wp_filesystem ? $wp_filesystem->get_contents( $f['tmp_name'] ) : false;
		} else {
			$json = sanitize_textarea_field( wp_unslash( $_POST['metaforge_import_json'] ?? '' ) );
			if ( strlen( $json ) > 500000 ) {
				wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=too_large' ) );
				exit; }
		}

		if ( empty( trim( $json ) ) ) {
			wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=empty' ) );
			exit; }

		$data = json_decode( $json, true, 64 );
		if ( json_last_error() !== JSON_ERROR_NONE || ! is_array( $data ) ) {
			wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=invalid_json' ) );
			exit; }

		// Map legacy mfe_ keys to metaforge_ keys
		$legacy_key_map = array(
			'mfe_field_groups'  => 'metaforge_field_groups',
			'mfe_post_types'    => 'metaforge_post_types',
			'mfe_taxonomies'    => 'metaforge_taxonomies',
			'mfe_options_pages' => 'metaforge_options_pages',
		);
		foreach ( $legacy_key_map as $old_key => $new_key ) {
			if ( isset( $data[ $old_key ] ) && ! isset( $data[ $new_key ] ) ) {
				$data[ $new_key ] = $data[ $old_key ];
				unset( $data[ $old_key ] );
			}
		}

		// Check if data is an ACF export format and convert to MFE schema
		if ( ! isset( $data['metaforge_field_groups'] ) && ( isset( $data['key'] ) || ( isset( $data[0] ) && is_array( $data[0] ) && isset( $data[0]['key'] ) ) ) ) {
			$data = self::convert_acf_json_to_mfe( $data );
		}

		// Direct list of groups: [ { "group_name": "..." }, ... ]
		if ( ! isset( $data['metaforge_field_groups'] ) && isset( $data[0] ) && is_array( $data[0] ) && ( isset( $data[0]['group_name'] ) || isset( $data[0]['fields'] ) ) ) {
			$data = array( 'metaforge_field_groups' => $data );
		}

		// Single group object: { "group_name": "...", "fields": [...] }
		if ( ! isset( $data['metaforge_field_groups'] ) && isset( $data['group_name'] ) && isset( $data['fields'] ) ) {
			$data = array( 'metaforge_field_groups' => array( $data ) );
		}

		$data = array_intersect_key( $data, array_flip( array( 'metaforge_field_groups', 'metaforge_post_types', 'metaforge_taxonomies', 'metaforge_options_pages' ) ) );
		if ( empty( $data ) ) {
			wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&metaforge_import=no_valid_data' ) );
			exit; }

		$data = map_deep( $data, 'sanitize_textarea_field' );

		$strategy = sanitize_text_field( wp_unslash( $_POST['metaforge_import_strategy'] ?? 'merge' ) );

		$converted_repeaters = 0;
		$is_pro              = function_exists( 'metaforge_is_pro_active' ) ? metaforge_is_pro_active() : ( defined( 'METAFORGE_PRO_VERSION' ) || apply_filters( 'metaforge_is_pro_active', false ) );

		if ( ! $is_pro && isset( $data['metaforge_field_groups'] ) && is_array( $data['metaforge_field_groups'] ) ) {
			foreach ( $data['metaforge_field_groups'] as &$g ) {
				if ( ! empty( $g['fields'] ) && is_array( $g['fields'] ) ) {
					$converted_repeaters += self::convert_repeaters_to_groups( $g['fields'] );
				}
			}
			unset( $g );
		}

		if ( isset( $data['metaforge_field_groups'] ) && is_array( $data['metaforge_field_groups'] ) ) {
			if ( $strategy === 'replace' ) {
				$valid = array_filter(
					$data['metaforge_field_groups'],
					function ( $g ) {
						return is_array( $g ) && ! empty( $g['group_name'] );
					}
				);
				if ( ! empty( $valid ) ) {
					foreach ( get_posts(
						array(
							'post_type'      => 'metaforge_group',
							'posts_per_page' => -1,
						)
					) as $p ) {
						wp_delete_post( $p->ID, true );
					}
				}
				$data['metaforge_field_groups'] = array_values( $valid );
			}
			foreach ( $data['metaforge_field_groups'] as $i => $group ) {
				if ( ! is_array( $group ) || empty( $group['group_name'] ) ) {
					continue;
				}
				$sanitized_group = MetaForge_Loader::sanitize_group_config( $group );
				if ( ! $sanitized_group ) {
					continue;
				}
				$title = $sanitized_group['group_name'];

				$existing_id = null;
				if ( $strategy !== 'replace' ) {
					$existing = get_posts(
						array(
							'post_type'   => 'metaforge_group',
							'title'       => $title,
							'post_status' => 'publish',
							'numberposts' => 1,
						)
					);
					if ( ! empty( $existing ) ) {
						$existing_id = $existing[0]->ID;
					}
				}

				if ( $existing_id ) {
					update_post_meta( $existing_id, '_metaforge_group_config', $sanitized_group );
				} else {
					$pid = wp_insert_post(
						array(
							'post_title'  => $title,
							'post_type'   => 'metaforge_group',
							'post_status' => 'publish',
							'menu_order'  => $i,
						)
					);
					if ( $pid && ! is_wp_error( $pid ) ) {
						update_post_meta( $pid, '_metaforge_group_config', $sanitized_group );
					}
				}
			}
			MetaForge_Loader::clear_cache();
		}

		if ( isset( $data['metaforge_post_types'] ) && is_array( $data['metaforge_post_types'] ) ) {
			$sanitized_pts = array();
			foreach ( $data['metaforge_post_types'] as $pt ) {
				$s_pt = MetaForge_Loader::sanitize_post_type_config( $pt );
				if ( $s_pt && ! empty( $s_pt['slug'] ) ) {
					$sanitized_pts[] = $s_pt;
				}
			}
			if ( $strategy === 'replace' ) {
				update_option( 'metaforge_post_types', $sanitized_pts );
			} else {
				$e = get_option( 'metaforge_post_types', array() );
				$s = array_column( $e, 'slug' );
				foreach ( $sanitized_pts as $pt ) {
					if ( ! in_array( $pt['slug'], $s, true ) ) {
						$e[] = $pt;
					}
				}
				update_option( 'metaforge_post_types', $e );
			}
		}

		if ( isset( $data['metaforge_taxonomies'] ) && is_array( $data['metaforge_taxonomies'] ) ) {
			$sanitized_taxs = array();
			foreach ( $data['metaforge_taxonomies'] as $tax ) {
				$s_tax = MetaForge_Loader::sanitize_taxonomy_config( $tax );
				if ( $s_tax && ! empty( $s_tax['slug'] ) ) {
					$sanitized_taxs[] = $s_tax;
				}
			}
			if ( $strategy === 'replace' ) {
				update_option( 'metaforge_taxonomies', $sanitized_taxs );
			} else {
				$e = get_option( 'metaforge_taxonomies', array() );
				$s = array_column( $e, 'slug' );
				foreach ( $sanitized_taxs as $tax ) {
					if ( ! in_array( $tax['slug'], $s, true ) ) {
						$e[] = $tax;
					}
				}
				update_option( 'metaforge_taxonomies', $e );
			}
		}

		if ( isset( $data['metaforge_options_pages'] ) && is_array( $data['metaforge_options_pages'] ) ) {
			$sanitized_opts = array();
			foreach ( $data['metaforge_options_pages'] as $op ) {
				$s_op = MetaForge_Loader::sanitize_options_page_config( $op );
				if ( $s_op && ! empty( $s_op['slug'] ) ) {
					$sanitized_opts[] = $s_op;
				}
			}
			if ( $strategy === 'replace' ) {
				update_option( 'metaforge_options_pages', $sanitized_opts );
			} else {
				$e = get_option( 'metaforge_options_pages', array() );
				$s = array_column( $e, 'slug' );
				foreach ( $sanitized_opts as $op ) {
					if ( ! in_array( $op['slug'], $s, true ) ) {
						$e[] = $op;
					}
				}
				update_option( 'metaforge_options_pages', $e );
			}
		}

		MetaForge_Logger::log(
			'data_imported',
			array(
				'strategy'            => $strategy,
				'groups'              => count( $data['metaforge_field_groups'] ?? array() ),
				'post_types'          => count( $data['metaforge_post_types'] ?? array() ),
				'taxonomies'          => count( $data['metaforge_taxonomies'] ?? array() ),
				'options'             => count( $data['metaforge_options_pages'] ?? array() ),
				'converted_repeaters' => $converted_repeaters,
			)
		);
		flush_rewrite_rules();
		$redirect_url = admin_url( 'admin.php?page=metaforge_tools&metaforge_import=success' );
		if ( $converted_repeaters > 0 ) {
			$redirect_url = add_query_arg( 'converted_repeaters', $converted_repeaters, $redirect_url );
		}
		wp_safe_redirect( $redirect_url );
		exit;
	}

	public function process_clear_logs() {
		if ( ! isset( $_POST['metaforge_action'] ) || $_POST['metaforge_action'] !== 'clear_logs' ) {
			return;
		}
		if ( ! isset( $_POST['metaforge_clear_logs_nonce_field'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['metaforge_clear_logs_nonce_field'] ) ), 'metaforge_clear_logs_nonce' ) ) {
			wp_die( 'Security check failed.' );
		}
		if ( ! current_user_can( 'manage_metaforge' ) ) {
			wp_die( 'Insufficient permissions.' );
		}

		MetaForge_Logger::clear_logs();
		wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&tab=logs&metaforge_logs_cleared=1' ) );
		exit;
	}

	public function process_direct_migration() {
		if ( ! isset( $_POST['metaforge_action'] ) || $_POST['metaforge_action'] !== 'direct_acf_migrate' ) {
			return;
		}
		if ( ! isset( $_POST['metaforge_migrate_nonce_field'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['metaforge_migrate_nonce_field'] ) ), 'metaforge_migrate_acf_nonce' ) ) {
			wp_die( 'Security check failed.' );
		}
		if ( ! current_user_can( 'manage_metaforge' ) ) {
			wp_die( 'Insufficient permissions.' );
		}

		$acf_posts = get_posts(
			array(
				'post_type'      => 'acf-field-group',
				'posts_per_page' => -1,
				'post_status'    => 'any',
			)
		);

		$migrated_count = 0;
		foreach ( $acf_posts as $post ) {
			$raw_fields      = array();
			$sub_field_posts = get_posts(
				array(
					'post_type'      => 'acf-field',
					'post_parent'    => $post->ID,
					'posts_per_page' => -1,
					'orderby'        => 'menu_order',
					'order'          => 'ASC',
				)
			);

			foreach ( $sub_field_posts as $sfp ) {
				$field_data = maybe_unserialize( $sfp->post_content );
				if ( is_array( $field_data ) ) {
					$raw_fields[] = $field_data;
				}
			}

			$acf_group_data = array(
				'title'    => $post->post_title,
				'key'      => $post->post_name ?: ( 'group_' . substr( md5( $post->post_title ), 0, 12 ) ),
				'fields'   => $raw_fields,
				'location' => maybe_unserialize( get_post_meta( $post->ID, 'rule', true ) ?: array() ),
			);

			$converted = self::convert_acf_json_to_mfe( array( $acf_group_data ) );
			if ( ! empty( $converted['metaforge_field_groups'] ) ) {
				foreach ( $converted['metaforge_field_groups'] as $cfg ) {
					$sanitized = MetaForge_Loader::sanitize_group_config( $cfg );
					if ( $sanitized ) {
						$new_id = wp_insert_post(
							array(
								'post_title'  => $sanitized['group_name'],
								'post_type'   => 'metaforge_group',
								'post_status' => 'publish',
							)
						);
						if ( $new_id && ! is_wp_error( $new_id ) ) {
							update_post_meta( $new_id, '_metaforge_group_config', $sanitized );
							++$migrated_count;
						}
					}
				}
			}
		}

		MetaForge_Loader::clear_cache();
		MetaForge_Logger::log( 'acf_migration_completed', array( 'migrated_count' => $migrated_count ) );

		wp_safe_redirect( admin_url( 'admin.php?page=metaforge_tools&tab=migrate&metaforge_migrated=' . $migrated_count ) );
		exit;
	}

	// ── Admin Page ────────────────────────────────────────────────────────────

	public function admin_page() {
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only UI navigation parameter.
		$active_tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'import_export';
		$all_groups = $this->get_all_groups();
		$all_pts    = $this->get_all_post_types();
		$all_taxs   = $this->get_all_taxonomies();
		$all_opts   = $this->get_all_options_pages();

		$full_url    = wp_nonce_url( admin_url( 'admin.php?page=metaforge_tools&metaforge_action=export' ), 'metaforge_export_nonce', 'nonce' );
		$base_export = wp_nonce_url( admin_url( 'admin.php?page=metaforge_tools&metaforge_action=export' ), 'metaforge_export_nonce', 'nonce' );
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only notice query parameter.
		$status = isset( $_GET['metaforge_import'] ) ? sanitize_key( wp_unslash( $_GET['metaforge_import'] ) ) : '';
		?>
		<div class="wrap mfe-wrap">
			<?php MetaForge_AdminHeader::render_top_bar( 'tools' ); ?>
			<?php MetaForge_AdminHeader::render_sub_header( 'Tools & Sync' ); ?>

			<!-- TAB NAVIGATION -->
			<nav class="nav-tab-wrapper mfe-tools-nav">
				<a href="?page=metaforge_tools&tab=import_export" class="nav-tab <?php echo $active_tab === 'import_export' ? 'nav-tab-active' : ''; ?>">
					<span class="dashicons dashicons-database"></span> Import &amp; Export
				</a>
				<a href="?page=metaforge_tools&tab=migrate" class="nav-tab <?php echo $active_tab === 'migrate' ? 'nav-tab-active' : ''; ?>">
					<span class="dashicons dashicons-randomize"></span> Switch to MetaForge
				</a>
				<a href="?page=metaforge_tools&tab=logs" class="nav-tab <?php echo $active_tab === 'logs' ? 'nav-tab-active' : ''; ?>">
					<span class="dashicons dashicons-visibility"></span> System Logs &amp; Audit
				</a>
			</nav>

			<?php if ( $active_tab === 'logs' ) : ?>
				<?php $this->render_logs_tab(); ?>
			<?php elseif ( $active_tab === 'migrate' ) : ?>
				<?php $this->render_migrate_tab(); ?>
			<?php else : ?>
			<div class="mfe-tools-content-wrap">
				<?php
				if ( $status === 'invalid_json' ) :
					?>
					<div class="mfe-notice-error"><p><strong>Error:</strong> Invalid JSON format.</p></div>
					<?php
				elseif ( $status === 'too_large' ) :
					?>
					<div class="mfe-notice-error"><p><strong>Error:</strong> File too large (max 2 MB upload / 500 KB paste).</p></div>
					<?php
				elseif ( $status === 'bad_file_type' ) :
					?>
					<div class="mfe-notice-error"><p><strong>Error:</strong> Only <code>.json</code> files accepted.</p></div>
					<?php
				elseif ( $status === 'upload_error' ) :
					?>
					<div class="mfe-notice-error"><p><strong>Error:</strong> Upload failed. Check PHP <code>upload_max_filesize</code>.</p></div>
					<?php
				elseif ( $status === 'empty' ) :
					?>
					<div class="mfe-notice-warning"><p><strong>Notice:</strong> No data provided.</p></div>
					<?php
				elseif ( $status === 'no_valid_data' ) :
					?>
					<div class="mfe-notice-warning"><p><strong>Notice:</strong> No recognised MetaForge data keys found.</p></div>
				<?php elseif ( $status === 'success' ) : ?>
					<?php
                    // phpcs:ignore WordPress.Security.NonceVerification.Recommended
					$conv_count = isset( $_GET['converted_repeaters'] ) ? absint( $_GET['converted_repeaters'] ) : 0;
					?>
					<div class="mfe-notice-success"><p><strong>Success:</strong> Data imported successfully.
					<?php
					if ( $conv_count > 0 ) :
						?>
						Note: <?php echo esc_html( $conv_count ); ?> Repeater <?php echo $conv_count === 1 ? 'field was' : 'fields were'; ?> automatically converted to Group because MetaForge Pro is deactivated.<?php endif; ?></p></div>
				<?php endif; ?>

				<div class="mfe-tools-grid">

				<!-- ── EXPORT ─────────────────────────────────────────────── -->
				<div class="mfe-card mfe-card-zero-margin">
					<div class="mfe-card-header mfe-card-header-static">
						<div class="mfe-card-header-left">
							<span class="dashicons dashicons-download"></span>
							Export Data
						</div>
					</div>
					<div class="mfe-card-body mfe-card-body-padded">

						<!-- Full export row -->
						<div class="mfe-export-full-row">
							<div>
								<p class="mfe-export-full-title">Full Export</p>
								<p class="mfe-export-full-desc">All field groups, post types, taxonomies &amp; options pages</p>
							</div>
							<a href="<?php echo esc_url( $full_url ); ?>" class="mfe-btn-primary mfe-export-btn-full">
								<span class="dashicons dashicons-download"></span>
								Export All
							</a>
						</div>

						<!-- Selective export checklist layout -->
						<div class="mfe-export-accordion">
							
							<!-- 1. Field Groups Collapsible Section -->
							<div class="mfe-export-section">
								<div class="mfe-export-section-toggle">
									<span class="mfe-export-section-title">
										<span class="dashicons dashicons-arrow-right-alt2 mfe-section-arrow"></span>
										<span class="dashicons dashicons-list-view"></span>
										Field Groups
									</span>
									<div class="mfe-export-section-actions" onclick="event.stopPropagation();">
										<span class="mfe-section-badge mfe-badge-groups mfe-export-badge">0 selected</span>
										<input type="checkbox" class="mfe-select-all-groups mfe-export-check-all">
									</div>
								</div>
								<div class="mfe-export-section-content">
									<?php if ( ! empty( $all_groups ) ) : ?>
										<?php
										foreach ( $all_groups as $pid => $item ) :
											$config      = $item['config'];
											$group_name  = esc_html( $config['group_name'] ?? 'Unnamed Group' );
											$field_count = count( $config['fields'] ?? array() );
											$post_type   = esc_html( $config['post_type'] ?? '' );
											?>
										<label class="mfe-export-check-row">
											<input type="checkbox" class="mfe-group-checkbox mfe-export-check-input" value="<?php echo esc_attr( $pid ); ?>">
											<div class="mfe-export-check-info">
												<span class="mfe-export-check-title">
													<?php echo esc_html( $group_name ); ?>
												</span>
												<span class="mfe-export-check-meta">
													<?php echo absint( $field_count ); ?> field<?php echo $field_count !== 1 ? 's' : ''; ?>
													<?php
													if ( $post_type ) :
														?>
														&nbsp;·&nbsp;<?php echo esc_html( $post_type ); ?><?php endif; ?>
												</span>
											</div>
											<span class="mfe-check-badge mfe-export-check-badge">Selected</span>
										</label>
										<?php endforeach; ?>
									<?php else : ?>
										<p class="mfe-export-empty-note">No field groups found.</p>
									<?php endif; ?>
								</div>
							</div>

							<!-- 2. Post Types Collapsible Section -->
							<div class="mfe-export-section">
								<div class="mfe-export-section-toggle">
									<span class="mfe-export-section-title">
										<span class="dashicons dashicons-arrow-right-alt2 mfe-section-arrow"></span>
										<span class="dashicons dashicons-admin-post"></span>
										Post Types
									</span>
									<div class="mfe-export-section-actions" onclick="event.stopPropagation();">
										<span class="mfe-section-badge mfe-badge-pts mfe-export-badge">0 selected</span>
										<input type="checkbox" class="mfe-select-all-pts mfe-export-check-all">
									</div>
								</div>
								<div class="mfe-export-section-content">
									<?php if ( ! empty( $all_pts ) ) : ?>
										<?php
										foreach ( $all_pts as $pt ) :
											$singular_name = esc_html( $pt['singular_label'] ?? 'Post Type' );
											$plural_name   = esc_html( $pt['plural_label'] ?? $singular_name . 's' );
											$slug          = esc_html( $pt['slug'] ?? '' );
											?>
										<label class="mfe-export-check-row">
											<input type="checkbox" class="mfe-pt-checkbox mfe-export-check-input" value="<?php echo esc_attr( $slug ); ?>">
											<div class="mfe-export-check-info">
												<span class="mfe-export-check-title">
													<?php echo esc_html( $plural_name ); ?>
												</span>
												<span class="mfe-export-check-meta">
													Slug: <?php echo esc_html( $slug ); ?>
												</span>
											</div>
											<span class="mfe-check-badge mfe-export-check-badge">Selected</span>
										</label>
										<?php endforeach; ?>
									<?php else : ?>
										<p class="mfe-export-empty-note">No custom post types found.</p>
									<?php endif; ?>
								</div>
							</div>

							<!-- 3. Taxonomies Collapsible Section -->
							<div class="mfe-export-section">
								<div class="mfe-export-section-toggle">
									<span class="mfe-export-section-title">
										<span class="dashicons dashicons-arrow-right-alt2 mfe-section-arrow"></span>
										<span class="dashicons dashicons-category"></span>
										Taxonomies
									</span>
									<div class="mfe-export-section-actions" onclick="event.stopPropagation();">
										<span class="mfe-section-badge mfe-badge-taxs mfe-export-badge">0 selected</span>
										<input type="checkbox" class="mfe-select-all-taxs mfe-export-check-all">
									</div>
								</div>
								<div class="mfe-export-section-content">
									<?php if ( ! empty( $all_taxs ) ) : ?>
										<?php
										foreach ( $all_taxs as $tax ) :
											$singular_name = esc_html( $tax['singular_label'] ?? 'Taxonomy' );
											$plural_name   = esc_html( $tax['plural_label'] ?? $singular_name . 's' );
											$slug          = esc_html( $tax['slug'] ?? '' );
											$post_types    = implode( ', ', array_map( 'esc_html', (array) ( $tax['post_types'] ?? array() ) ) );
											?>
										<label class="mfe-export-check-row">
											<input type="checkbox" class="mfe-tax-checkbox mfe-export-check-input" value="<?php echo esc_attr( $slug ); ?>">
											<div class="mfe-export-check-info">
												<span class="mfe-export-check-title">
													<?php echo esc_html( $plural_name ); ?>
												</span>
												<span class="mfe-export-check-meta">
													Slug: <?php echo esc_html( $slug ); ?>
													<?php
													if ( $post_types ) :
														?>
														&middot; <?php echo esc_html( $post_types ); ?><?php endif; ?>
												</span>
											</div>
											<span class="mfe-check-badge mfe-export-check-badge">Selected</span>
										</label>
										<?php endforeach; ?>
									<?php else : ?>
										<p class="mfe-export-empty-note">No custom taxonomies found.</p>
									<?php endif; ?>
								</div>
							</div>

							<!-- 4. Options Pages Collapsible Section -->
							<div class="mfe-export-section">
								<div class="mfe-export-section-toggle">
									<span class="mfe-export-section-title">
										<span class="dashicons dashicons-arrow-right-alt2 mfe-section-arrow"></span>
										<span class="dashicons dashicons-admin-generic"></span>
										Options Pages
									</span>
									<div class="mfe-export-section-actions" onclick="event.stopPropagation();">
										<span class="mfe-section-badge mfe-badge-opts mfe-export-badge">0 selected</span>
										<input type="checkbox" class="mfe-select-all-opts mfe-export-check-all">
									</div>
								</div>
								<div class="mfe-export-section-content">
									<?php if ( ! empty( $all_opts ) ) : ?>
										<?php
										foreach ( $all_opts as $opt ) :
											$title = esc_html( $opt['title'] ?? 'Options Page' );
											$slug  = esc_html( $opt['slug'] ?? '' );
											?>
										<label class="mfe-export-check-row">
											<input type="checkbox" class="mfe-opt-checkbox mfe-export-check-input" value="<?php echo esc_attr( $slug ); ?>">
											<div class="mfe-export-check-info">
												<span class="mfe-export-check-title">
													<?php echo esc_html( $title ); ?>
												</span>
												<span class="mfe-export-check-meta">
													Slug: <?php echo esc_html( $slug ); ?>
												</span>
											</div>
											<span class="mfe-check-badge mfe-export-check-badge">Selected</span>
										</label>
										<?php endforeach; ?>
									<?php else : ?>
										<p class="mfe-export-empty-note">No options pages found.</p>
									<?php endif; ?>
								</div>
							</div>

							<!-- Export selected footer -->
							<div class="mfe-export-footer-bar">
								<span id="mfe-selected-count" class="mfe-export-counter">0 selected</span>
								<button type="button" id="mfe-export-selected-btn"
									class="mfe-btn-primary mfe-export-btn-disabled"
									disabled
									data-base-url="<?php echo esc_attr( $base_export ); ?>">
									<span class="dashicons dashicons-download"></span>
									Export Selected
								</button>
							</div>

						</div>

					</div>
				</div>

				<!-- ── IMPORT ─────────────────────────────────────────────── -->
				<div class="mfe-card mfe-card-zero-margin">
					<div class="mfe-card-header mfe-card-header-static">
						<div class="mfe-card-header-left">
							<span class="dashicons dashicons-upload"></span>
							Import Data
						</div>
					</div>
					<div class="mfe-card-body mfe-card-body-padded">
						<form method="post" enctype="multipart/form-data">
							<?php wp_nonce_field( 'metaforge_import_nonce', 'metaforge_import_nonce_field' ); ?>
							<input type="hidden" name="metaforge_action" value="import">

							<div class="mfe-mb-20">
								<label class="mfe-import-label">
									Upload JSON File <span class="mfe-import-max-note">(max 2 MB)</span>
								</label>
								<div class="mfe-import-dropzone-inner" id="mfe-drop-zone">
									<span class="dashicons dashicons-upload"></span>
									<p>Drag &amp; drop or</p>
									<input type="file" name="metaforge_import_file" id="metaforge_import_file" accept=".json" class="mfe-import-file-input">
									<label for="metaforge_import_file" class="mfe-btn-secondary mfe-import-choose-btn">Choose File</label>
									<p id="mfe-file-name" class="mfe-import-filename-preview"></p>
								</div>
								<?php if ( function_exists( 'metaforge_is_pro_active' ) && ! metaforge_is_pro_active() ) : ?>
									<div class="mfe-pro-field-warning mfe-mt-10">
										<span class="dashicons dashicons-warning"></span>
										<span><strong>MetaForge Pro is deactivated.</strong> Existing layout and sub-fields are preserved. Any Repeater fields in imported JSON will automatically be converted to Group fields.</span>
									</div>
								<?php endif; ?>
							</div>

							<details class="mfe-import-details">
								<summary class="mfe-import-summary">Or paste JSON directly</summary>
								<textarea name="metaforge_import_json" rows="7"
									class="mfe-json-textarea"
									placeholder='{"metaforge_field_groups":[]}'></textarea>
								<?php if ( function_exists( 'metaforge_is_pro_active' ) && ! metaforge_is_pro_active() ) : ?>
									<div class="mfe-pro-field-warning mfe-mt-10">
										<span class="dashicons dashicons-warning"></span>
										<span><strong>MetaForge Pro is deactivated.</strong> Existing layout and sub-fields are preserved. Any Repeater fields in imported JSON will automatically be converted to Group fields.</span>
									</div>
								<?php endif; ?>
							</details>

							<div class="mfe-import-strategy-box">
								<p class="mfe-import-strategy-title">Import Strategy</p>
								<label class="mfe-import-radio-row">
									<input type="radio" name="metaforge_import_strategy" value="merge" checked>
									<span><strong>Merge</strong><span class="mfe-import-radio-sub">Append new, keep existing.</span></span>
								</label>
								<label class="mfe-import-radio-row">
									<input type="radio" name="metaforge_import_strategy" value="replace">
									<span><strong class="mfe-import-danger-text">Replace</strong><span class="mfe-import-radio-sub">Delete existing, then import. Cannot be undone.</span></span>
								</label>
							</div>

							<div class="mfe-import-actions-row">
								<button type="submit" class="mfe-btn-primary mfe-import-submit-btn">
									<span class="dashicons dashicons-upload"></span>
									Import
								</button>
							</div>
						</form>
					</div>
				</div>

				</div><!-- /.mfe-tools-grid -->
			</div><!-- /.mfe-tools-content-wrap -->
			<?php endif; ?>
			<?php MetaForge_AdminHeader::render_footer(); ?>
		</div><!-- /.wrap -->
		<?php
	}

	/**
	 * Render System Logs & Audit Tab
	 */
	private function render_logs_tab() {
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only log filter.
		$filter   = isset( $_GET['event_filter'] ) ? sanitize_text_field( wp_unslash( $_GET['event_filter'] ) ) : '';
		$logs     = MetaForge_Logger::get_logs( 150, $filter );
		$raw_logs = MetaForge_Logger::get_raw_log_string();
		?>
		<div class="mfe-tools-content-wrap">
			<?php
            // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only notice query flag.
			if ( isset( $_GET['metaforge_logs_cleared'] ) ) :
				?>
				<div class="mfe-notice-success"><p><strong>Success:</strong> System audit logs cleared successfully.</p></div>
			<?php endif; ?>

			<div class="mfe-card mfe-card-zero-margin">
			<div class="mfe-card-header mfe-card-header-flex">
				<div class="mfe-card-header-left">
					<span class="dashicons dashicons-visibility"></span>
					<strong>System Logs &amp; Audit Trail</strong>
				</div>
				<div class="mfe-card-header-actions">
					<form method="get" class="mfe-header-form">
						<input type="hidden" name="page" value="metaforge_tools">
						<input type="hidden" name="tab" value="logs">
						<select name="event_filter" onchange="this.form.submit();" class="mfe-log-select">
							<option value="" <?php selected( $filter, '' ); ?>>-- All Events --</option>
							<option value="field_group" <?php selected( $filter, 'field_group' ); ?>>Field Groups</option>
							<option value="ai" <?php selected( $filter, 'ai' ); ?>>AI Prompts &amp; Generation</option>
							<option value="migration" <?php selected( $filter, 'migration' ); ?>>Migrations &amp; Imports</option>
							<option value="error" <?php selected( $filter, 'error' ); ?>>Errors</option>
						</select>
					</form>
					<button type="button" class="mfe-btn-secondary mfe-btn-sm" onclick="navigator.clipboard.writeText(document.getElementById('mfe-raw-logs-data').value); if (typeof mfeAlert === 'function') { mfeAlert('Logs copied to clipboard!', 'Audit Logs', 'success'); } else { alert('Logs copied to clipboard!'); }">
						<span class="dashicons dashicons-clipboard"></span> Copy Logs
					</button>
					<form method="post" class="mfe-header-form" onsubmit="event.preventDefault(); var f = this; if (typeof mfeSafeConfirm === 'function') { mfeSafeConfirm('Clear Audit Logs', 'Are you sure you want to clear all audit logs?', 'Clear Logs', function() { f.submit(); }); } else if (confirm('Are you sure you want to clear all audit logs?')) { f.submit(); }">
						<?php wp_nonce_field( 'metaforge_clear_logs_nonce', 'metaforge_clear_logs_nonce_field' ); ?>
						<input type="hidden" name="metaforge_action" value="clear_logs">
						<button type="submit" class="mfe-btn-secondary mfe-btn-danger-sm">
							<span class="dashicons dashicons-trash"></span> Clear Logs
						</button>
					</form>
				</div>
			</div>
			<div class="mfe-card-body mfe-p-0">
				<textarea id="mfe-raw-logs-data" class="mfe-hidden"><?php echo esc_textarea( $raw_logs ); ?></textarea>
				<?php if ( empty( $logs ) ) : ?>
					<p class="mfe-export-empty-note">No audit log records found.</p>
				<?php else : ?>
					<table class="wp-list-table widefat fixed striped mfe-table-borderless">
						<thead>
							<tr>
								<th class="mfe-col-time">Timestamp</th>
								<th class="mfe-col-event">Event</th>
								<th class="mfe-col-user">User</th>
								<th>Context Data</th>
							</tr>
						</thead>
						<tbody>
							<?php foreach ( $logs as $l ) : ?>
								<tr>
									<td class="mfe-log-time"><?php echo esc_html( $l['time'] ?? 'N/A' ); ?></td>
									<td>
										<span class="mfe-log-badge">
											<?php echo esc_html( strtoupper( $l['event'] ?? 'INFO' ) ); ?>
										</span>
									</td>
									<td class="mfe-log-user"><?php echo esc_html( $l['user'] ?? 'system' ); ?></td>
									<td class="mfe-log-context">
										<?php
										if ( ! empty( $l['ctx'] ) && is_array( $l['ctx'] ) ) {
											echo esc_html( wp_json_encode( $l['ctx'] ) );
										} else {
											echo '<span class="mfe-text-muted">None</span>';
										}
										?>
									</td>
								</tr>
							<?php endforeach; ?>
						</tbody>
					</table>
				<?php endif; ?>
			</div>
		</div>
		</div><!-- /.mfe-tools-content-wrap -->
		<?php
	}

	/**
	 * Render Switch to MetaForge (ACF Importer) Tab
	 */
	private function render_migrate_tab() {
        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Read-only notice query flag.
		$migrated_status = isset( $_GET['metaforge_migrated'] ) ? intval( wp_unslash( $_GET['metaforge_migrated'] ) ) : null;

		$acf_posts = get_posts(
			array(
				'post_type'      => 'acf-field-group',
				'posts_per_page' => -1,
				'post_status'    => 'any',
			)
		);
		?>
		<div class="mfe-tools-content-wrap">
			<?php if ( $migrated_status !== null ) : ?>
				<div class="mfe-notice-success">
					<p><strong>Migration Complete:</strong> Successfully migrated <?php echo esc_html( $migrated_status ); ?> field group(s) into native MetaForge Engine field groups! Your existing MetaForge field groups and data are 100% preserved.</p>
				</div>
			<?php endif; ?>

			<div class="mfe-card mfe-card-zero-margin">
				<div class="mfe-card-header mfe-card-header-static">
					<div class="mfe-card-header-left">
						<span class="dashicons dashicons-randomize"></span>
						<strong>Switch to MetaForge: Direct Field Group Migration</strong>
					</div>
				</div>
				<div class="mfe-card-body mfe-card-body-padded">
					<div class="mfe-migrate-banner">
						<span class="dashicons dashicons-shield-alt mfe-migrate-banner-icon"></span>
						<div>
							<h4 class="mfe-migrate-banner-title">Zero Lock-In &amp; Non-Destructive Migration</h4>
							<p class="mfe-migrate-banner-desc">
								This tool scans your database for external ACF (Advanced Custom Fields) field groups and converts them into native <strong>MetaForge Engine (MFE)</strong> field groups in 1 click.
								Your existing MetaForge field groups and database values will NOT be deleted or overwritten.
							</p>
						</div>
					</div>

					<div class="mfe-migrate-box">
						<h3 class="mfe-migrate-box-title">Detected External Field Groups</h3>
						<?php if ( empty( $acf_posts ) ) : ?>
							<p class="mfe-migrate-box-note">No external ACF field groups were detected in your database. You can build field groups natively in MetaForge Engine or import schemas via the Import &amp; Export tab.</p>
						<?php else : ?>
							<p class="mfe-migrate-box-found">Found <strong><?php echo count( $acf_posts ); ?></strong> external field group(s) ready for instant conversion:</p>
							<ul class="mfe-migrate-list">
								<?php foreach ( $acf_posts as $ap ) : ?>
									<li class="mfe-migrate-item">
										<strong><?php echo esc_html( $ap->post_title ?: 'Untitled Group' ); ?></strong> 
										<span class="mfe-migrate-id">(ID: #<?php echo absint( $ap->ID ); ?>)</span>
									</li>
								<?php endforeach; ?>
							</ul>
							<form method="post" onsubmit="event.preventDefault(); var f = this; if (typeof mfeSafeConfirm === 'function') { mfeSafeConfirm('Convert ACF Field Groups', 'Convert all detected ACF field groups to native MetaForge field groups?', 'Convert Now', function() { f.submit(); }); } else if (confirm('Convert all detected ACF field groups to native MetaForge field groups?')) { f.submit(); }">
								<?php wp_nonce_field( 'metaforge_migrate_acf_nonce', 'metaforge_migrate_nonce_field' ); ?>
								<input type="hidden" name="metaforge_action" value="direct_acf_migrate">
								<button type="submit" class="mfe-btn-primary mfe-btn-migrate">
									<span class="dashicons dashicons-randomize"></span> Convert to MetaForge Field Groups Now
								</button>
							</form>
						<?php endif; ?>
					</div>
				</div>
			</div>
		</div><!-- /.mfe-tools-content-wrap -->
		<?php
	}

	/**
	 * Recursively convert repeater fields to group fields when MetaForge Pro is not active.
	 */
	public static function convert_repeaters_to_groups( &$fields ) {
		if ( ! is_array( $fields ) ) {
			return 0;
		}

		$converted = 0;
		foreach ( $fields as &$field ) {
			if ( ! is_array( $field ) ) {
				continue;
			}

			if ( isset( $field['type'] ) && $field['type'] === 'repeater' ) {
				$field['type'] = 'group';
				++$converted;
			}

			if ( ! empty( $field['sub_fields'] ) && is_array( $field['sub_fields'] ) ) {
				$converted += self::convert_repeaters_to_groups( $field['sub_fields'] );
			}

			if ( ! empty( $field['layouts'] ) && is_array( $field['layouts'] ) ) {
				foreach ( $field['layouts'] as &$layout ) {
					if ( ! empty( $layout['sub_fields'] ) && is_array( $layout['sub_fields'] ) ) {
						$converted += self::convert_repeaters_to_groups( $layout['sub_fields'] );
					}
				}
				unset( $layout );
			}
		}
		unset( $field );

		return $converted;
	}

	/**
	 * Convert ACF (Advanced Custom Fields) export JSON into MetaForge Engine schema.
	 */
	public static function convert_acf_json_to_mfe( $raw_data ) {
		if ( ! is_array( $raw_data ) ) {
			return array();
		}

		if ( isset( $raw_data['key'] ) && isset( $raw_data['title'] ) ) {
			$raw_data = array( $raw_data );
		}

		// Pre-scan all ACF fields across all groups to map ACF field keys (field_xyz) to field names (slugs)
		$key_to_name_map = array();
		foreach ( $raw_data as $acf_group ) {
			if ( is_array( $acf_group ) && ! empty( $acf_group['fields'] ) && is_array( $acf_group['fields'] ) ) {
				self::collect_acf_field_keys( $acf_group['fields'], $key_to_name_map );
			}
		}

		$metaforge_groups = array();
		foreach ( $raw_data as $acf_group ) {
			if ( ! is_array( $acf_group ) || empty( $acf_group['title'] ) ) {
				continue;
			}

			$group_name = $acf_group['title'];
			$group_key  = $acf_group['key'] ?? ( 'group_' . substr( md5( $group_name ), 0, 12 ) );

			$fields = array();
			if ( ! empty( $acf_group['fields'] ) && is_array( $acf_group['fields'] ) ) {
				$fields = self::convert_acf_fields_to_mfe( $acf_group['fields'], $key_to_name_map );
			}

			$location_rules = array();
			if ( ! empty( $acf_group['location'] ) && is_array( $acf_group['location'] ) ) {
				foreach ( $acf_group['location'] as $rule_group ) {
					$metaforge_rule_group = array();
					foreach ( $rule_group as $rule ) {
						$param                  = $rule['param'] ?? 'post_type';
						$metaforge_rule_group[] = array(
							'param'    => $param,
							'operator' => $rule['operator'] ?? '==',
							'value'    => $rule['value'] ?? '',
						);
					}
					$location_rules[] = $metaforge_rule_group;
				}
			}

			$primary_pt = 'post';
			foreach ( $location_rules as $rg ) {
				foreach ( $rg as $r ) {
					$param = $r['param'] ?? '';
					$val   = $r['value'] ?? '';
					if ( $param === 'post_type' && ! empty( $val ) ) {
						$primary_pt = $val;
						break 2;
					} elseif ( in_array( $param, array( 'page_template', 'page_type', 'page_parent', 'page' ), true ) ) {
						$primary_pt = 'page';
					}
				}
			}

			$metaforge_groups[] = array(
				'group_name'     => $group_name,
				'group_key'      => $group_key,
				'post_type'      => $primary_pt,
				'fields'         => $fields,
				'location_rules' => $location_rules,
			);
		}

		return array( 'metaforge_field_groups' => $metaforge_groups );
	}

	/**
	 * Recursively collect ACF field key => field name mappings for conditional logic resolution.
	 */
	private static function collect_acf_field_keys( array $fields, array &$map ) {
		foreach ( $fields as $f ) {
			if ( ! is_array( $f ) ) {
				continue;
			}
			$key  = $f['key'] ?? '';
			$name = $f['name'] ?? ( ! empty( $f['label'] ) ? sanitize_title( $f['label'] ) : '' );
			if ( ! empty( $key ) && ! empty( $name ) ) {
				$map[ $key ] = $name;
			}
			if ( ! empty( $f['sub_fields'] ) && is_array( $f['sub_fields'] ) ) {
				self::collect_acf_field_keys( $f['sub_fields'], $map );
			}
			if ( ! empty( $f['layouts'] ) && is_array( $f['layouts'] ) ) {
				foreach ( $f['layouts'] as $layout ) {
					if ( ! empty( $layout['sub_fields'] ) && is_array( $layout['sub_fields'] ) ) {
						self::collect_acf_field_keys( $layout['sub_fields'], $map );
					}
				}
			}
		}
	}

	private static function convert_acf_fields_to_mfe( array $acf_fields, array $key_to_name_map = array() ) {
		$type_map = array(
			'text'             => 'text',
			'textarea'         => 'textarea',
			'number'           => 'number',
			'range'            => 'range',
			'email'            => 'email',
			'url'              => 'url',
			'password'         => 'password',
			'image'            => 'image',
			'file'             => 'file',
			'wysiwyg'          => 'wysiwyg',
			'oembed'           => 'oembed',
			'select'           => 'select',
			'checkbox'         => 'checkbox',
			'radio'            => 'radio',
			'button_group'     => 'radio',
			'true_false'       => 'true_false',
			'link'             => 'link',
			'post_object'      => 'post_type_selector',
			'page_link'        => 'link',
			'relationship'     => 'relationship',
			'taxonomy'         => 'taxonomy',
			'user'             => 'user',
			'google_map'       => 'text',
			'date_picker'      => 'date_time',
			'date_time_picker' => 'date_time',
			'time_picker'      => 'date_time',
			'color_picker'     => 'color_picker',
			'message'          => 'text',
			'accordion'        => 'accordion',
			'tab'              => 'tab',
			'group'            => 'group',
			'repeater'         => 'repeater',
			'flexible_content' => 'flexible_content',
			'gallery'          => 'gallery',
		);

		$metaforge_fields = array();
		foreach ( $acf_fields as $f ) {
			if ( ! is_array( $f ) ) {
				continue;
			}

			$acf_type       = $f['type'] ?? 'text';
			$metaforge_type = $type_map[ $acf_type ] ?? 'text';

			// Process Conditional Logic
			$conditional_logic = 0;
			$conditions        = array();

			if ( ! empty( $f['conditional_logic'] ) && is_array( $f['conditional_logic'] ) ) {
				foreach ( $f['conditional_logic'] as $rule_group ) {
					if ( ! is_array( $rule_group ) ) {
						continue;
					}
					foreach ( $rule_group as $rule ) {
						if ( ! is_array( $rule ) || empty( $rule['field'] ) ) {
							continue;
						}
						$target_field = $rule['field'];
						if ( isset( $key_to_name_map[ $target_field ] ) ) {
							$target_field = $key_to_name_map[ $target_field ];
						}
						$raw_op = $rule['operator'] ?? '==';
						$op_map = array(
							'=='      => '==',
							'!='      => '!=',
							'>'       => '>',
							'<'       => '<',
							'==empty' => 'is_empty',
							'!=empty' => 'has_any_value',
						);
						$operator = $op_map[ $raw_op ] ?? '==';
						$val      = $rule['value'] ?? '';

						$conditions[] = array(
							'field'    => sanitize_key( $target_field ),
							'operator' => $operator,
							'value'    => (string) $val,
						);
					}
				}
				if ( ! empty( $conditions ) ) {
					$conditional_logic = 1;
				}
			}

			$field = array(
				'label'             => $f['label'] ?? ( $f['name'] ?? 'Field' ),
				'name'              => $f['name'] ?? sanitize_title( $f['label'] ?? 'field' ),
				'type'              => $metaforge_type,
				'required'          => ! empty( $f['required'] ) ? 1 : 0,
				'placeholder'       => $f['placeholder'] ?? '',
				'instructions'      => $f['instructions'] ?? '',
				'conditional_logic' => $conditional_logic,
				'conditions'        => $conditions,
			);

			// Width wrapper
			if ( ! empty( $f['wrapper']['width'] ) ) {
				$w = preg_replace( '/[^0-9]/', '', (string) $f['wrapper']['width'] );
				if ( ! empty( $w ) ) {
					$field['width'] = $w;
				}
			}

			// Sub layout for repeaters and groups
			if ( ! empty( $f['layout'] ) && in_array( $f['layout'], array( 'table', 'block', 'row' ), true ) ) {
				$field['sub_layout'] = $f['layout'];
			}

			// Textarea settings
			if ( isset( $f['rows'] ) && $f['rows'] !== '' ) {
				$field['rows'] = (string) $f['rows'];
			}
			if ( isset( $f['new_lines'] ) ) {
				$field['new_lines'] = ( $f['new_lines'] === '' ) ? 'none' : $f['new_lines'];
			}

			// Min, max, step
			if ( isset( $f['min'] ) && $f['min'] !== '' ) {
				$field['min'] = (string) $f['min'];
			}
			if ( isset( $f['max'] ) && $f['max'] !== '' ) {
				$field['max'] = (string) $f['max'];
			}
			if ( isset( $f['step'] ) && $f['step'] !== '' ) {
				$field['step'] = (string) $f['step'];
			}

			// Return format for image / file
			if ( ! empty( $f['return_format'] ) ) {
				$field['image_return_format'] = $f['return_format'];
			}

			// Default value
			if ( isset( $f['default_value'] ) && is_scalar( $f['default_value'] ) ) {
				$field['default_value'] = (string) $f['default_value'];
			}

			if ( ! empty( $f['sub_fields'] ) && is_array( $f['sub_fields'] ) ) {
				$field['sub_fields'] = self::convert_acf_fields_to_mfe( $f['sub_fields'], $key_to_name_map );
			}

			if ( ! empty( $f['layouts'] ) && is_array( $f['layouts'] ) ) {
				$field['layouts'] = array();
				foreach ( $f['layouts'] as $layout ) {
					$layout_sub = array();
					if ( ! empty( $layout['sub_fields'] ) && is_array( $layout['sub_fields'] ) ) {
						$layout_sub = self::convert_acf_fields_to_mfe( $layout['sub_fields'], $key_to_name_map );
					}
					$field['layouts'][] = array(
						'name'       => $layout['name'] ?? '',
						'label'      => $layout['label'] ?? '',
						'sub_fields' => $layout_sub,
					);
				}
			}

			if ( ! empty( $f['choices'] ) && is_array( $f['choices'] ) ) {
				$options_array = array();
				foreach ( $f['choices'] as $k => $v ) {
					$key                   = is_scalar( $k ) ? (string) $k : '';
					$val                   = is_scalar( $v ) ? (string) $v : ( is_array( $v ) ? ( $v['label'] ?? $v['value'] ?? $key ) : $key );
					$options_array[ $key ] = $val;
				}
				$field['options'] = $options_array;
			}

			$metaforge_fields[] = $field;
		}

		return $metaforge_fields;
	}
}