FEATURE: Improved FlowQuery find operations for Neos 9

[mficzel]

Is there an existing issue for this topic?

• I have searched the existing issues

Description

The syntax of find and children operations is quite ambigious and maps pooly to the new CR API.

Possible Solution

Since this is hard to fix new flowQuery operations that are modeled for the cr could help.

deprecate find in favor of

q(site).findByCriteria('Neos.Neos:Document,!Vendor.Site:Foo', 'prop1 ^= "foo" AND NOT (prop2 = "bar" OR prop3 = "baz")', {limit: 1, offset: 0})
q(site).findById('abc,defg')
# maybe aswell
q(site).findByPath('foo/bar')
q(site).findByRelativePath('foo/bar')
q(site).findByAbsolutePath('<Node.Type>/foo/bar')

deprecate children in favor of

q(site).childrenByCriteria() -> for consistency with findByCriteria and deprecate children
q(site).childByName() -> for auto created nodes