Change Gradle dependency scope from compileOnlyApi to api?

[sdavids]

The jspecify discussion came to the conclusion to use api scope due to RUNTIME retention and tooling issues.

Maybe it is the better choice for apiguardian as well?

---

dependencies {    
    compileOnlyApi("org.apiguardian:apiguardian-api:1.1.2")
}

⇓

dependencies {    
    api("org.apiguardian:apiguardian-api:1.1.2")
}

https://github.com/apiguardian-team/apiguardian?tab=readme-ov-file#gradle

[marcphilipp]

I think you're referring to jspecify/jspecify#503 (comment), right? In my opinion, since the annotations are not needed at runtime, they should not be declared as api. However, I'd be fine with documenting the two possibilities and letting users decide. WDYT?