1	<?php
2
3	declare(strict_types=1);
4
5	/**
6	* This file is part of fast-forward/dev-tools.
7	*
8	* This source file is subject to the license bundled
9	* with this source code in the file LICENSE.
10	*
11	* @copyright Copyright (c) 2026 Felipe Sayão Lobato Abreu <github@mentordosnerds.com>
12	* @license   https://opensource.org/licenses/MIT MIT License
13	*
14	* @see       https://github.com/php-fast-forward/dev-tools
15	* @see       https://github.com/php-fast-forward
16	* @see       https://datatracker.ietf.org/doc/html/rfc2119
17	*/
18
19	namespace FastForward\DevTools\GitAttributes;
20
21	/**
22	* Filters canonical export-ignore candidates against consumer keep rules.
23	*
24	* Implementations MUST remove any candidate path explicitly configured to stay
25	* in the exported package archive, while preserving the order of the remaining
26	* candidates.
27	*/
28	interface ExportIgnoreFilterInterface
29	{
30	/**
31	* Filters export-ignore candidates using the configured keep-in-export paths.
32	*
33	* @param list<string> $candidates the canonical candidate paths
34	* @param list<string> $keepInExportPaths the paths that MUST remain exportable
35	*
36	* @return list<string> the filtered export-ignore candidates
37	*/
38	public function filter(array $candidates, array $keepInExportPaths): array;
39	}