generated content of parameter comments for oneOfType is confusing

[CNFeffery]

dash                 2.17.1
dash-core-components 2.0.0
dash-html-components 2.0.0
dash-table           5.0.0

The format of the component parameter documentation is confusing for complex parameters with the type format set to oneOfType, for example:

Generate documentation result, The order and structure from the source code are lost:

I hope to generate parameter documentation that is consistent with the order and structure in the source code.

[T4rk1n]

I think this is sorted here:

dash/dash/development/_py_components_generation.py

Line 560 in a77dec6

for prop_name, prop in sorted(list(type_object["value"].items()))

Code probably predates default ordered dict, so the keys were sorted to have a consistent output. Should be removed and keep the order it was defined in the metadata.json

[CNFeffery]

@T4rk1n I noticed that the dash-generate-components cli has a parameter named --keep-prop-order.

should the code below follow this parameter to change?

dash/dash/development/_py_components_generation.py

Line 560 in a77dec6

for prop_name, prop in sorted(list(type_object["value"].items()))

[T4rk1n]

should the code below follow this parameter to change?

No I don't think it should follow that variable is for the main props but the bug here is with the shapes, I think just removing sorted(list( part would be enough.