Interface ParallelOptions

Enable automatic mode selection based on project complexity, default: true. When enabled, the executor analyzes project metrics (file count, LOC, memory pressure) and automatically chooses between Promise-based and worker thread parallelism.

Set to false to disable auto-selection and use Promise-based mode by default. If useWorkerThreads is explicitly set (true or false), this option is ignored.

Maximum files per worker batch (default: 10)

Enable real-time memory monitoring in Promise mode, default: true. Monitors heap usage and projects peak memory to abort if critical threshold exceeded.

Allow automatic fallback to workers if Promise mode aborts, default: true. Only used when autoSelectMode is true and monitoring detects memory pressure.

Maximum concurrent workers (default: CPU cores - 1)

Minimum number of files required to use worker threads (default: 200). Worker thread initialization has significant overhead (loading ts-morph project, plugins, etc.). For small file sets, Promise-based parallelism is faster. Set to 0 to always use workers when useWorkerThreads is true.

Enable progress callbacks

Plugin IDs to load in workers

Enable cancellation

Custom thresholds for automatic mode selection. Only used when autoSelectMode is true.

Task timeout in milliseconds (default: 30000)

TypeScript config path (required for worker threads)

Use worker threads for true parallelism

Path to worker script (required for worker threads). Use getWorkerScriptPath() from @angular-modernizer/worker package.