<?php

declare(strict_types=1);

namespace App\Framework\MachineLearning\Core;

use App\Framework\MachineLearning\ValueObjects\FeatureType;

/**
 * Atomic interface for feature extractor metadata and configuration
 *
 * This interface is domain-agnostic and provides metadata about
 * feature extractors without specifying extraction logic.
 *
 * Composition Pattern:
 * - Combine with FeatureExtractorPerformance for complete metadata
 * - Combine with domain-specific extractor interfaces (WafFeatureExtractor, etc.)
 */
interface FeatureExtractorMetadata
{
    /**
     * Get the feature type this extractor produces
     */
    public function getFeatureType(): FeatureType;

    /**
     * Get names of all features this extractor can produce
     *
     * @return string[]
     */
    public function getFeatureNames(): array;

    /**
     * Get extractor configuration
     *
     * @return array<string, mixed>
     */
    public function getConfiguration(): array;

    /**
     * Check if extractor is enabled
     */
    public function isEnabled(): bool;

    /**
     * Get execution priority
     *
     * Priority ranges:
     * - 1000+: Critical features (must run first)
     * - 500-999: High priority features
     * - 100-499: Normal priority features
     * - 1-99: Low priority features
     * - 0: Background features (run last)
     */
    public function getPriority(): int;
}
