Returns nested for about kotlinpoetdsl HOT 1 CLOSED

The functions are no longer adding to the surrounding context.
Instead, with interfaces, the surrounding context asks to build the Spec and pass it on.,

Due to the fact that build can be called all the time, there is still one issue:
Do we call build as less as possible (return the Builder when not finishing) or do we return typeSpec?

When returning the builder, we can create more advanced DSL's:

clazz("hi") extends ClassA::Class implements InterfaceA::Class implements  InterfaceB::Class

on the other hand, it doesn't return a typeSpec, which someone might need to use.

clazz("hi") extends ClassA::Class //doesn't return typeSpec
(clazz("hi") extends ClassA::Class).build //return typeSpec
clazz("hi") extends ClassA::Class{} //return typeSpec

The typeSpec is easy to get, by just adding an (empty) body or calling build.

from kotlinpoetdsl.