tests.run

Run the engine test suite and return structured results — every registered suite by default, a single named suite, or a chosen subset. Each run writes a Markdown and a JSON report to the temporary source area and can save an extra copy in a format you pick. Every suite runs through its own cooperative coroutine so multi-frame tests yield across engine frames correctly; an async run schedules the whole sweep as one task and returns its id immediately. Testing is an edit-mode authoring concern — the operation is refused in play mode, since it spawns and despawns entities, loads scenes, and flips modes.

onWorker = true runs each suite inside a worker job (jobs.dispatch) rather than on the engine thread, and records onWorker = true on the result. The result keeps the engine-thread shape; a suite the worker cannot start counts as one failed result whose error is the text the worker gave. From the shell, ON_WORKER=1 ./scripts/run_luau_tests.sh <suite> adds the option.