feat(tuple): add tuple operations and dedicated documentation scope

[Seddryck]

Summary

• add a dedicated Tuple documentation scope and move existing tuple accessors
• complete from-end tuple projection support
• add tuple arity, swap, has-arity, pick, apply, is-tuple, and extend
• add array cardinality while preserving file-size behavior
• support explicit, multiple, and current-input spreads in tuple construction
• add generated documentation and conformance definitions for the new operators

Validation

• dotnet build Expressif.sln --nologo --no-restore
• global conformance validation: 258 schemas passed, 0 duplicate test IDs, 0 duplicate case IDs
• focused cardinality, file-size, catalog, and documentation tests: 329 passed on net10.0
• focused tests were also run across net8.0, net9.0, and net10.0 while implementing each issue

Issues

Closes #725
Closes #526
Closes #528
Closes #564
Closes #677
Closes #678
Closes #679
Closes #680
Closes #681
Closes #682

Closes #683

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 27f2b21e-5f6e-40d0-9ce1-926ddbdb8533

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

❌ Patch coverage is 76.64234% with 32 lines in your changes missing coverage. Please review.
✅ Project coverage is 84.61%. Comparing base (04b8c50) to head (4f2dbbb).

Files with missing lines	Patch %	Lines
Expressif/Functions/Tuple/TupleFunctions.cs	75.55%	4 Missing and 7 partials ⚠️
Expressif/Values/ParameterValueConverter.cs	50.00%	5 Missing and 1 partial ⚠️
Expressif/Functions/BaseExpressionFactory.cs	77.77%	1 Missing and 3 partials ⚠️
Expressif/Functions/FunctionFactory.cs	78.94%	2 Missing and 2 partials ⚠️
Expressif/Predicates/Tuple/TuplePredicates.cs	75.00%	1 Missing and 1 partial ⚠️
Expressif/Serializers/ParameterSerializer.cs	60.00%	1 Missing and 1 partial ⚠️
Expressif/Bindings/ExpressifBinder.cs	92.30%	0 Missing and 1 partial ⚠️
Expressif/Functions/Array/Cardinality.cs	0.00%	1 Missing ⚠️
...Functions/Introspection/DocumentationExtensions.cs	91.66%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #727      +/-   ##
==========================================
+ Coverage   84.40%   84.61%   +0.20%     
==========================================
  Files         222      224       +2     
  Lines        6355     6459     +104     
  Branches     1126     1160      +34     
==========================================
+ Hits         5364     5465     +101     
+ Misses        653      644       -9     
- Partials      338      350      +12     

Flag	Coverage Δ
expressif-cli-net10.0	39.35% <19.70%> (-0.41%)	⬇️
expressif-net10.0	81.85% <71.53%> (+0.19%)	⬆️
expressif-net8.0	81.85% <71.53%> (+0.19%)	⬆️
expressif-net9.0	81.85% <71.53%> (+0.19%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
8 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud