Add "extra_detected_files" filter

- Add "extra_detected_files" filter that allows plugins to
  add additional files when the "detect" step is run.

Author: john-shaffer

CHANGELOG.md

@@ -36,6 +36,8 @@
   - Add deployed_at column and an index on it.
 - Batch queries to the deployed_files table for better
   performance.
+- Add "extra_detected_files" filter that allows plugins to
+  add additional files when the "detect" step is run.
 
 ## 9.3.2 (2025-07-29)
 

src/URLDetector.php

@@ -29,6 +29,11 @@ public static function detectURLsIter(): \Iterator {
 
         $iterators_to_merge = [];
 
+        $iterators_to_merge[] = apply_filters(
+            Controller::getHookName( 'extra_detected_files' ),
+            new \ArrayIterator( [] ),
+        );
+
         $iterators_to_merge[] = new \ArrayIterator(
             [
                 new PathInfo( '/' ),

tests/integration/DetectTest.php

@@ -66,4 +66,32 @@ public function testSitemapDoubleSlashes(): void
 
         exec( 'rm -f ' . escapeshellarg( $robotstxt ) );
     }
+
+    public function testExtraDetectedFiles(): void
+    {
+        $plugin = <<<'PHP'
+<?php
+
+/**
+ * Plugin Name: Extra Detected Files Test
+ */
+
+if ( ! defined( 'WPINC' ) ) {
+    die;
+}
+
+use StaticDeploy\PathInfo;
+
+function extra_detected_files_filter ( $iter ) {
+    yield from $iter;
+    yield new PathInfo( '/extra-detected-file.html' );
+}
+add_filter( 'static_deploy_extra_detected_files', 'extra_detected_files_filter' );
+PHP;
+        $this->installStringPlugin( 'extra-detected-files-test', $plugin );
+
+        $this->pluginCli( [ 'detect' ] );
+        $lines = $this->pluginCli( [ 'detected-files', 'list' ] )['output'];
+        $this->assertContains( '/extra-detected-file.html', $lines );
+    }
 }