<?php
namespace AntivirusAI\V1;

/** Read-only scope discovery for the installation being inspected. */
final class InstallationPaths {
	/** Use the native local-filesystem discovery API without requesting write credentials. */
	private static function filesystem(): \WP_Filesystem_Direct {
		// This object only resolves the local installation being scanned. Do not replace
		// WordPress's global filesystem transport or connect to a remote FTP filesystem.
		require_once ABSPATH . 'wp-admin/includes/class-wp-filesystem-base.php';
		require_once ABSPATH . 'wp-admin/includes/class-wp-filesystem-direct.php';
		return new \WP_Filesystem_Direct( null );
	}

	private static function normalize( mixed $path ): string {
		if ( ! is_string( $path ) || '' === $path || str_contains( $path, "\0" ) ) {
			throw new \RuntimeException( 'WordPress could not resolve an installation directory.' );
		}
		return untrailingslashit( wp_normalize_path( $path ) );
	}

	public static function wordpress(): string {
		return self::normalize( self::filesystem()->abspath() );
	}

	public static function content(): string {
		return self::normalize( self::filesystem()->wp_content_dir() );
	}

	public static function plugins(): string {
		return self::normalize( self::filesystem()->wp_plugins_dir() );
	}

	public static function mustUse(): string {
		// WordPress has no directory-returning API for this separately relocatable root.
		// The documented configuration constant is required even when the folder is empty;
		// deriving it from content/plugins or an installed MU file would miss scan scope.
		return defined( 'WPMU_PLUGIN_DIR' ) ? self::normalize( WPMU_PLUGIN_DIR ) : '';
	}

	public static function roots(): array {
		return array_filter( array( self::wordpress(), self::content(), self::plugins(), self::mustUse() ) );
	}

	public static function themes(): array {
		$roots = array();
		$default = get_theme_root();
		if ( is_string( $default ) && '' !== $default ) { $roots[] = untrailingslashit( wp_normalize_path( $default ) ); }
		$themes = search_theme_directories();
		foreach ( is_array( $themes ) ? $themes : array() as $theme ) {
			if ( is_array( $theme ) && is_string( $theme['theme_root'] ?? null ) && '' !== $theme['theme_root'] ) {
				$roots[] = untrailingslashit( wp_normalize_path( $theme['theme_root'] ) );
			}
		}
		return array_values( array_unique( $roots ) );
	}
}