I'm not sure anymore what is changed in between many versions I didn't announced out loud.
Far from being simple widget for now, still there is edge cases may or may not be solved in best possible way. But somewhere there is a line of what is reasonable and what is not.
So I'm trying to draw that line here.
The documentation is probably best read to discover the new things.