<?php
/**
 * Contract every builder-specific adapter implements.
 *
 * @package Esipher
 */

namespace Esipher\Adapters;

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

/**
 * Keeping this interface small is what keeps adapters cheap to write:
 * supporting a new AI builder means writing one small class here, not
 * touching the generic engine in includes/.
 */
interface Source_Adapter {

	/**
	 * Does this extracted export belong to this builder?
	 *
	 * @param string $dir Absolute path to the extracted export root.
	 *
	 * @return bool
	 */
	public function detect( $dir );

	/**
	 * Strip this builder's vendor-specific markup (tagger attributes,
	 * injected badges, build comments, etc).
	 *
	 * @param string $html Raw HTML markup.
	 *
	 * @return string Cleaned HTML markup.
	 */
	public function clean_markup( $html );

	/**
	 * Builder name/version hints worth logging or showing the user.
	 *
	 * @param string $dir Absolute path to the extracted export root.
	 *
	 * @return array<string,mixed>
	 */
	public function get_metadata( $dir );
}