Add support for error binding patterns in the on fail clause

[MaryamZi]

Purpose

$title.

import ballerina/io;

public function main() {
    do {
        fail error("error!");
    } on fail var error(m) {
        io:println("Error: ", m);
    }
}

Fixes #29183

Check List

• Read the Contributing Guide
• Updated Change Log
• Checked Tooling Support (#)
• Added necessary tests
  • Unit Tests
  • Spec Conformance Tests
  • Integration Tests
  • Ballerina By Example Tests
• Increased Test Coverage
• Added necessary documentation
  • API documentation
  • Module documentation in Module.md files
  • Ballerina By Examples

[codecov]

Codecov Report

Attention: 39 lines in your changes are missing coverage. Please review.

Comparison is base (21a32d4) 76.73% compared to head (a99b983) 76.73%.
Report is 96 commits behind head on master.

Files	Patch %	Lines
...in/java/io/ballerina/projects/DependencyGraph.java	0.00%	24 Missing ⚠️
...io/ballerina/compiler/syntax/tree/NodeFactory.java	25.00%	3 Missing ⚠️
...allerinalang/compiler/bir/codegen/JvmValueGen.java	95.55%	1 Missing and 1 partial ⚠️
...lang/compiler/semantics/analyzer/CodeAnalyzer.java	84.61%	0 Missing and 2 partials ⚠️
...llerinalang/compiler/semantics/analyzer/Types.java	90.90%	1 Missing and 1 partial ⚠️
...o/ballerina/compiler/syntax/tree/TreeModifier.java	0.00%	2 Missing ⚠️
...ompiler/bir/codegen/interop/ExternalMethodGen.java	83.33%	0 Missing and 1 partial ⚠️
...lang/compiler/bir/codegen/methodgen/MethodGen.java	98.18%	0 Missing and 1 partial ⚠️
.../compiler/semantics/analyzer/SemanticAnalyzer.java	98.63%	0 Missing and 1 partial ⚠️
.../compiler/internal/parser/tree/STTreeModifier.java	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff            @@
##             master   #41049   +/-   ##
=========================================
  Coverage     76.73%   76.73%           
- Complexity    52692    52715   +23     
=========================================
  Files          2879     2878    -1     
  Lines        198658   198706   +48     
  Branches      25809    25825   +16     
=========================================
+ Hits         152434   152475   +41     
- Misses        37797    37804    +7     
  Partials       8427     8427           

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

[github-actions]

This PR has been open for more than 15 days with no activity. This will be closed in 3 days unless the stale label is removed or commented.

[gimantha]

LGTM

[dulajdilshan]

LGTM

[sonarqubecloud]

SonarCloud Quality Gate failed.   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
11 Code Smells

0.0% Coverage
0.2% Duplication

Catch issues before they fail your Quality Gate with our IDE extension SonarLint