Builder/DSL question

Builders.kt

// -- this is a public function to make the creation of ColorBuffer instances simple
fun colorBuffer(width: Int, height: Int, contentScale: Double = 1.0, format: ColorFormat = ColorFormat.RGBa, type: ColorType = ColorType.UINT8): ColorBuffer {
    return ColorBuffer.create(width, height, contentScale, format, type)
}

@Suppress("unused")
class RenderTargetBuilder(private val renderTarget: RenderTarget) {

    // -- this is here to shadow the colorBuffer function that should not be used
    @Deprecated("you should not use this", replaceWith = ReplaceWith("colorBuffer()"))
    fun colorBuffer(width: Int, height: Int, contentScale: Double = 1.0, format: ColorFormat = ColorFormat.RGBa, type: ColorType = ColorType.UINT8): ColorBuffer {
        throw IllegalStateException("use colorBuffer without width and height arguments")
    }

    // -- this is part of the DSL and this is what should be used
    fun colorBuffer(colorBuffer: ColorBuffer) {
        renderTarget.attach(colorBuffer)
    }
    // .. 
}

fun renderTarget(width: Int, height: Int, contentScale: Double = 1.0, builder: RenderTargetBuilder.() -> Unit): RenderTarget {
    val renderTarget = RenderTarget.create(width, height, contentScale)
    RenderTargetBuilder(renderTarget).builder()
    return renderTarget
}

fun main() {
    // -- correct usage
    val rt = renderTarget(640, 480) {
       colorBuffer() 
    }

    // -- incorrect usage, but an easy mistake to make
    val ic = renderTarget(640, 480) {
       colorBuffer(640, 480) 
    }
}