2 files changed, 83 insertions, 0 deletions
diff --git a/scripts/linters/src/Support/FileFinder.php b/scripts/linters/src/Support/FileFinder.php
new file mode 100644
index 00000000..50dabcd8
--- /dev/null
+++ b/scripts/linters/src/Support/FileFinder.php
@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Shirabe\Lint\Support;
+
+final class FileFinder
+{
+    // Returns absolute paths to each crate's Cargo.toml (crates/*/Cargo.toml), sorted.
+    public static function cargoTomls(string $rootDir): array
+    {
+        $paths = glob("{$rootDir}/crates/*/Cargo.toml") ?: [];
+        sort($paths);
+
+        return $paths;
+    }
+
+    /** @return list<string> absolute paths to *.rs files under crates/, sorted */
+    public static function rustFiles(string $rootDir): array
+    {
+        return self::walk("{$rootDir}/crates", static fn (string $path): bool => str_ends_with($path, '.rs'));
+    }
+
+    // Returns absolute paths to mod.rs files under each crate's src/ tree
+    // (crates/*/src/**/mod.rs), sorted.
+    public static function modRsFiles(string $rootDir): array
+    {
+        $found = [];
+
+        foreach (glob("{$rootDir}/crates/*", GLOB_ONLYDIR) ?: [] as $crateDir) {
+            $srcDir = "{$crateDir}/src";
+            if (!is_dir($srcDir)) {
+                continue;
+            }
+
+            foreach (self::walk($srcDir, static fn (string $path): bool => basename($path) === 'mod.rs') as $path) {
+                $found[] = $path;
+            }
+        }
+
+        sort($found);
+
+        return $found;
+    }
+
+    /** @return list<string> */
+    private static function walk(string $baseDir, callable $predicate): array
+    {
+        if (!is_dir($baseDir)) {
+            return [];
+        }
+
+        $found = [];
+        $iterator = new \RecursiveIteratorIterator(
+            new \RecursiveDirectoryIterator($baseDir, \FilesystemIterator::SKIP_DOTS),
+        );
+        foreach ($iterator as $file) {
+            /** @var \SplFileInfo $file */
+            if ($file->isFile() && $predicate($file->getPathname())) {
+                $found[] = $file->getPathname();
+            }
+        }
+
+        sort($found);
+
+        return $found;
+    }
+}
diff --git a/scripts/linters/src/Support/Paths.php b/scripts/linters/src/Support/Paths.php
new file mode 100644
index 00000000..2e500570
--- /dev/null
+++ b/scripts/linters/src/Support/Paths.php
@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Shirabe\Lint\Support;
+
+final class Paths
+{
+    public static function relativeTo(string $rootDir, string $path): string
+    {
+        $root = rtrim($rootDir, '/') . '/';
+
+        return str_starts_with($path, $root) ? substr($path, strlen($root)) : $path;
+    }
+}