interface IconFinderInterface

interface IconFinderInterface {
    
    /**
     * Create files from source paths.
     *
     * @param string[] $sources
     *   The list of paths or urls.
     * @param string $relative_path
     *   The current definition relative path.
     *
     * @return array<string, array<string, string|null>>
     *   List of files with metadata.
     */
    public function getFilesFromSources(array $sources, string $relative_path) : array;
    
    /**
     * Wrapper to the file_get_contents function.
     *
     * This allow usage in extractor and easier unit test.
     *
     * @param string $uri
     *   The URI to process, only local path allowed.
     *
     * @return string|bool
     *   The file content.
     */
    public function getFileContents(string $uri) : string|bool;

}