readdirp - 大規模ディレクトリを効率的に読み取るための Node.js 向けリーダー

• 入れ子になったディレクトリ全体を再帰的に読み取るために設計されたツールで、fs.readdir ベースの限界を補完
• Stream API を中心に設計されており、大規模なファイルツリーでも低い RAM・CPU 使用量を維持
  • for-await パターンとイベントベースのストリームの両方をサポート
• 必要に応じて Promise API も提供するが、ストリーム方式と比べてメモリ・CPU 使用量は増加
• ファイルとディレクトリを細かく制御するための fileFilter / directoryFilter を提供
  • 特定の拡張子だけを含めたり、.git のようなディレクトリを除外可能
• depth オプションにより、再帰探索の深さを制限可能
• デフォルトでは Dirent ベースの情報を返して性能を最適化し、必要に応じて alwaysStat オプション で fs.Stats 情報を提供
  • ファイルサイズ・mtime などが必要な場合にのみ有効化を推奨
• シンボリックリンク処理、ファイルタイプ制御など、実運用環境を考慮したオプションを提供
• chokidar と併用すると、ファイル探索と変更検知の役割を明確に分離したワークフローの構成に適している