Advance options should start with -X

Bump Exec from 1.0.4 to 1.0.5
Bump PMD from 1.2.1 to 1.2.2

.github/workflows/bld.yml

@@ -2,17 +2,15 @@ name: bld-ci
 
 on: [ push, pull_request, workflow_dispatch ]
 
-env:
-  KOTLIN_HOME: /usr/share/kotlinc
-
 jobs:
   build-bld-project:
-    runs-on: ubuntu-latest
-
     strategy:
       matrix:
-        java-version: [ 17, 21, 22 ]
+        java-version: [ 17, 21, 24 ]
-        kotlin-version: [ 1.9.24, 2.0.0 ]
+        kotlin-version: [ 1.9.25, 2.0.21, 2.1.20 ]
+        os: [ ubuntu-latest, windows-latest, macos-latest ]
+
+    runs-on: ${{ matrix.os }}
 
     steps:
       - name: Checkout source repository
@@ -38,4 +36,4 @@ jobs:
         run: ./bld download
 
       - name: Run tests
-        run: ./bld compile test
+        run: ./bld compile test

.github/workflows/pages.yml

@@ -47,11 +47,11 @@ jobs:
         uses: actions/configure-pages@v3
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v1
+        uses: actions/upload-pages-artifact@v3
         with:
           # Upload generated Javadocs repository
           path: "build/javadoc/"
 
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v1
+        uses: actions/deploy-pages@v4

.idea/icon.svg

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg width="100%" height="100%" viewBox="0 0 179 108" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve" xmlns:serif="http://www.serif.com/" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2;">
+    <g transform="matrix(1,0,0,1,-210.511,-96.3382)">
+        <g transform="matrix(1,0,0,1,-23.3386,-649.816)">
+            <g transform="matrix(0.221288,0,0,0.24,73.9536,390.254)">
+                <path d="M722.568,1482.92L722.568,1921.1L808.968,1921.1L808.968,1888.7C822.168,1907.9 846.168,1930.1 893.568,1930.1C933.168,1930.1 961.968,1917.5 985.368,1893.5C1012.97,1865.9 1027.37,1827.5 1027.37,1786.1C1027.37,1741.7 1011.17,1705.1 985.368,1680.5C961.968,1658.3 928.968,1644.5 892.368,1644.5C862.968,1644.5 830.568,1654.1 808.968,1683.5L808.968,1482.92L722.568,1482.92ZM871.368,1718.9C888.768,1718.9 903.768,1723.7 917.568,1736.9C930.168,1748.9 938.568,1766.3 938.568,1787.9C938.568,1807.7 930.168,1825.1 917.568,1837.1C904.368,1849.7 887.568,1855.7 872.568,1855.7C856.368,1855.7 837.168,1849.1 823.368,1835.9C813.168,1826.3 803.568,1810.1 803.568,1787.9C803.568,1765.1 812.568,1749.5 822.768,1738.7C836.568,1724.3 852.768,1718.9 871.368,1718.9Z" style="fill:rgb(35,146,255);fill-rule:nonzero;"/>
+                <rect x="1083.77" y="1482.92" width="86.4" height="438.182" style="fill:rgb(250,144,82);fill-rule:nonzero;"/>
+                <path d="M1531.37,1482.92L1444.97,1482.92L1444.97,1683.5C1423.37,1654.1 1390.97,1644.5 1361.57,1644.5C1324.97,1644.5 1291.97,1658.3 1268.57,1680.5C1242.77,1705.1 1226.57,1741.7 1226.57,1786.1C1226.57,1827.5 1240.97,1865.9 1268.57,1893.5C1291.97,1917.5 1320.77,1930.1 1360.37,1930.1C1407.77,1930.1 1431.77,1907.9 1444.97,1888.7L1444.97,1921.1L1531.37,1921.1L1531.37,1482.92ZM1382.57,1718.9C1401.17,1718.9 1417.37,1724.3 1431.17,1738.7C1441.37,1749.5 1450.37,1765.1 1450.37,1787.9C1450.37,1810.1 1440.77,1826.3 1430.57,1835.9C1416.77,1849.1 1397.57,1855.7 1381.37,1855.7C1366.37,1855.7 1349.57,1849.7 1336.37,1837.1C1323.77,1825.1 1315.37,1807.7 1315.37,1787.9C1315.37,1766.3 1323.77,1748.9 1336.37,1736.9C1350.17,1723.7 1365.17,1718.9 1382.57,1718.9Z" style="fill:rgb(35,146,255);fill-rule:nonzero;"/>
+            </g>
+        </g>
+    </g>
+</svg>

.idea/libraries/bld.xml

@@ -2,12 +2,12 @@
   <library name="bld">
     <CLASSES>
       <root url="file://$PROJECT_DIR$/lib/bld" />
-      <root url="jar://$USER_HOME$/.bld/dist/bld-2.1.0.jar!/" />
+      <root url="jar://$USER_HOME$/.bld/dist/bld-2.2.1.jar!/" />
       <root url="file://$PROJECT_DIR$/lib/bld" />
     </CLASSES>
     <JAVADOC />
     <SOURCES>
-      <root url="jar://$USER_HOME$/.bld/dist/bld-2.1.0-sources.jar!/" />
+      <root url="jar://$USER_HOME$/.bld/dist/bld-2.2.1-sources.jar!/" />
       <root url="file://$PROJECT_DIR$/lib/bld" />
     </SOURCES>
     <excluded>

.idea/misc.xml

@@ -9,10 +9,13 @@
       <entry_point TYPE="field" FQNAME="rife.bld.extension.kotlin.CompilerPlugin NOARG" />
       <entry_point TYPE="field" FQNAME="rife.bld.extension.kotlin.CompilerPlugin POWER_ASSERT" />
       <entry_point TYPE="field" FQNAME="rife.bld.extension.kotlin.CompilerPlugin SAM_WITH_RECEIVER" />
+      <entry_point TYPE="field" FQNAME="rife.bld.extension.kotlin.CompilerPlugin COMPOSE" />
+      <entry_point TYPE="field" FQNAME="rife.bld.extension.kotlin.CompilerPlugin KOTLIN_IMPORTS_DUMPER" />
     </entry_points>
     <pattern value="rife.bld.extension.CompileKotlinOperationBuild" method="pmd" />
     <pattern value="rife.bld.extension.kotlin.CompilerPlugin" />
     <pattern value="rife.bld.extension.kotlin.CompilerPlugin" method="CompilerPlugin" />
+    <pattern value="rife.bld.extension.CompileKotlinOperationBuild" method="publishGitHub" />
   </component>
   <component name="PDMPlugin">
     <option name="customRuleSets">

.idea/runConfigurations/Run Tests.xml

@@ -1,9 +0,0 @@
-<component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="Run Tests" type="Application" factoryName="Application" nameIsGenerated="true">
-    <option name="MAIN_CLASS_NAME" value="rife.bld.extension.CompileKotlinOperationTest" />
-    <module name="app" />
-    <method v="2">
-      <option name="Make" enabled="true" />
-    </method>
-  </configuration>
-</component>

.vscode/settings.json

@@ -9,7 +9,7 @@
     ],
     "java.configuration.updateBuildConfiguration": "automatic",
     "java.project.referencedLibraries": [
-        "${HOME}/.bld/dist/bld-2.1.0.jar",
+        "${HOME}/.bld/dist/bld-2.2.1.jar",
         "lib/**/*.jar"
     ]
 }

README.md

