This directory holds the integration suite of the ReScript build system and
documents its behavior. The implementation lives in
../rewatch-ocaml.
Focused documentation:
- configuration support matrix
- monorepo discovery and build scope
- feature-gated source directories
- integration-test workspace
The ReScript website owns user-facing configuration documentation. The support matrix in this directory records what the build system accepts, including compatibility fields which are not recommended for new projects.
Run commands from the repository root:
make test-rewatchThe integration suite is tests/suite.sh. It creates and
modifies projects under testrepo/; use its helpers for portable path and file
operations rather than adding platform-specific sed commands or fixed
sleeps.
When a CLI or configuration value affects compilation, trace it through both build and watch entry points. Command-line values override project configuration. Keep that precedence and the compiler-argument conversion in one owning layer where possible, and add both unit and integration coverage.
Update or remove focused documents when the implementation changes; do not preserve completed plans as descriptions of current behavior.