Reintroduce --experimental option to commands

cli/ballerina-cli/src/main/java/io/ballerina/cli/cmd/BuildCommand.java

@@ -149,6 +149,9 @@ public BuildCommand() {
     @CommandLine.Option(names = {"--help", "-h"}, hidden = true)
     private boolean helpFlag;
 
+    @CommandLine.Option(names = "--experimental", description = "Enable experimental language features.")
+    private Boolean experimentalFlag;
+
     @CommandLine.Option(names = "--generate-config-schema", hidden = true)
     private Boolean configSchemaGen;
 
@@ -307,6 +310,7 @@ private BuildOptions constructBuildOptions() {
         BuildOptions.BuildOptionsBuilder buildOptionsBuilder = BuildOptions.builder();
 
         buildOptionsBuilder
+                .setExperimental(experimentalFlag)
                 .setOffline(offline)
                 .setObservabilityIncluded(observabilityIncluded)
                 .setCloud(cloud)

cli/ballerina-cli/src/main/java/io/ballerina/cli/cmd/DocCommand.java

@@ -102,6 +102,9 @@ public DocCommand() {
     @CommandLine.Option(names = {"--help", "-h"}, hidden = true)
     private boolean helpFlag;
 
+    @CommandLine.Option(names = "--experimental", description = "Enable experimental language features.")
+    private boolean experimentalFlag;
+
     @CommandLine.Option(names = "--target-dir", description = "target directory path")
     private Path targetDir;
 
@@ -226,6 +229,7 @@ private BuildOptions constructBuildOptions() {
 
         buildOptionsBuilder
                 .setCodeCoverage(false)
+                .setExperimental(experimentalFlag)
                 .setOffline(offline)
                 .setTestReport(false)
                 .setObservabilityIncluded(false)

cli/ballerina-cli/src/main/java/io/ballerina/cli/cmd/PackCommand.java

@@ -69,6 +69,9 @@ public class PackCommand implements BLauncherCmd {
     @CommandLine.Option(names = {"--help", "-h"}, hidden = true)
     private boolean helpFlag;
 
+    @CommandLine.Option(names = "--experimental", description = "Enable experimental language features.")
+    private Boolean experimentalFlag;
+
     @CommandLine.Option(names = "--debug", description = "run tests in remote debugging mode")
     private String debugPort;
 
@@ -278,6 +281,7 @@ public void execute() {
     private BuildOptions constructBuildOptions() {
         BuildOptions.BuildOptionsBuilder buildOptionsBuilder = BuildOptions.builder();
         buildOptionsBuilder
+                .setExperimental(experimentalFlag)
                 .setOffline(offline)
                 .setDumpBir(dumpBIR)
                 .setDumpBirFile(dumpBIRFile)

cli/ballerina-cli/src/main/java/io/ballerina/cli/cmd/PushCommand.java

@@ -98,6 +98,9 @@ public class PushCommand implements BLauncherCmd {
     @CommandLine.Option(names = {"--skip-source-check"}, description = "skip checking if source has changed")
     private boolean skipSourceCheck;
 
+    @CommandLine.Option(names = "--experimental", description = "enable experimental language features")
+    private boolean experimentalFlag;
+
     private final Path userDir;
     private final PrintStream errStream;
     private final PrintStream outStream;

cli/ballerina-cli/src/main/java/io/ballerina/cli/cmd/RunCommand.java

@@ -92,6 +92,9 @@ public class RunCommand implements BLauncherCmd {
     @CommandLine.Option(names = "--dump-bir", hidden = true)
     private boolean dumpBIR;
 
+    @CommandLine.Option(names = "--experimental", description = "Enable experimental language features.")
+    private boolean experimentalFlag;
+
     @CommandLine.Option(names = "--observability-included", description = "package observability in the executable " +
             "when run is used with a source file or a module.")
     private Boolean observabilityIncluded;
@@ -137,7 +140,7 @@ public class RunCommand implements BLauncherCmd {
     private static final String runCmd =
             """
                     bal run [--debug <port>] <executable-jar>\s
-                        bal run [--offline]
+                        bal run [--experimental] [--offline]
                                       [<ballerina-file | package-path>] [-- program-args...]
                     \s""";
 
@@ -341,6 +344,7 @@ private BuildOptions constructBuildOptions() {
 
         buildOptionsBuilder
                 .setCodeCoverage(false)
+                .setExperimental(experimentalFlag)
                 .setOffline(offline)
                 .setSkipTests(true)
                 .setTestReport(false)

cli/ballerina-cli/src/main/java/io/ballerina/cli/cmd/TestCommand.java

@@ -141,6 +141,9 @@ public TestCommand() {
     @CommandLine.Option(names = {"--help", "-h"}, hidden = true)
     private boolean helpFlag;
 
+    @CommandLine.Option(names = "--experimental", description = "Enable experimental language features.")
+    private Boolean experimentalFlag;
+
     @CommandLine.Option(names = "--debug", description = "start in remote debugging mode")
     private String debugPort;
 
@@ -415,6 +418,7 @@ private BuildOptions constructBuildOptions() {
 
         buildOptionsBuilder
                 .setCodeCoverage(coverage)
+                .setExperimental(experimentalFlag)
                 .setOffline(offline)
                 .setSkipTests(false)
                 .setTestReport(testReport)

compiler/ballerina-lang/src/main/java/io/ballerina/projects/BuildOptions.java

@@ -91,7 +91,7 @@ public boolean disableSyntaxTree() {
      */
     @Deprecated(forRemoval = true)
     public boolean experimental() {
-        return false;
+        return this.compilationOptions.experimental();
     }
 
     public boolean observabilityIncluded() {
@@ -199,6 +199,7 @@ public BuildOptions acceptTheirs(BuildOptions theirOptions) {
 
         CompilationOptions compilationOptions = this.compilationOptions.acceptTheirs(theirOptions.compilationOptions());
         buildOptionsBuilder.setOffline(compilationOptions.offlineBuild);
+        buildOptionsBuilder.setExperimental(compilationOptions.experimental);
         buildOptionsBuilder.setObservabilityIncluded(compilationOptions.observabilityIncluded);
         buildOptionsBuilder.setDumpBir(compilationOptions.dumpBir);
         buildOptionsBuilder.setDumpBirFile(compilationOptions.dumpBirFile);
@@ -342,6 +343,7 @@ public BuildOptionsBuilder setGraalVMBuildOptions(String value) {
          */
         @Deprecated(forRemoval = true)
         public BuildOptionsBuilder setExperimental(Boolean value) {
+            compilationOptionsBuilder.setExperimental(value);
             return this;
         }
 
@@ -416,11 +418,11 @@ public BuildOptionsBuilder setShowDependencyDiagnostics(Boolean value) {
             showDependencyDiagnostics = value;
             return this;
         }
-        
+
         /**
          * (Experimental) option to specify that the memory usage must be optimized.
-         * 
-         * @param value true or false (default)  
+         *
+         * @param value true or false (default)
          * @return BuildOptionsBuilder instance
          */
         public BuildOptionsBuilder setOptimizeDependencyCompilation(Boolean value) {

compiler/ballerina-lang/src/main/java/io/ballerina/projects/CompilationOptions.java

@@ -24,6 +24,7 @@
  */
 public class CompilationOptions {
     Boolean offlineBuild;
+    Boolean experimental;
     Boolean observabilityIncluded;
     Boolean dumpBir;
     Boolean dumpBirFile;
@@ -42,13 +43,15 @@ public class CompilationOptions {
     Boolean remoteManagement;
     Boolean optimizeDependencyCompilation;
 
-    CompilationOptions(Boolean offlineBuild, Boolean observabilityIncluded, Boolean dumpBir,
-                       Boolean dumpBirFile, String cloud, Boolean listConflictedClasses, Boolean sticky,
+    CompilationOptions(Boolean offlineBuild, Boolean experimental,
+                       Boolean observabilityIncluded, Boolean dumpBir, Boolean dumpBirFile,
+                       String cloud, Boolean listConflictedClasses, Boolean sticky,
                        Boolean dumpGraph, Boolean dumpRawGraphs, Boolean withCodeGenerators,
                        Boolean withCodeModifiers, Boolean configSchemaGen, Boolean exportOpenAPI,
                        Boolean exportComponentModel, Boolean enableCache, Boolean disableSyntaxTree,
                        Boolean remoteManagement, Boolean optimizeDependencyCompilation) {
         this.offlineBuild = offlineBuild;
+        this.experimental = experimental;
         this.observabilityIncluded = observabilityIncluded;
         this.dumpBir = dumpBir;
         this.dumpBirFile = dumpBirFile;
@@ -76,6 +79,10 @@ boolean sticky() {
         return toBooleanTrueIfNull(this.sticky);
     }
 
+    boolean experimental() {
+        return toBooleanDefaultIfNull(this.experimental);
+    }
+
     boolean observabilityIncluded() {
         return toBooleanDefaultIfNull(this.observabilityIncluded);
     }
@@ -149,6 +156,11 @@ CompilationOptions acceptTheirs(CompilationOptions theirOptions) {
         } else {
             compilationOptionsBuilder.setOffline(this.offlineBuild);
         }
+        if (theirOptions.experimental != null) {
+            compilationOptionsBuilder.setExperimental(theirOptions.experimental);
+        } else {
+            compilationOptionsBuilder.setExperimental(this.experimental);
+        }
         if (theirOptions.observabilityIncluded != null) {
             compilationOptionsBuilder.setObservabilityIncluded(theirOptions.observabilityIncluded);
         } else {
@@ -268,6 +280,7 @@ public boolean disableSyntaxTree() {
      */
     public static class CompilationOptionsBuilder {
         private Boolean offline;
+        private Boolean experimental;
         private Boolean observabilityIncluded;
         private Boolean dumpBir;
         private Boolean dumpBirFile;
@@ -296,6 +309,11 @@ public CompilationOptionsBuilder setSticky(Boolean value) {
             return this;
         }
 
+        CompilationOptionsBuilder setExperimental(Boolean value) {
+            experimental = value;
+            return this;
+        }
+
         CompilationOptionsBuilder setObservabilityIncluded(Boolean value) {
             observabilityIncluded = value;
             return this;
@@ -377,7 +395,7 @@ public CompilationOptionsBuilder setOptimizeDependencyCompilation(Boolean value)
         }
 
         public CompilationOptions build() {
-            return new CompilationOptions(offline, observabilityIncluded, dumpBir,
+            return new CompilationOptions(offline, experimental, observabilityIncluded, dumpBir,
                     dumpBirFile, cloud, listConflictedClasses, sticky, dumpGraph, dumpRawGraph,
                     withCodeGenerators, withCodeModifiers, configSchemaGen, exportOpenAPI,
                     exportComponentModel, enableCache, disableSyntaxTree, remoteManagement,

compiler/ballerina-lang/src/main/java/io/ballerina/projects/PackageCompilation.java

@@ -42,6 +42,7 @@
 import static org.ballerinalang.compiler.CompilerOptionName.DUMP_BIR;
 import static org.ballerinalang.compiler.CompilerOptionName.DUMP_BIR_FILE;
 import static org.ballerinalang.compiler.CompilerOptionName.REMOTE_MANAGEMENT;
+import static org.ballerinalang.compiler.CompilerOptionName.EXPERIMENTAL;
 import static org.ballerinalang.compiler.CompilerOptionName.OBSERVABILITY_INCLUDED;
 import static org.ballerinalang.compiler.CompilerOptionName.OFFLINE;
 
@@ -85,6 +86,7 @@ private void setupCompilation(CompilationOptions compilationOptions) {
     private void setCompilerOptions(CompilationOptions compilationOptions) {
         CompilerOptions options = CompilerOptions.getInstance(compilerContext);
         options.put(OFFLINE, Boolean.toString(compilationOptions.offlineBuild()));
+        options.put(EXPERIMENTAL, Boolean.toString(compilationOptions.experimental()));
         options.put(OBSERVABILITY_INCLUDED, Boolean.toString(compilationOptions.observabilityIncluded()));
         options.put(DUMP_BIR, Boolean.toString(compilationOptions.dumpBir()));
         options.put(DUMP_BIR_FILE, Boolean.toString(compilationOptions.dumpBirFile()));
@@ -159,7 +161,7 @@ public SemanticModel getSemanticModel(ModuleId moduleId) {
     public CodeActionManager getCodeActionManager() {
         return compilerPluginManager.getCodeActionManager();
     }
-    
+
     public CompletionManager getCompletionManager() {
         return compilerPluginManager.getCompletionManager();
     }

compiler/ballerina-lang/src/main/java/io/ballerina/projects/PackageContext.java

@@ -254,6 +254,7 @@ PackageCompilation getPackageCompilation() {
     PackageCompilation getPackageCompilation(CompilationOptions compilationOptions) {
         CompilationOptions options = CompilationOptions.builder()
                 .setOffline(this.compilationOptions.offlineBuild())
+                .setExperimental(this.compilationOptions.experimental())
                 .setObservabilityIncluded(this.compilationOptions.observabilityIncluded())
                 .setDumpBir(this.compilationOptions.dumpBir())
                 .setCloud(this.compilationOptions.getCloud())

compiler/ballerina-lang/src/main/java/io/ballerina/projects/internal/ManifestBuilder.java

@@ -885,6 +885,8 @@ private BuildOptions setBuildOptions(TomlTableNode tomlTableNode) {
         BuildOptions.BuildOptionsBuilder buildOptionsBuilder = BuildOptions.builder();
 
         Boolean offline = getBooleanFromBuildOptionsTableNode(tableNode, CompilerOptionName.OFFLINE.toString());
+        Boolean experimental =
+                getBooleanFromBuildOptionsTableNode(tableNode, CompilerOptionName.EXPERIMENTAL.toString());
         Boolean observabilityIncluded =
                 getBooleanFromBuildOptionsTableNode(tableNode, CompilerOptionName.OBSERVABILITY_INCLUDED.toString());
         Boolean testReport =
@@ -921,6 +923,7 @@ private BuildOptions setBuildOptions(TomlTableNode tomlTableNode) {
 
         buildOptionsBuilder
                 .setOffline(offline)
+                .setExperimental(experimental)
                 .setObservabilityIncluded(observabilityIncluded)
                 .setTestReport(testReport)
                 .setCodeCoverage(codeCoverage)

compiler/ballerina-lang/src/main/java/org/ballerinalang/compiler/CompilerOptionName.java

@@ -58,6 +58,8 @@ public enum CompilerOptionName {
 
     LOCK_ENABLED("lockEnabled"),
 
+    EXPERIMENTAL("experimental"),
+
     LIST_CONFLICTED_CLASSES("listConflictedClasses"),
 
     STICKY("sticky"),

distribution/zip/jballerina-tools/resources/command-completion/command-completion.csv

@@ -2,10 +2,10 @@ cmdname,flags
 add, -t --template
 bal, -v -h --help --version add bindgen build pack clean dist doc encrypt format grpc help init new openapi pull push run search shell test update version
 bindgen, -cp -m -mvn -o --classpath --maven --modules --output --public
-build, -o --cloud --debug --list-conflicted-classes --observability-included --offline --output --sticky --dump-build-time --target-dir --enable-cache
+build, -o --cloud --debug --experimental --list-conflicted-classes --observability-included --offline --output --sticky --dump-build-time --target-dir --enable-cache
 pack, -o --debug --list-conflicted-classes --observability-included --offline --output --sticky --dump-build-time --target-dir
 dist, list pull remove update use
-doc, -c -e -o --combine --exclude --output --target-dir
+doc, -c -e -o --combine --exclude --output --experimental --target-dir
 encrypt, 
 format, -d --dry-run
 graph, --dump-raw-graphs --offline --sticky
@@ -16,7 +16,7 @@ openapi, -i -m -o -s --input --mode --module --output --operation --service --se
 pull, --debug
 push, --debug --repository
 clean, --target-dir
-run, --debug --observability-included --offline --target-dir
+run, --debug --experimental --observability-included --offline --target-dir
 search,
 shell, -d -f -t --debug --force-dumb --time-out --file
-test, --code-coverage --coverage-format --debug --disable-groups --groups --list-groups --observability-included --offline --rerun-failed --tests --target-dir --test-report
+test, --code-coverage --coverage-format --debug --disable-groups --experimental --groups --list-groups --observability-included --offline --rerun-failed --tests --target-dir --test-report

project-api/project-api-test/src/test/java/io/ballerina/projects/test/TestBuildProject.java

@@ -363,7 +363,7 @@ public void testBuildProjectWithNoLangLibFilesIncluded() {
         // 1) Initialize the project instance
         BuildOptions buildOptions = BuildOptions.builder().setSkipTests(false).build();
         BuildProject project = loadBuildProject(projectPath, buildOptions);
-        
+
         // 2) Compile the current package
         PackageCompilation compilation = project.currentPackage().getCompilation();
         JBallerinaBackend jBallerinaBackend = JBallerinaBackend.from(compilation, JvmTarget.JAVA_21);
@@ -483,6 +483,7 @@ public void testLoadingBuildOptionsFromToml() {
         Assert.assertTrue(project.buildOptions().observabilityIncluded());
         Assert.assertFalse(project.buildOptions().codeCoverage());
         Assert.assertFalse(project.buildOptions().offlineBuild());
+        Assert.assertTrue(project.buildOptions().experimental());
         Assert.assertFalse(project.buildOptions().testReport());
         Assert.assertTrue(project.buildOptions().remoteManagement());
     }
@@ -504,6 +505,7 @@ public void testOverrideBuildOptions() {
         Assert.assertTrue(project.buildOptions().observabilityIncluded());
         Assert.assertFalse(project.buildOptions().codeCoverage());
         Assert.assertFalse(project.buildOptions().offlineBuild());
+        Assert.assertTrue(project.buildOptions().experimental());
         Assert.assertFalse(project.buildOptions().testReport());
     }
 
@@ -536,6 +538,7 @@ public void testOverrideBuildOptionsOnTomlEdit() {
         // Test when build option provided only in Ballerina TOML
         Assert.assertTrue(newPackage.project().buildOptions().codeCoverage());
         Assert.assertTrue(newPackage.project().buildOptions().observabilityIncluded());
+        Assert.assertTrue(newPackage.project().buildOptions().experimental());
         Assert.assertTrue(newPackage.project().buildOptions().skipTests());
     }
 
@@ -1864,7 +1867,8 @@ public void testProjectClearCaches() {
     @Test
     public void testProjectDuplicate() {
         Path projectPath = tempResourceDir.resolve("myproject");
-        BuildOptions.BuildOptionsBuilder optionsBuilder = BuildOptions.builder().setCodeCoverage(true);
+        BuildOptions.BuildOptionsBuilder optionsBuilder = BuildOptions.builder()
+                .setCodeCoverage(true).setExperimental(true);
         Project project = loadProject(projectPath, optionsBuilder.build());
 
         Project duplicate = project.duplicate();
@@ -1882,6 +1886,7 @@ public void testProjectDuplicate() {
 
         Assert.assertEquals(project.sourceRoot().toString(), duplicate.sourceRoot().toString());
         Assert.assertTrue(duplicate.buildOptions().codeCoverage());
+        Assert.assertTrue(duplicate.buildOptions().experimental());
         Assert.assertFalse(duplicate.buildOptions().testReport());
 
         Assert.assertNotSame(project.currentPackage(), duplicate.currentPackage());

project-api/project-api-test/src/test/java/io/ballerina/projects/test/TestSingleFileProject.java

@@ -147,6 +147,7 @@ public void testDefaultBuildOptions() {
         Assert.assertFalse(project.buildOptions().observabilityIncluded());
         Assert.assertFalse(project.buildOptions().codeCoverage());
         Assert.assertFalse(project.buildOptions().offlineBuild());
+        Assert.assertFalse(project.buildOptions().experimental());
         Assert.assertFalse(project.buildOptions().testReport());
     }
 
@@ -168,6 +169,7 @@ public void testOverrideBuildOptions() {
         Assert.assertTrue(project.buildOptions().skipTests());
         Assert.assertTrue(project.buildOptions().observabilityIncluded());
         Assert.assertFalse(project.buildOptions().codeCoverage());
+        Assert.assertFalse(project.buildOptions().experimental());
         Assert.assertFalse(project.buildOptions().testReport());
     }
 

project-api/project-api-test/src/test/resources/ballerinatomlWithBuildOptions/Ballerina.toml

@@ -5,3 +5,4 @@ version = "0.1.0"
 
 [build-options]
 b7aConfigFile="/tmp/ballerina.conf"
+experimental=true

project-api/project-api-test/src/test/resources/projectForDocumentIdTest/Ballerina.toml

@@ -5,5 +5,6 @@ version = "0.1.0"
 
 [build-options]
 b7aConfigFile="/tmp/ballerina.conf"
+experimental=true
 observabilityIncluded = false
 skipTests=true

project-api/project-api-test/src/test/resources/projectWithBuildOptions/Ballerina.toml

@@ -5,6 +5,7 @@ version = "0.1.0"
 
 [build-options]
 b7aConfigFile="/tmp/ballerina.conf"
+experimental=true
 observabilityIncluded = true
 skipTests=true
 remoteManagement=true