Tree recursive folding (like Scene Tree Dock)

[AThousandShips]

Moves the behavior of Scene Tree Dock recursively folding of trees into TreeItem:

• Adds function set_collapsed_recursive to collapse/uncollapse a TreeItem and all its descendants
• Adds function is_any_collapsed to check if a TreeItem (with children) or any of its children (with children) are collapsed
• Shift clicking the fold collapses/uncollapses the entire tree under the TreeItem, depending on the fold state of the TreeItem
• Ads disable property for this input behavior to TreeItem

Replaced the functionality in Scene Tree Dock with this, and I haven't found anywhere else it is used but if anyone does please point it out and I can remove it there as well.

(The original approach in Scene Tree Dock was doing some redundant folding on shift click as it would fold the TreeItem and all descendants, but this would trigger each of those descendants to fold recursively on their own, not major and mostly unavoidable with the approach used, but it is a thing)

• Fixes Move recursive folding functionality from the Scene Tree dock to the Tree node, so that it can also be used in projects godot-proposals#4791
• Fixes Make shift clicking the arrows in FileSystem dock work like in the node tree #35529

[AThousandShips]

I went with is_any_collapsed over the is_collapsed_recursive of Scene Tree Dock as I felt it was ambiguous, as it could be seen as meaning "is this node and all descendants collapsed"

[AThousandShips]

Wasn't aware of the doctool check but now I know to verify that (sorry only fixed what I immediately saw in the failed check before I ran it), this shoudl be correct

[akien-mga]

Related (very old) PR: #36926.

[AThousandShips]

Intriguing! I thought I had exhaustively searched for this but must have missed this old case

[AThousandShips]

I'm not familiar with the process when something like this occurs is, so any directions would be appreciated

[AThousandShips]

This should also fix #35529

[AThousandShips]

Moved the disabling of recursive folding to the tree as I felt it doesn't make much sense in TreeItem, as one would have to disable it everywhere, and it would be confusing to decide what way that would control things anyway

Also added the option to limit is_any_collapsed to visible items only as it would otherwise cause some confusing behavior if you have collapsed but invisible items (an edge case but I felt it was useful, option defaults to false)

Will push once I've checked the last details on my end

[AThousandShips]

Note that with the addition of disabling it from the tree the original behavior in Scene Tree Dock could be kept for a subsequent PR by simply disabling it on the tree in Scene Tree, though I'm confident in my solution replicating previous the behavior reliably, i.e. if felt that the changes to Scene Tree Dock to accomodate this change should be done separately or by someone else

[AThousandShips]

Made the context menu option in Filesystem Dock use recursive folding, leaving the instances in Visual Shader Editor alone as it is only one level deep, haven't found any other instance like this with a menu (will push once I've compiled locally)

[KoBeWi]

Looks good, but I'd rename disable_recursive_folding to enable_recursive_folding (true by default) and mention Shift in the docs.

[AThousandShips]

Thank you, will take a look at all this tomorrow probably not doing so well today

[akien-mga]

Thanks!