Consider using a DSLMarker annotation

[jogro]

I think your DSL could benefit greatly from using a DSLMarker annotation.

Consider defining an annotation like:

@Target(AnnotationTarget.CLASS, AnnotationTarget.TYPE, AnnotationTarget.FUNCTION)
@DslMarker
annotation class OpenApiDsl

Then annotate the API receiver lambdas like:

fun OpenAPI.paths(init: @OpenApiDsl Paths.() -> Unit) {
    paths = paths ?: Paths()
    paths.init()
}

Sadly, this could potentially break existing code.

[derveloper]

Hi jogro,

thanks again for your issue.
Feel free to create a PR, I'm more than happy to merge it and create a new release.