[CALCITE-7688] Support scalar subqueries in table function arguments

[tkalkirill]

Jira Link

CALCITE-7688

Changes Proposed

This PR introduces support for scalar subqueries and expressions containing scalar subqueries in table function arguments:

SELECT * FROM TABLE(my_function((SELECT value FROM t), 1));

SELECT * FROM TABLE(my_function((SELECT 4) + (SELECT 6), 1));

SELECT *
FROM person p
CROSS JOIN LATERAL TABLE(
  my_function((SELECT p.id + 1), p.id)
);

[sonarqubecloud]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

Measures
0 Security Hotspots
86.9% Coverage on New Code
2.7% Duplication on New Code

See analysis details on SonarQube Cloud

[mihaibudiu]

the commit message is not ideal.
Is this work in progress, or is it ready for review?