@@ -2,19 +2,23 @@
 
 [![License](https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Java](https://img.shields.io/badge/java-17%2B-blue)](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html)
-[![Kotlin](https://img.shields.io/badge/kotlin-1.9.24%2B-7f52ff.svg)](https://kotlinlang.org)
+[![Kotlin](https://img.shields.io/badge/kotlin-1.9.25%2B-7f52ff.svg)](https://kotlinlang.org)
-[![bld](https://img.shields.io/badge/2.1.0-FA9052?label=bld&labelColor=2392FF)](https://rife2.com/bld)
+[![bld](https://img.shields.io/badge/2.2.1-FA9052?label=bld&labelColor=2392FF)](https://rife2.com/bld)
 [![Release](https://flat.badgen.net/maven/v/metadata-url/repo.rife2.com/releases/com/uwyn/rife2/bld-kotlin/maven-metadata.xml?color=blue)](https://repo.rife2.com/#/releases/com/uwyn/rife2/bld-kotlin)
 [![Snapshot](https://flat.badgen.net/maven/v/metadata-url/repo.rife2.com/snapshots/com/uwyn/rife2/bld-kotlin/maven-metadata.xml?label=snapshot)](https://repo.rife2.com/#/snapshots/com/uwyn/rife2/bld-kotlin)
 [![GitHub CI](https://github.com/rife2/bld-kotlin/actions/workflows/bld.yml/badge.svg)](https://github.com/rife2/bld-kotlin/actions/workflows/bld.yml)
 
-To install, please refer to the [extensions](https://github.com/rife2/bld/wiki/Extensions)
+To install the latest version, add the following to the `lib/bld/bld-wrapper.properties` file:
-and [support](https://github.com/rife2/bld/wiki/Kotlin-Support)
+
-documentation.
+```properties
+bld.extension-kotlin=com.uwyn.rife2:bld-kotlin
+```
+
+For more information, please refer to the [extensions](https://github.com/rife2/bld/wiki/Extensions) and [support](https://github.com/rife2/bld/wiki/Kotlin-Support) documentation.
 
 ## Compile Kotlin Source Code
 
-To compile the source code located in `src/main/kotlin` and `src/test/kotlin` from the current project:
+To compile the source code located in `src/main/kotlin` and `src/test/kotlin` from the current project add the following to the build file:
 
 ```java
 
@@ -40,6 +44,15 @@ for all available configuration options.
 
 Please make sure the Kotlin compiler is [installed](https://kotlinlang.org/docs/command-line.html#install-the-compiler).
 
+The extension will look in common locations such as:
+
+ - `KOTLIN_HOME`
+ - `PATH`
+ - [SDKMAN!](https://sdkman.io/)
+ - [Homebrew](https://brew.sh/)
+ - [JetBrains Toolbox](https://www.jetbrains.com/toolbox-app/) (IntelliJ IDEA, Android Studio)
+ - etc.
+
 You can also manually configure the Kotlin home location as follows:
 
 ```java
@@ -66,7 +79,7 @@ public void compile() throws Exception {
 }
 ```
 
-While older version of Kotlin are likely working with the extension, only version 1.9.24 or higher are officially
+While older version of Kotlin are likely working with the extension, only version 1.9.25 or higher are officially
 supported.
 
 ## Template Project

config/pmd.xml

@@ -7,9 +7,9 @@
     <!-- BEST PRACTICES -->
     <rule ref="category/java/bestpractices.xml">
         <exclude name="AvoidPrintStackTrace"/>
-        <exclude name="JUnit4TestShouldUseTestAnnotation"/>
-        <exclude name="JUnitTestContainsTooManyAsserts"/>
         <exclude name="GuardLogStatement"/>
+        <exclude name="UnitTestContainsTooManyAsserts"/>
+        <exclude name="UnitTestShouldUseTestAnnotation"/>
     </rule>
 
     <rule ref="category/java/bestpractices.xml/MissingOverride">

examples/.idea/libraries/bld.xml

@@ -2,12 +2,12 @@
   <library name="bld">
     <CLASSES>
       <root url="file://$PROJECT_DIR$/lib/bld" />
-      <root url="jar://$USER_HOME$/.bld/dist/bld-2.1.0.jar!/" />
+      <root url="jar://$USER_HOME$/.bld/dist/bld-2.2.1.jar!/" />
     </CLASSES>
     <JAVADOC />
     <SOURCES>
       <root url="file://$PROJECT_DIR$/lib/bld" />
-      <root url="jar://$USER_HOME$/.bld/dist/bld-2.1.0-sources.jar!/" />
+      <root url="jar://$USER_HOME$/.bld/dist/bld-2.2.1-sources.jar!/" />
     </SOURCES>
     <excluded>
       <root url="jar://$PROJECT_DIR$/lib/bld/bld-wrapper.jar!/" />

examples/.vscode/settings.json

@@ -9,7 +9,7 @@
     ],
     "java.configuration.updateBuildConfiguration": "automatic",
     "java.project.referencedLibraries": [
-        "${HOME}/.bld/dist/bld-2.1.0.jar",
+        "${HOME}/.bld/dist/bld-2.2.1.jar",
         "lib/**/*.jar"
     ]
 }

examples/lib/bld/bld-wrapper.properties

@@ -1,7 +1,7 @@
 bld.downloadExtensionJavadoc=false
 bld.downloadExtensionSources=true
 bld.downloadLocation=
-bld.extension-kotlin=com.uwyn.rife2:bld-kotlin:1.0.2
+bld.extension-kotlin=com.uwyn.rife2:bld-kotlin:1.1.0-SNAPSHOT
 bld.repositories=MAVEN_LOCAL,MAVEN_CENTRAL,RIFE2_SNAPSHOTS,RIFE2_RELEASES
 bld.sourceDirectories=
-bld.version=2.1.0
+bld.version=2.2.1

examples/src/bld/java/com/example/ExampleBuild.java

@@ -3,6 +3,8 @@ package com.example;
 import rife.bld.BuildCommand;
 import rife.bld.Project;
 import rife.bld.extension.CompileKotlinOperation;
+import rife.bld.extension.kotlin.CompileOptions;
+import rife.bld.extension.kotlin.JvmOptions;
 
 import java.io.File;
 import java.util.List;
@@ -28,13 +30,14 @@ public class ExampleBuild extends Project {
 
         repositories = List.of(MAVEN_LOCAL, MAVEN_CENTRAL, RIFE2_RELEASES);
 
-        final var kotlin = version(2, 0, 20);
+        final var kotlin = version(2, 1, 20);
         scope(compile)
                 .include(dependency("org.jetbrains.kotlin", "kotlin-stdlib", kotlin));
         scope(test)
                 .include(dependency("org.jetbrains.kotlin", "kotlin-test-junit5", kotlin))
-                .include(dependency("org.junit.jupiter", "junit-jupiter", version(5, 11, 0)))
+                .include(dependency("org.junit.jupiter", "junit-jupiter", version(5, 12, 2)))
-                .include(dependency("org.junit.platform", "junit-platform-console-standalone", version(1, 11, 0)));
+                .include(dependency("org.junit.platform", "junit-platform-console-standalone", version(1, 12, 2)))
+                .include(dependency("org.junit.platform", "junit-platform-launcher", version(1, 12, 2)));
 
         // Include the Kotlin source directory when creating or publishing sources Java Archives
         jarSourcesOperation().sourceDirectories(new File(srcMainDirectory(), "kotlin"));
@@ -59,13 +62,10 @@ public class ExampleBuild extends Project {
     public void compile() throws Exception {
         // The source code located in src/main/kotlin and src/test/kotlin will be compiled
         new CompileKotlinOperation()
-                .fromProject(this)
 //                .kotlinHome("path/to/kotlin")
 //                .kotlinc("path/to/kotlinc")
+                .compileOptions(new CompileOptions().verbose(true))
+                .fromProject(this)
                 .execute();
-
-//        var op = new CompileKotlinOperation().fromProject(this);
-//        op.compileOptions().verbose(true);
-//        op.execute();
     }
 }

lib/bld/bld-wrapper.properties

@@ -3,8 +3,8 @@ bld.downloadExtensionSources=true
 bld.downloadLocation=
 bld.javaOptions=
 bld.javacOptions=
-bld.extension-exec=com.uwyn.rife2:bld-exec:1.0.3
+bld.extension-exec=com.uwyn.rife2:bld-exec:1.0.5
-bld.extension-pmd=com.uwyn.rife2:bld-pmd:1.1.5
+bld.extension-pmd=com.uwyn.rife2:bld-pmd:1.2.2
 bld.repositories=MAVEN_CENTRAL,MAVEN_LOCAL,RIFE2_SNAPSHOTS,RIFE2_RELEASES
 bld.sourceDirectories=
-bld.version=2.1.0
+bld.version=2.2.1

scripts/checkcliargs.sh

@@ -4,7 +4,7 @@ new=/tmp/checkcliargs-new
 old=/tmp/checkcliargs-old
 
 kotlinc -h 2>$new
-~/.sdkman/candidates/kotlin/2.0.0/bin/kotlinc -h 2>$old
+~/.sdkman/candidates/kotlin/2.1.10/bin/kotlinc -h 2>$old
 
 code --diff --wait $old $new
 

src/bld/java/rife/bld/extension/CompileKotlinOperationBuild.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2024 the original author or authors.
+ * Copyright 2023-2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,6 +23,7 @@ import rife.bld.publish.PublishLicense;
 import rife.bld.publish.PublishScm;
 
 import java.util.List;
+import java.util.Locale;
 
 import static rife.bld.dependencies.Repository.*;
 import static rife.bld.dependencies.Scope.compile;
@@ -33,7 +34,7 @@ public class CompileKotlinOperationBuild extends Project {
     public CompileKotlinOperationBuild() {
         pkg = "rife.bld.extension";
         name = "bld-kotlin";
-        version = version(1, 0, 2);
+        version = version(1, 1, 0, "SNAPSHOT");
 
         javaRelease = 17;
 
@@ -43,11 +44,11 @@ public class CompileKotlinOperationBuild extends Project {
         repositories = List.of(MAVEN_LOCAL, MAVEN_CENTRAL, RIFE2_RELEASES, RIFE2_SNAPSHOTS);
 
         scope(compile)
-                .include(dependency("com.uwyn.rife2", "bld", version(2, 1, 0)));
+                .include(dependency("com.uwyn.rife2", "bld", version(2, 2, 1)));
         scope(test)
-                .include(dependency("org.junit.jupiter", "junit-jupiter", version(5, 11, 0)))
+                .include(dependency("org.junit.jupiter", "junit-jupiter", version(5, 12, 2)))
-                .include(dependency("org.junit.platform", "junit-platform-console-standalone", version(1, 11, 0)))
+                .include(dependency("org.junit.platform", "junit-platform-console-standalone", version(1, 12, 2)))
-                .include(dependency("org.assertj", "assertj-core", version(3, 26, 3)));
+                .include(dependency("org.assertj", "assertj-core", version(3, 27, 3)));
 
         javadocOperation()
                 .javadocOptions()
@@ -97,10 +98,13 @@ public class CompileKotlinOperationBuild extends Project {
 
     @Override
     public void test() throws Exception {
-        new ExecOperation()
+        var os = System.getProperty("os.name");
-                .fromProject(this)
+        if (os != null && os.toLowerCase(Locale.US).contains("linux")) {
-                .command("scripts/cliargs.sh")
+            new ExecOperation()
-                .execute();
+                    .fromProject(this)
+                    .command("scripts/cliargs.sh")
+                    .execute();
+        }
         super.test();
     }
 }

src/main/java/rife/bld/extension/CompileKotlinOperation.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2024 the original author or authors.
+ * Copyright 2023-2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,16 +19,16 @@ package rife.bld.extension;
 import rife.bld.BaseProject;
 import rife.bld.extension.kotlin.CompileOptions;
 import rife.bld.extension.kotlin.CompilerPlugin;
+import rife.bld.extension.kotlin.JvmOptions;
 import rife.bld.operations.AbstractOperation;
 import rife.bld.operations.exceptions.ExitStatusException;
 import rife.tools.FileUtils;
 
 import java.io.File;
 import java.io.IOException;
+import java.nio.file.Files;
 import java.nio.file.Path;
-import java.util.ArrayList;
+import java.util.*;
-import java.util.Collection;
-import java.util.List;
 import java.util.logging.Level;
 import java.util.logging.Logger;
 
@@ -40,8 +40,12 @@ import java.util.logging.Logger;
  */
 public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOperation> {
     private static final Logger LOGGER = Logger.getLogger(CompileKotlinOperation.class.getName());
+    private static final String OS_NAME =
+            System.getProperty("os.name") != null ? System.getProperty("os.name").toLowerCase(Locale.US) : null;
+    private static final String KOTLINC_EXECUTABLE = "kotlinc" + (isWindows() ? ".bat" : "");
     private final Collection<String> compileMainClasspath_ = new ArrayList<>();
     private final Collection<String> compileTestClasspath_ = new ArrayList<>();
+    private final JvmOptions jvmOptions_ = new JvmOptions();
     private final Collection<File> mainSourceDirectories_ = new ArrayList<>();
     private final Collection<File> mainSourceFiles_ = new ArrayList<>();
     private final Collection<String> plugins_ = new ArrayList<>();
@@ -55,6 +59,184 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
     private BaseProject project_;
     private File workDir_;
 
+    private static String findKotlincInDir(String directory) {
+        var kotlinc = new File(directory, KOTLINC_EXECUTABLE);
+
+        if (isExecutable(kotlinc)) {
+            return kotlinc.getAbsolutePath();
+        }
+
+        // Check bin subdirectory if it exists
+        var binDir = new File(directory, "bin");
+        if (binDir.isDirectory()) {
+            kotlinc = new File(binDir, KOTLINC_EXECUTABLE);
+            if (isExecutable(kotlinc)) {
+                return kotlinc.getAbsolutePath();
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Locates the Kotlin compiler (kotlinc) executable.
+     *
+     * @return The path to the kotlinc executable, or {@code kotlinc}/{@code kotlinc.bat} if not found.
+     * @since 1.1.0
+     */
+    public static String findKotlincPath() {
+        return findKotlincPath(false);
+    }
+
+    /**
+     * Locates the Kotlin compiler (kotlinc) executable.
+     *
+     * @param isSilent do not log the path to the kotlinc executable, if {@code true}
+     * @return The path to the kotlinc executable, or {@code kotlinc}/{@code kotlinc.bat} if not found.
+     * @since 1.1.0
+     */
+    public static String findKotlincPath(boolean isSilent) {
+        String kotlincPath;
+
+        // Check KOTLIN_HOME environment variable first
+        var kotlinHome = System.getenv("KOTLIN_HOME");
+        if (kotlinHome != null && !kotlinHome.isEmpty()) {
+            kotlincPath = findKotlincInDir(kotlinHome);
+            if (kotlincPath != null) {
+                logKotlincPath(kotlincPath, isSilent, "KOTLIN_HOME");
+                return kotlincPath;
+            }
+        }
+
+        // Check PATH environment variable
+        var pathEnv = System.getenv("PATH");
+        if (pathEnv != null && !pathEnv.isEmpty()) {
+            var pathDirs = pathEnv.split(File.pathSeparator);
+            for (var dir : pathDirs) {
+                kotlincPath = findKotlincInDir(dir);
+                if (kotlincPath != null) {
+                    logKotlincPath(kotlincPath, isSilent, "PATH");
+                    return kotlincPath;
+                }
+            }
+        }
+
+        // Common installation paths (e.g., SDKMAN!, IntelliJ IDEA, etc.)
+        var commonPaths = new LinkedHashMap<String, String>();
+
+        if (isLinux()) {
+            var userHome = System.getProperty("user.home");
+            if (userHome != null) {
+                commonPaths.put(userHome + "/.sdkman/candidates/kotlin/current/bin", "SDKMAN!");
+            }
+            commonPaths.put("/snap/bin", "Kotlin (Snap)");
+            commonPaths.put("/usr/bin", null);
+            commonPaths.put("/usr/share", null);
+            commonPaths.put("/usr/local/bin", null);
+            commonPaths.put("/usr/local/kotlin/bin", null);
+            commonPaths.put("/usr/share/kotlin/bin/", null);
+            commonPaths.put("/opt/kotlin/bin", null);
+            if (userHome != null) {
+                commonPaths.put(userHome + "/.local/share/JetBrains/Toolbox/apps/intellij-idea-ultimate/plugins/Kotlin/kotlinc/bin",
+                        "IntelliJ IDEA Ultimate");
+                commonPaths.put(userHome + "/.local/share/JetBrains/Toolbox/apps/intellij-idea-community-edition/plugins/Kotlin/kotlinc/bin",
+                        "IntelliJ IDEA Community Edition");
+                commonPaths.put(userHome + "/.local/share/JetBrains/Toolbox/apps/android-studio/plugins/Kotlin/kotlinc/bin",
+                        "Android Studio");
+            }
+            commonPaths.put("/snap/intellij-idea-ultimate/current/commons/plugins/Kotlin/kotlinc/bin",
+                    "IntelliJ IDEA Ultimate (Snap)");
+            commonPaths.put("/snap/intellij-idea-community/current/commons/plugins/Kotlin/kotlinc/bin",
+                    "IntelliJ IDEA Community Edition (Snap)");
+            commonPaths.put("/snap/android-studio/current/android-studio/commons/plugins/Kotlin/kotlinc/bin",
+                    "Android Studio (Snap)");
+        } else if (isWindows()) {
+            commonPaths.put("C:\\tools\\kotlinc\\bin", null);
+            var localAppData = System.getenv("LOCALAPPDATA");
+            if (localAppData != null) {
+                commonPaths.put(localAppData + "\\Programs\\IntelliJ IDEA Ultimate\\plugins\\Kotlin\\kotlinc\\bin",
+                        "IntelliJ IDEA Ultimate");
+                commonPaths.put(localAppData + "\\Programs\\IntelliJ IDEA Community Edition\\plugins\\Kotlin\\kotlinc\\bin",
+                        "IntelliJ IDEA Community Edition");
+                commonPaths.put(localAppData + "\\Programs\\Android Studio\\plugins\\Kotlin\\kotlinc\\bin",
+                        "Android Studio");
+            }
+            var programFiles = System.getenv("ProgramFiles");
+            if (programFiles != null) {
+                commonPaths.put(programFiles + "\\Kotlin\\bin", null);
+            }
+        } else if (isMacOS()) {
+            var userHome = System.getProperty("user.home");
+            if (userHome != null) {
+                commonPaths.put(userHome + "/.sdkman/candidates/kotlin/current/bin", "SDKMAN!");
+            }
+            commonPaths.put("/opt/homebrew/bin", "Homebrew");
+            commonPaths.put("/usr/local/bin", null);
+            commonPaths.put("/Applications/IntelliJ IDEA.app/Contents/plugins/Kotlin/kotlinc/bin/",
+                    "IntelliJ IDEA");
+            commonPaths.put("/Applications/IntelliJ IDEA Community Edition.app/Contents/plugins/Kotlin/kotlinc/bin/",
+                    "IntelliJ IDEA Community Edition");
+            commonPaths.put("/Applications/Android Studio.app/Contents/plugins/Kotlin/kotlinc/bin",
+                    "Android Studio");
+        }
+
+        for (var path : commonPaths.keySet()) {
+            kotlincPath = findKotlincInDir(path);
+            if (kotlincPath != null) {
+                logKotlincPath(kotlincPath, isSilent, commonPaths.get(path));
+                return kotlincPath;
+            }
+        }
+
+        // Try 'which' or 'where' commands (less reliable but sometimes works)
+        try {
+            Process process;
+            if (isWindows()) {
+                process = Runtime.getRuntime().exec("where kotlinc");
+            } else {
+                process = Runtime.getRuntime().exec("which kotlinc");
+            }
+
+            try (var scanner = new Scanner(process.getInputStream())) {
+                if (scanner.hasNextLine()) {
+                    kotlincPath = scanner.nextLine().trim();
+                    if (isExecutable(new File(kotlincPath))) {
+                        logKotlincPath(kotlincPath, isSilent);
+                        return kotlincPath;
+                    }
+                }
+            }
+        } catch (Exception ignored) {
+            // Ignore exceptions from which/where, as they might not be available
+        }
+
+        return KOTLINC_EXECUTABLE;
+    }
+
+    private static boolean isExecutable(File file) {
+        return file != null && file.exists() && file.isFile() && file.canExecute();
+    }
+
+    /**
+     * Determines if the operating system is Linux.
+     *
+     * @return true if the operating system is Linux, false otherwise.
+     * @since 1.1.0
+     */
+    public static boolean isLinux() {
+        return OS_NAME != null && (OS_NAME.contains("linux") || OS_NAME.contains("unix")); // Consider Unix-like systems as well.
+    }
+
+    /**
+     * Determines if the current operating system is macOS.
+     *
+     * @return true if the OS is macOS, false otherwise.
+     * @since 1.1.0
+     */
+    public static boolean isMacOS() {
+        return OS_NAME != null && (OS_NAME.contains("mac") || OS_NAME.contains("darwin") || OS_NAME.contains("osx"));
+    }
+
     /**
      * Determines if the given string is not blank.
      *
@@ -65,6 +247,30 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
         return s != null && !s.isBlank();
     }
 
+    /**
+     * Determines if the current operating system is Windows.
+     *
+     * @return true if the operating system is Windows, false otherwise.
+     * @since 1.1.0
+     */
+    public static boolean isWindows() {
+        return OS_NAME != null && OS_NAME.contains("win");
+    }
+
+    private static void logKotlincPath(String kotlincPath, boolean isSilent) {
+        logKotlincPath(kotlincPath, isSilent, null);
+    }
+
+    private static void logKotlincPath(String kotlincPath, boolean isSilent, String from) {
+        if (LOGGER.isLoggable(Level.INFO) && !isSilent) {
+            if (from != null) {
+                LOGGER.info("Using Kotlin compiler inferred from " + from + ": " + kotlincPath);
+            } else {
+                LOGGER.info("Using Kotlin compiler found at: " + kotlincPath);
+            }
+        }
+    }
+
     /**
      * Provides the main build destination directory.
      *
@@ -145,6 +351,17 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
         return buildTestDirectory_;
     }
 
+    private String cleanPath(File path) {
+        return cleanPath(path.getAbsolutePath());
+    }
+
+    private String cleanPath(String path) {
+        if (isWindows()) {
+            return path.replaceAll("\\\\", "\\\\\\\\");
+        }
+        return path;
+    }
+
     /**
      * Provides entries for the main compilation classpath.
      *
@@ -284,6 +501,12 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
     protected void executeBuildSources(Collection<String> classpath, Collection<File> sources, File destination,
                                        File friendPaths)
             throws ExitStatusException {
+
+        var cp = new ArrayList<String>();
+        if (classpath != null && !classpath.isEmpty()) {
+            cp.addAll(classpath);
+        }
+
         if (sources.isEmpty()) {
             if (!silent() && LOGGER.isLoggable(Level.WARNING)) {
                 LOGGER.warning("Nothing to compile.");
@@ -296,49 +519,84 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
             throw new ExitStatusException(ExitStatusException.EXIT_FAILURE);
         }
 
+        var command = new ArrayList<String>();
         var args = new ArrayList<String>();
 
         // kotlinc
-        args.add(kotlinCompiler());
+        if (kotlinc_ != null) {
+            command.add(kotlinc_.getAbsolutePath());
+        } else if (kotlinHome_ != null) {
+            var kotlinc = findKotlincInDir(kotlinHome_.getAbsolutePath());
+            if (kotlinc != null) {
+                command.add(kotlinc);
+            } else {
+                if (LOGGER.isLoggable(Level.SEVERE) && !silent()) {
+                    LOGGER.severe("Could not locate Kotlin compiler in: " + kotlinHome_);
+                }
+                throw new ExitStatusException(ExitStatusException.EXIT_FAILURE);
+            }
+        } else {
+            command.add(findKotlincPath(silent()));
+        }
+
+        // JVM options
+        if (!jvmOptions_.isEmpty()) {
+            jvmOptions_.forEach(s -> command.add("-J" + s));
+        }
 
         // classpath
-        if (classpath != null && !classpath.isEmpty()) {
+        if (compileOptions_ != null && !compileOptions_.classpath().isEmpty()) {
+            cp.addAll(compileOptions_.classpath().stream().map(this::cleanPath).toList());
+        }
+        if (!cp.isEmpty()) {
             args.add("-cp");
-            args.add(FileUtils.joinPaths(classpath.stream().toList()));
+            args.add('"' + FileUtils.joinPaths(cp.stream().map(this::cleanPath).toList()) + '"');
+        }
+
+        // compile options
+        if (compileOptions_ != null && !compileOptions_.args().isEmpty()) {
+            args.addAll(compileOptions_.args());
         }
 
         // destination
         args.add("-d");
-        args.add(destination.getAbsolutePath());
+        args.add('"' + cleanPath(destination) + '"');
 
         // friend-path
         if (friendPaths != null && friendPaths.exists()) {
-            args.add("-Xfriend-paths=" + friendPaths.getAbsolutePath());
+            args.add("-Xfriend-paths=\"" + cleanPath(friendPaths) + '"');
-        }
-
-        // options
-        if (compileOptions_ != null) {
-            args.addAll(compileOptions_.args());
         }
 
         // plugins
         if (!plugins_.isEmpty()) {
-            plugins_.forEach(p -> args.add("-Xplugin=" + p));
+            plugins_.forEach(p -> args.add("-Xplugin=\"" + cleanPath(p) + '"'));
         }
 
         // sources
-        sources.forEach(f -> args.add(f.getAbsolutePath()));
+        sources.forEach(f -> args.add('"' + cleanPath(f) + '"'));
 
+        var argsLine = String.join(" ", args);
+
+        // log the command line
         if (LOGGER.isLoggable(Level.FINE) && !silent()) {
-            LOGGER.fine(String.join(" ", args));
+            LOGGER.fine(String.join(" ", command) + " " + argsLine);
         }
 
-        var pb = new ProcessBuilder();
-        pb.inheritIO();
-        pb.command(args);
-        pb.directory(workDir_);
-
         try {
+            // create and write the @argfile
+            var argsFile = File.createTempFile("bld-kotlinc-", ".args");
+            argsFile.deleteOnExit();
+
+            Files.write(argsFile.toPath(), argsLine.getBytes());
+
+            command.add("@" + argsFile.getAbsolutePath());
+
+            // run the command
+            var pb = new ProcessBuilder();
+            pb.inheritIO();
+            pb.command(command);
+            pb.directory(workDir_);
+
             var proc = pb.start();
             proc.waitFor();
             ExitStatusException.throwOnFailure(proc.exitValue());
@@ -374,19 +632,41 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
      */
     protected void executeCreateBuildDirectories() throws IOException {
         if (buildMainDirectory() != null && !buildMainDirectory().exists() && !buildMainDirectory().mkdirs()) {
-            throw new IOException("Could not created build main directory: " + buildMainDirectory().getAbsolutePath());
+            throw new IOException("Could not create build main directory: " + buildMainDirectory().getAbsolutePath());
         }
         if (buildTestDirectory() != null && !buildTestDirectory().exists() && !buildTestDirectory().mkdirs()) {
-            throw new IOException("Could not created build test directory: " + buildTestDirectory().getAbsolutePath());
+            throw new IOException("Could not create build test directory: " + buildTestDirectory().getAbsolutePath());
         }
     }
 
+    private File findKotlinHome() {
+        // Deduct from kotlinc location if provided
+        if (kotlinc_ != null) {
+            var parent = kotlinc_.getParentFile();
+            if (parent != null && parent.isDirectory()) {
+                if (parent.getPath().endsWith("bin")) {
+                    if (parent.getParentFile() != null && parent.getParentFile().isDirectory()) {
+                        return parent.getParentFile();
+                    }
+                } else {
+                    return parent;
+                }
+            }
+        } else {
+            var kotlinHome = System.getenv("KOTLIN_HOME");
+            if (kotlinHome != null) {
+                return new File(kotlinHome);
+            }
+        }
+
+        return null;
+    }
+
     /**
      * Configures a compile operation from a {@link BaseProject}.
      * <p>
      * Sets the following from the project:
      * <ul>
-     *     <li>{@link #kotlinHome() kotlinHome} to the {@code KOTLIN_HOME} environment variable, if set.</li>
      *     <li>{@link #workDir() workDir} to the project's directory.</li>
      *     <li>{@link #buildMainDirectory() buildMainDirectory}</li>
      *     <li>{@link #buildTestDirectory() buildTestDirectory}</li>
@@ -405,12 +685,6 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
      */
     public CompileKotlinOperation fromProject(BaseProject project) {
         project_ = project;
-
-        var env = System.getenv("KOTLIN_HOME");
-        if (env != null) {
-            kotlinHome_ = new File(env);
-        }
-
         workDir_ = new File(project.workDirectory().getAbsolutePath());
 
         var op = buildMainDirectory(project.buildMainDirectory())
@@ -435,16 +709,34 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
         return op;
     }
 
-    private String kotlinCompiler() {
+    /**
-        if (kotlinc_ != null) {
+     * Retrieves the Java Virtual Machine options.
-            return kotlinc_.getAbsolutePath();
+     *
-        } else if (kotlinHome_ != null) {
+     * @return the JVM options
-            var kotlinc = Path.of(kotlinHome_.getAbsolutePath(), "bin", "kotlinc").toFile();
+     */
-            if (kotlinc.exists() && kotlinc.canExecute()) {
+    public JvmOptions jvmOptions() {
-                return kotlinc.getAbsolutePath();
+        return jvmOptions_;
-            }
+    }
-        }
+
-        return "kotlinc";
+    /**
+     * Pass an option directly to the Java Virtual Machine
+     *
+     * @param jvmOptions the JVM options
+     * @return this operation instance
+     */
+    public CompileKotlinOperation jvmOptions(Collection<String> jvmOptions) {
+        jvmOptions_.addAll(jvmOptions);
+        return this;
+    }
+
+    /**
+     * Pass an option directly to the Java Virtual Machine
+     *
+     * @param jvmOptions one or more JVM option
+     * @return this operation instance
+     */
+    public CompileKotlinOperation jvmOptions(String... jvmOptions) {
+        return jvmOptions(List.of(jvmOptions));
     }
 
     /**
@@ -753,15 +1045,17 @@ public class CompileKotlinOperation extends AbstractOperation<CompileKotlinOpera
      * @see #plugins(File, CompilerPlugin...)
      */
     public CompileKotlinOperation plugins(CompilerPlugin... plugins) {
-        if (kotlinHome_ != null) {
+        var kotlinHome = kotlinHome_;
-            var kotlinLib = new File(kotlinHome_, "lib");
+        if (kotlinHome == null) {
+            kotlinHome = findKotlinHome();
+        }
+        if (kotlinHome != null) {
+            var kotlinLib = new File(kotlinHome, "lib");
             for (var plugin : plugins) {
                 plugins(kotlinLib, plugin);
             }
-        } else {
+        } else if (LOGGER.isLoggable(Level.WARNING) && !silent()) {
-            if (LOGGER.isLoggable(Level.WARNING) && !silent()) {
+            LOGGER.warning("The Kotlin home must be set (or discovered) to specify compiler plugins directly.");
-                LOGGER.warning("The Kotlin home must be set to specify compiler plugins directly.");
-            }
         }
         return this;
     }

src/main/java/rife/bld/extension/kotlin/CompileOptions.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2024 the original author or authors.
+ * Copyright 2023-2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,13 +17,18 @@
 package rife.bld.extension.kotlin;
 
 import rife.bld.extension.CompileKotlinOperation;
+import rife.bld.operations.AbstractToolProviderOperation;
 
 import java.io.File;
+import java.io.IOException;
+import java.nio.charset.Charset;
+import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.ArrayList;
 import java.util.Collection;
 import java.util.List;
-import java.util.stream.Collectors;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
 import static rife.bld.extension.CompileKotlinOperation.isNotBlank;
 
@@ -34,10 +39,10 @@ import static rife.bld.extension.CompileKotlinOperation.isNotBlank;
  * @since 1.0
  */
 public class CompileOptions {
+    private static final Logger LOGGER = Logger.getLogger(CompileOptions.class.getName());
     private final Collection<String> advancedOptions_ = new ArrayList<>();
     private final Collection<File> argFile_ = new ArrayList<>();
     private final Collection<File> classpath_ = new ArrayList<>();
-    private final Collection<String> jvmOptions_ = new ArrayList<>();
     private final Collection<String> optIn_ = new ArrayList<>();
     private final Collection<String> options_ = new ArrayList<>();
     private final Collection<String> plugin_ = new ArrayList<>();
@@ -60,6 +65,7 @@ public class CompileOptions {
     private boolean progressive_;
     private boolean verbose_;
     private boolean wError_;
+    private boolean wExtra_;
 
     /**
      * Specify advanced compiler options.
@@ -111,7 +117,6 @@ public class CompileOptions {
         return this;
     }
 
-
     /**
      * Allow using declarations only from the specified version of Kotlin bundled libraries.
      *
@@ -250,13 +255,27 @@ public class CompileOptions {
 
         // @argfile
         if (!argFile_.isEmpty()) {
-            argFile_.forEach(f -> args.add("@" + f.getAbsolutePath()));
+            argFile_.forEach(f -> {
-        }
+                if (f.exists()) {
-
+                    try {
-        // classpath
+                        try (var reader = Files.newBufferedReader(f.toPath(), Charset.defaultCharset())) {
-        if (!classpath_.isEmpty()) {
+                            var tokenizer = new AbstractToolProviderOperation.CommandLineTokenizer(reader);
-            args.add("-classpath");
+                            String token;
-            args.add(classpath_.stream().map(File::getAbsolutePath).collect(Collectors.joining(File.pathSeparator)));
+                            while ((token = tokenizer.nextToken()) != null) {
+                                args.add(token);
+                            }
+                        }
+                    } catch (IOException e) {
+                        if (LOGGER.isLoggable(Level.WARNING)) {
+                            LOGGER.log(Level.WARNING, "Could not read: " + f.getAbsolutePath(), e);
+                        }
+                    }
+                } else {
+                    if (LOGGER.isLoggable(Level.WARNING)) {
+                        LOGGER.warning("File not found: " + f.getAbsolutePath());
+                    }
+                }
+            });
         }
 
         // expression
@@ -292,11 +311,6 @@ public class CompileOptions {
             args.add("-Xjdk-release=" + jdkRelease_);
         }
 
-        // JVM options
-        if (!jvmOptions_.isEmpty()) {
-            jvmOptions_.forEach(s -> args.add("-J" + s));
-        }
-
         // kotlin-home
         if (kotlinHome_ != null) {
             args.add("-kotlin-home");
@@ -379,9 +393,20 @@ public class CompileOptions {
             args.add("-Werror");
         }
 
-        // advanced option (X)
+        // Wextra
+        if (wExtra_) {
+            args.add("-Wextra");
+        }
+
+        // advanced options (X)
         if (!advancedOptions_.isEmpty()) {
-            advancedOptions_.forEach(it -> args.add("-X" + it));
+            advancedOptions_.forEach(it -> {
+                if (it.startsWith("-X")) {
+                    args.add(it);
+                } else {
+                    args.add("-X" + it);
+                }
+            });
         }
 
         return args;
@@ -597,6 +622,15 @@ public class CompileOptions {
         return wError_;
     }
 
+    /**
+     * Indicates whether additional declaration, expression, and type compiler checks emit warnings.
+     *
+     * @return {@code true} or {@code false}
+     */
+    public boolean isWExtra() {
+        return wExtra_;
+    }
+
     /**
      * Generate metadata for Java 1.8 reflection on method parameters.
      *
@@ -663,7 +697,7 @@ public class CompileOptions {
      * Limit the API of the JDK in the classpath to the specified Java version. Automatically sets
      * {@link #jvmTarget(String) JVM target} version.
      * <p>
-     * Possible values are 1.8, 9, 10, ..., 22. The default value is 1.8.
+     * Possible values are 1.8, 9, 10, ..., 23. The default value is 1.8.
      *
      * @param version the target version
      * @return this operation instance
@@ -678,8 +712,6 @@ public class CompileOptions {
      * <p>
      * Limit the API of the JDK in the classpath to the specified Java version. Automatically sets
      * {@link #jvmTarget(String) JVM target} version.
-     * <p>
-     * Possible values are 1.8, 9, 10, ..., 22. The default value is 1.8.
      *
      * @param version the target version
      * @return this operation instance
@@ -689,36 +721,6 @@ public class CompileOptions {
         return jdkRelease(String.valueOf(version));
     }
 
-    /**
-     * Retrieves the Java Virtual Machine options.
-     *
-     * @return the JVM options
-     */
-    public Collection<String> jvmOptions() {
-        return jvmOptions_;
-    }
-
-    /**
-     * Pass an option directly to Java Virtual Machine
-     *
-     * @param jvmOptions the JVM options
-     * @return this operation instance
-     */
-    public CompileOptions jvmOptions(Collection<String> jvmOptions) {
-        jvmOptions_.addAll(jvmOptions);
-        return this;
-    }
-
-    /**
-     * Pass an option directly to JVM
-     *
-     * @param jvmOptions one or more JVM option
-     * @return this operation instance
-     */
-    public CompileOptions jvmOptions(String... jvmOptions) {
-        return jvmOptions(List.of(jvmOptions));
-    }
-
     /**
      * Specify the target version of the generated JVM bytecode.
      *
@@ -733,7 +735,7 @@ public class CompileOptions {
     /**
      * Specify the target version of the generated JVM bytecode.
      * <p>
-     * Possible values are 1.8, 9, 10, ..., 22. The default value is 1.8.
+     * Possible values are 1.8, 9, 10, ..., 23. The default value is 1.8.
      *
      * @param target the target version
      * @return this operation instance
@@ -1071,4 +1073,15 @@ public class CompileOptions {
         wError_ = wError;
         return this;
     }
+
+    /**
+     * Enable additional declaration, expression, and type compiler checks that emit warnings if {@code true}.
+     *
+     * @param wExtra {@code true} or {@code false}
+     * @return this operation instance
+     */
+    public CompileOptions wExtra(boolean wExtra) {
+        wExtra_ = wExtra;
+        return this;
+    }
 }

src/main/java/rife/bld/extension/kotlin/CompilerPlugin.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2024 the original author or authors.
+ * Copyright 2023-2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@
 package rife.bld.extension.kotlin;
 
 /**
+ * @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
  * Defines the known Kotlin compiler plugin JARs.
  *
  * @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
@@ -25,6 +26,8 @@ package rife.bld.extension.kotlin;
 public enum CompilerPlugin {
     ALL_OPEN("allopen-compiler-plugin.jar"),
     ASSIGNMENT("assignment-compiler-plugin.jar"),
+    COMPOSE("compose-compiler-plugin.jar"),
+    KOTLIN_IMPORTS_DUMPER("kotlin-imports-dumper-compiler-plugin.jar"),
     KOTLINX_SERIALIZATION("kotlinx-serialization-compiler-plugin.jar"),
     KOTLIN_SERIALIZATION("kotlin-serialization-compiler-plugin.jar"),
     LOMBOK("lombok-compiler-plugin.jar"),

src/main/java/rife/bld/extension/kotlin/JvmOptions.java

@@ -0,0 +1,90 @@
+/*
+ * Copyright 2023-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package rife.bld.extension.kotlin;
+
+import rife.tools.StringUtils;
+
+import java.io.Serial;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * Java Virtual Machine options.
+ *
+ * @author <a href="https://erik.thauvin.net/">Erik C. Thauvin</a>
+ * @since 1.1.0
+ */
+@SuppressWarnings("PMD.LooseCoupling")
+public class JvmOptions extends ArrayList<String> {
+    /**
+     * Keyword to enable native access for all code on the class path.
+     */
+    public final static String ALL_UNNAMED = "ALL-UNNAMED";
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * Modules that are permitted to perform restricted native operations.
+     * The module name can also be {@link #ALL_UNNAMED}.
+     *
+     * @param modules the module names
+     * @return this list of options
+     */
+    public JvmOptions enableNativeAccess(String... modules) {
+        return enableNativeAccess(List.of(modules));
+    }
+
+    /**
+     * Modules that are permitted to perform restricted native operations.
+     * The module name can also be {@link #ALL_UNNAMED}.
+     *
+     * @param modules the module names
+     * @return this list of options
+     */
+    public JvmOptions enableNativeAccess(Collection<String> modules) {
+        add("--enable-native-access=" + StringUtils.join(modules, ","));
+        return this;
+    }
+
+    /**
+     * Controls what action the Java runtime takes when native access is not enabled for a module.
+     *
+     * @param access the access mode
+     * @return this list of options
+     */
+    public JvmOptions illegalNativeAccess(NativeAccess access) {
+        add("--illegal-native-access=" + access.mode);
+        return this;
+    }
+
+    /**
+     * Illegal native access modes.
+     */
+    public enum NativeAccess {
+        ALLOW("allow"),
+        DENY("deny"),
+        WARN("warn");
+
+        public final String mode;
+
+        NativeAccess(String mode) {
+            this.mode = mode;
+        }
+    }
+}

src/test/java/rife/bld/extension/CompileKotlinOperationTest.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2024 the original author or authors.
+ * Copyright 2023-2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -23,6 +23,7 @@ import rife.bld.BaseProject;
 import rife.bld.blueprints.BaseProjectBlueprint;
 import rife.bld.extension.kotlin.CompileOptions;
 import rife.bld.extension.kotlin.CompilerPlugin;
+import rife.bld.extension.kotlin.JvmOptions;
 import rife.tools.FileUtils;
 
 import java.io.File;
@@ -30,6 +31,7 @@ import java.nio.file.Files;
 import java.nio.file.Path;
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Locale;
 import java.util.Objects;
 import java.util.logging.ConsoleHandler;
 import java.util.logging.Level;
@@ -86,7 +88,7 @@ class CompileKotlinOperationTest {
     @Test
     void testCollections() {
         var op = new CompileKotlinOperation()
-                .fromProject(new BaseProjectBlueprint(new File("examples"), "com.example", "Example"))
+                .fromProject(new BaseProjectBlueprint(new File("examples"), "com.example", "Example", "Example"))
                 .kotlinHome("/kotlin_home")
                 .kotlinc("kotlinc")
                 .workDir("work_dir")
@@ -103,11 +105,11 @@ class CompileKotlinOperationTest {
                 .testSourceFiles(List.of(new File("tfile3"), new File("tfile4")))
                 .testSourceFiles(new File("tfile5"), new File("tfile6"))
                 .plugins("plugin1", "plugin2")
-                .plugins(CompilerPlugin.KOTLIN_SERIALIZATION, CompilerPlugin.ASSIGNMENT)
+                .plugins(CompilerPlugin.KOTLIN_SERIALIZATION, CompilerPlugin.ASSIGNMENT, CompilerPlugin.COMPOSE)
                 .plugins(new File("lib/compile"), CompilerPlugin.LOMBOK, CompilerPlugin.POWER_ASSERT)
-                .plugins(Path.of("lib/compile"), CompilerPlugin.NOARG, CompilerPlugin.ALL_OPEN)
+                .plugins(Path.of("lib/compile"), CompilerPlugin.NOARG, CompilerPlugin.ALL_OPEN,
+                        CompilerPlugin.KOTLIN_IMPORTS_DUMPER)
                 .plugins("lib/compile", CompilerPlugin.KOTLINX_SERIALIZATION, CompilerPlugin.SAM_WITH_RECEIVER)
-
                 .plugins(List.of("plugin3", "plugin4"));
 
         try (var softly = new AutoCloseableSoftAssertions()) {
@@ -131,12 +133,14 @@ class CompileKotlinOperationTest {
                     new File("tfile1"), new File("tfile2"), new File("tfile3"),
                     new File("tfile4"), new File("tfile5"), new File("tfile6"));
             softly.assertThat(op.plugins()).as("plugins").contains("plugin1", "plugin2", "plugin3", "plugin4",
-                    "/kotlin_home/lib/kotlin-serialization-compiler-plugin.jar",
+                    new File("/kotlin_home/lib/kotlin-serialization-compiler-plugin.jar").getAbsolutePath(),
-                    "/kotlin_home/lib/assignment-compiler-plugin.jar",
+                    new File("/kotlin_home/lib/assignment-compiler-plugin.jar").getAbsolutePath(),
+                    new File("/kotlin_home/lib/compose-compiler-plugin.jar").getAbsolutePath(),
                     new File("lib/compile", "lombok-compiler-plugin.jar").getAbsolutePath(),
                     new File("lib/compile", "power-assert-compiler-plugin.jar").getAbsolutePath(),
                     new File("lib/compile", "noarg-compiler-plugin.jar").getAbsolutePath(),
                     new File("lib/compile", "allopen-compiler-plugin.jar").getAbsolutePath(),
+                    new File("lib/compile", "kotlin-imports-dumper-compiler-plugin.jar").getAbsolutePath(),
                     new File("lib/compile", "kotlinx-serialization-compiler-plugin.jar").getAbsolutePath(),
                     new File("lib/compile", "sam-with-receiver-compiler-plugin.jar").getAbsolutePath());
         }
@@ -167,8 +171,7 @@ class CompileKotlinOperationTest {
             }
 
             var op = new CompileKotlinOperation()
-                    .fromProject(new BaseProjectBlueprint(new File("examples"), "com.example",
+                    .fromProject(new BaseProjectBlueprint(new File("examples"), "com.example", "Example", "Example"))
-                            "Example"))
                     .buildMainDirectory(mainDir)
                     .buildTestDirectory(testDir)
                     .compileMainClasspath(compileJars)
@@ -177,10 +180,16 @@ class CompileKotlinOperationTest {
                     .compileTestClasspath(mainDir.getAbsolutePath());
 
             op.compileOptions().verbose(true);
-            op.compileOptions().jdkRelease("17");
+            op.compileOptions().argFile("src/test/resources/argfile.txt", "src/test/resources/argfile2.txt");
+
+            if (!CompileKotlinOperation.isWindows()) {
+                op.jvmOptions().enableNativeAccess(JvmOptions.ALL_UNNAMED);
+                assertThat(op.jvmOptions()).containsExactly("--enable-native-access=ALL-UNNAMED");
+            }
 
             var args = op.compileOptions().args();
-            var matches = List.of("-Xjdk-release=17", "-no-stdlib", "-verbose");
+            var matches = List.of("-Xjdk-release=17", "-no-reflect", "-progressive", "-include-runtime", "-no-stdlib",
+                    "-verbose");
             assertThat(args).as(args + " == " + matches).isEqualTo(matches);
 
             op.execute();
@@ -205,14 +214,43 @@ class CompileKotlinOperationTest {
         }
     }
 
+    @Test
+    void testFindKotlincPath() {
+        assertThat(CompileKotlinOperation.findKotlincPath()).doesNotStartWith("kotlinc");
+    }
+
+    @Test
+    void testFromProject() {
+        var examples = new File("examples");
+        var op = new CompileKotlinOperation().fromProject(
+                new BaseProjectBlueprint(examples, "com.example", "examples", "examples"));
+        assertThat(op.mainSourceDirectories()).containsExactly(new File(examples, "src/main/kotlin"));
+        assertThat(op.testSourceDirectories()).containsExactly(new File(examples, "src/test/kotlin"));
+    }
+
     @Test
     void testFromProjectNoKotlin() {
         var op = new CompileKotlinOperation().fromProject(
-                new BaseProjectBlueprint(new File("foo"), "org.example", "foo"));
+                new BaseProjectBlueprint(new File("foo"), "org.example", "foo", "foo"));
         assertThat(op.mainSourceDirectories()).isEmpty();
         assertThat(op.testSourceDirectories()).isEmpty();
     }
 
+    @Test
+    void testIsOS() {
+        var osName = System.getProperty("os.name");
+        if (osName != null) {
+            var os = osName.toLowerCase(Locale.US);
+            if (os.contains("win")) {
+                assertThat(CompileKotlinOperation.isWindows()).isTrue();
+            } else if (os.contains("linux") || os.contains("unix")) {
+                assertThat(CompileKotlinOperation.isLinux()).isTrue();
+            } else if (os.contains("mac") || os.contains("darwin")) {
+                assertThat(CompileKotlinOperation.isMacOS()).isTrue();
+            }
+        }
+    }
+
     @Test
     void testKotlinHome() {
         var foo = new File("foo");
@@ -314,6 +352,8 @@ class CompileKotlinOperationTest {
                 .fromProject(new BaseProject())
                 .plugins(CompilerPlugin.ALL_OPEN,
                         CompilerPlugin.ASSIGNMENT,
+                        CompilerPlugin.COMPOSE,
+                        CompilerPlugin.KOTLIN_IMPORTS_DUMPER,
                         CompilerPlugin.KOTLINX_SERIALIZATION,
                         CompilerPlugin.KOTLIN_SERIALIZATION,
                         CompilerPlugin.LOMBOK,

src/test/java/rife/bld/extension/kotlin/CompileOptionsTest.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2023-2024 the original author or authors.
+ * Copyright 2023-2025 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -18,6 +18,8 @@ package rife.bld.extension.kotlin;
 
 import org.assertj.core.api.AutoCloseableSoftAssertions;
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledOnOs;
+import org.junit.jupiter.api.condition.OS;
 
 import java.io.File;
 import java.io.IOException;
@@ -45,14 +47,11 @@ class CompileOptionsTest {
                 .collect(Collectors.joining(File.pathSeparator));
     }
 
-
     @Test
-    @SuppressWarnings("PMD.JUnitTestsShouldIncludeAssert")
+    @SuppressWarnings("PMD.UnitTestShouldIncludeAssert")
     void testArgs() {
         var options = new CompileOptions()
                 .apiVersion("11")
-                .argFile(new File("file.txt"), new File("file2.txt"))
-                .classpath(new File("path1"), new File("path2"))
                 .javaParameters(true)
                 .jvmTarget("11")
                 .includeRuntime(true)
@@ -71,12 +70,11 @@ class CompileOptionsTest {
                 .progressive(true)
                 .scriptTemplates("name", "name2")
                 .verbose(true)
-                .wError(true);
+                .wError(true)
+                .wExtra(true);
 
         var matches = List.of(
                 "-api-version", "11",
-                "@" + localPath("file.txt"), "@" + localPath("file2.txt"),
-                "-classpath", localPath("path1", "path2"),
                 "-java-parameters",
                 "-jvm-target", "11",
                 "-include-runtime",
@@ -97,7 +95,8 @@ class CompileOptionsTest {
                 "-progressive",
                 "-script-templates", "name,name2",
                 "-verbose",
-                "-Werror");
+                "-Werror",
+                "-Wextra");
 
         var args = new ArrayList<List<String>>();
         args.add(options.args());
@@ -113,10 +112,9 @@ class CompileOptionsTest {
 
     @Test
     void testArgsCollections() {
-        var advanceOptions = List.of("Xoption1", "Xoption2");
+        var advanceOptions = List.of("-Xoption1", "option=2");
         var argFile = List.of(new File("arg1.txt"), new File("arg2.txt"));
         var classpath = List.of(new File("path1"), new File("path2"));
-        var jvmOptions = List.of("option1", "option2");
         var optIn = List.of("opt1", "opt2");
         var options = List.of("-foo", "-bar");
         var plugin = List.of("id:name:value", "id2:name2:value2");
@@ -126,7 +124,6 @@ class CompileOptionsTest {
                 .advancedOptions(advanceOptions)
                 .argFile(argFile)
                 .classpath(classpath)
-                .jvmOptions(jvmOptions)
                 .noStdLib(false)
                 .optIn(optIn)
                 .options(options)
@@ -144,8 +141,6 @@ class CompileOptionsTest {
                     .hasSize(argFile.size()).containsAll(argFile);
             softly.assertThat(op.classpath()).as("classpath")
                     .hasSize(classpath.size()).containsAll(classpath);
-            softly.assertThat(op.jvmOptions()).as("jvmOptions")
-                    .hasSize(jvmOptions.size()).containsAll(jvmOptions);
             softly.assertThat(op.optIn()).as("optIn")
                     .hasSize(optIn.size()).containsAll(optIn);
             softly.assertThat(op.options()).as("options")
@@ -165,7 +160,7 @@ class CompileOptionsTest {
                 "-foo", "-bar",
                 "-script-templates",
                 "temp1,temp2",
-                "-XXoption1", "-XXoption2",
+                "-Xoption1", "-Xoption=2",
                 "-P", "plugin:id:name:value",
                 "-P", "plugin:id2:name2:value2");
 
@@ -190,20 +185,27 @@ class CompileOptionsTest {
         var bar = new File("bar.txt");
         var options = new CompileOptions();
 
+        options = options.argFile(foo);
+        assertThat(options.argFile()).contains(foo);
+        options.argFile().clear();
+        assertThat(options.argFile()).isEmpty();
+
         options.argFile(foo, bar);
         assertThat(options.argFile()).contains(foo, bar);
         options.argFile().clear();
+        assertThat(options.argFile()).isEmpty();
 
         options = options.argFile(foo.toPath(), bar.toPath());
         assertThat(options.argFile()).contains(foo, bar);
         options.argFile().clear();
+        assertThat(options.argFile()).isEmpty();
 
-        options.argFile(foo.getAbsolutePath(), bar.getAbsolutePath());
+        options = options.argFile(foo.getAbsolutePath(), bar.getAbsolutePath());
         assertThat(options.argFile()).contains(new File(foo.getAbsolutePath()), new File(bar.getAbsolutePath()));
-        options.argFile().clear();
     }
 
     @Test
+    @EnabledOnOs(OS.LINUX)
     void testCheckAllParams() throws IOException {
         var args = Files.readAllLines(Paths.get("src", "test", "resources", "kotlinc-args.txt"));
 
@@ -212,10 +214,7 @@ class CompileOptionsTest {
         var params = new CompileOptions()
                 .advancedOptions("Xoption")
                 .apiVersion("11")
-                .argFile("file")
-                .classpath("classpath")
                 .expression("expression")
-                .jvmOptions("option")
                 .includeRuntime(true)
                 .javaParameters(true)
                 .jdkHome("jdkhome")
@@ -234,7 +233,12 @@ class CompileOptionsTest {
                 .progressive(true)
                 .scriptTemplates("template")
                 .verbose(true)
-                .wError(true);
+                .wError(true)
+                .wExtra(true);
+
+        var skipArgs = List.of("-J", "-classpath", "@");
+        assertThat(args).as(skipArgs + " not found.").containsAll(skipArgs);
+        args.removeAll(skipArgs);
 
         try (var softly = new AutoCloseableSoftAssertions()) {
             for (var p : args) {
@@ -256,31 +260,45 @@ class CompileOptionsTest {
         var bar = new File("bar.txt");
         var options = new CompileOptions();
 
+        options = options.classpath(foo);
+        assertThat(options.classpath()).as("File").containsExactly(foo);
+        options.classpath().clear();
+        assertThat(options.argFile()).isEmpty();
+
+
         options.classpath(foo, bar);
         assertThat(options.classpath()).as("File...").containsExactly(foo, bar);
         options.classpath().clear();
+        assertThat(options.argFile()).isEmpty();
+
 
         options.classpath(List.of(foo, bar));
         assertThat(options.classpath()).as("List(File...)").containsExactly(foo, bar);
         options.classpath().clear();
+        assertThat(options.argFile()).isEmpty();
+
 
         options = options.classpath(foo.toPath(), bar.toPath());
         assertThat(options.classpath()).as("Path...").containsExactly(foo, bar);
         options.classpath().clear();
+        assertThat(options.argFile()).isEmpty();
+
 
         options = options.classpathPaths(List.of(foo.toPath(), bar.toPath()));
         assertThat(options.classpath()).as("List(Path...)").containsExactly(foo, bar);
         options.classpath().clear();
+        assertThat(options.argFile()).isEmpty();
+
 
         options.classpath(foo.getAbsolutePath(), bar.getAbsolutePath());
         assertThat(options.classpath()).as("String...")
                 .containsExactly(new File(foo.getAbsolutePath()), new File(bar.getAbsolutePath()));
         options.classpath().clear();
+        assertThat(options.argFile()).isEmpty();
 
         options.classpathStrings(List.of(foo.getAbsolutePath(), bar.getAbsolutePath()));
         assertThat(options.classpath()).as("List(String...)")
                 .containsExactly(new File(foo.getAbsolutePath()), new File(bar.getAbsolutePath()));
-        options.classpath().clear();
     }
 
     @Test
@@ -340,7 +358,8 @@ class CompileOptionsTest {
                 .progressive(true)
                 .scriptTemplates("name", "name2")
                 .verbose(true)
-                .wError(true);
+                .wError(true)
+                .wExtra(true);
 
         try (var softly = new AutoCloseableSoftAssertions()) {
             softly.assertThat(options.advancedOptions()).containsExactly("xopt1", "xopt2");
@@ -368,6 +387,7 @@ class CompileOptionsTest {
             softly.assertThat(options.plugin()).containsExactly("id:name:value");
             softly.assertThat(options.scriptTemplates()).containsExactly("name", "name2");
             softly.assertThat(options.isWError()).isTrue();
+            softly.assertThat(options.isWExtra()).isTrue();
         }
     }
 }

src/test/java/rife/bld/extension/kotlin/JvmOptionsTest.java

@@ -0,0 +1,78 @@
+/*
+ * Copyright 2023-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package rife.bld.extension.kotlin;
+
+import org.junit.jupiter.api.Test;
+import rife.bld.extension.CompileKotlinOperation;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+@SuppressWarnings("PMD.AvoidDuplicateLiterals")
+class JvmOptionsTest {
+    @Test
+    void testop() {
+        var op = new CompileKotlinOperation().jvmOptions(new JvmOptions().enableNativeAccess(JvmOptions.ALL_UNNAMED));
+        assertThat(op.jvmOptions()).as(JvmOptions.ALL_UNNAMED).containsExactly("--enable-native-access=ALL-UNNAMED");
+
+        op = new CompileKotlinOperation().jvmOptions(new JvmOptions().enableNativeAccess("m1", "m2"));
+        assertThat(op.jvmOptions()).as("m1,m2").containsExactly("--enable-native-access=m1,m2");
+    }
+
+    @Test
+    void testEnableNativeAccess() {
+        var options = new JvmOptions().enableNativeAccess(JvmOptions.ALL_UNNAMED);
+        assertThat(options).as(JvmOptions.ALL_UNNAMED).containsExactly("--enable-native-access=ALL-UNNAMED");
+
+        options = new JvmOptions().enableNativeAccess("m1");
+        assertThat(options).as("m1").containsExactly("--enable-native-access=m1");
+
+        options = new JvmOptions().enableNativeAccess("m1", "m2");
+        assertThat(options).as("m1,m2").containsExactly("--enable-native-access=m1,m2");
+    }
+
+    @Test
+    void testIllegalNativeAccess() {
+        var options = new JvmOptions().illegalNativeAccess(JvmOptions.NativeAccess.ALLOW);
+        assertThat(options).as("ALLOW").containsExactly("--illegal-native-access=allow");
+
+        options = new JvmOptions().illegalNativeAccess(JvmOptions.NativeAccess.DENY);
+        assertThat(options).as("DENY").containsExactly("--illegal-native-access=deny");
+
+        options = new JvmOptions().illegalNativeAccess(JvmOptions.NativeAccess.WARN);
+        assertThat(options).as("WARN").containsExactly("--illegal-native-access=warn");
+    }
+
+    @Test
+    void testJvmOptions() {
+        var op = new CompileKotlinOperation().jvmOptions("option1", "option2");
+        assertThat(op.jvmOptions()).as("option1,option2").containsExactly("option1", "option2");
+
+        op = new CompileKotlinOperation().jvmOptions(List.of("option1", "option2"));
+        assertThat(op.jvmOptions()).as("List.of(option1,option2)").containsExactly("option1", "option2");
+
+        op = op.jvmOptions(new JvmOptions().enableNativeAccess(JvmOptions.ALL_UNNAMED));
+        assertThat(op.jvmOptions()).as("List.of(option1,option2,ALL_UNNAMED)")
+                .containsExactly("option1", "option2", "--enable-native-access=ALL-UNNAMED");
+
+        op = op.jvmOptions(new JvmOptions().illegalNativeAccess(JvmOptions.NativeAccess.ALLOW));
+        assertThat(op.jvmOptions()).as("allow")
+                .containsExactly("option1", "option2", "--enable-native-access=ALL-UNNAMED",
+                        "--illegal-native-access=allow");
+    }
+}

src/test/resources/argfile.txt

@@ -0,0 +1,3 @@
+-Xjdk-release=17 -no-reflect
+
+-progressive

src/test/resources/argfile2.txt

@@ -0,0 +1 @@
+-include-runtime

src/test/resources/kotlinc-args.txt

@@ -22,4 +22,5 @@
 -script-templates
 -verbose
 -Werror
+-Wextra
 -X