feat!: introduce a Kotlin DSL

alchemist-api/build.gradle.kts

@@ -16,7 +16,6 @@ dependencies {
     api(libs.jool)
     api(libs.listset)
     implementation(libs.kotlin.reflect)
-
     testImplementation(libs.kotlin.test)
 }
 

alchemist-api/src/main/java/it/unibo/alchemist/model/Incarnation.java

@@ -119,8 +119,6 @@ Reaction<T> createReaction(
      * @param node
      *            the node that will host this object. If it is `null` the actionable
      *            will not belong to a {@link Node}
-     * @param time
-     *            the time distribution of the reaction
      * @param actionable
      *            the actionable hosting this object
      * @param additionalParameters
@@ -131,7 +129,6 @@ Condition<T> createCondition(
         RandomGenerator randomGenerator,
         Environment<T, P> environment,
         @Nullable Node<T> node,
-        TimeDistribution<T> time,
         Actionable<T> actionable,
         @Nullable Object additionalParameters
     );
@@ -144,8 +141,6 @@ Condition<T> createCondition(
      * @param node
      *            the node that will host this object. If it is `null` the actionable
      *            will not belong to a {@link Node}
-     * @param time
-     *            the time distribution of the reaction
      * @param actionable
      *            the actionable hosting this object
      * @param additionalParameters
@@ -156,7 +151,6 @@ Action<T> createAction(
         RandomGenerator randomGenerator,
         Environment<T, P> environment,
         @Nullable Node<T> node,
-        TimeDistribution<T> time,
         Actionable<T> actionable,
         @Nullable Object additionalParameters
     );

alchemist-api/src/main/kotlin/it/unibo/alchemist/model/Environment.kt

@@ -83,7 +83,7 @@ interface Environment<T, P : Position<out P>> :
     /**
      * Return all the Layers in this [Environment].
      */
-    val layers: ListSet<Layer<T, P>>
+    val layers: Map<Molecule, Layer<T, P>>
 
     /**
      * Returns the current [LinkingRule].

alchemist-cognitive-agents/build.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2010-2022, Danilo Pianini and contributors
+ * Copyright (C) 2010-2025, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
@@ -15,6 +15,8 @@ plugins {
 }
 
 dependencies {
+    ksp(alchemist("factories-generator"))
+
     api(alchemist("api"))
 
     implementation(alchemist("euclidean-geometry"))

alchemist-cognitive-agents/src/main/kotlin/it/unibo/alchemist/model/cognitive/steering/TypeBased.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2010-2023, Danilo Pianini and contributors
+ * Copyright (C) 2010-2025, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
@@ -28,6 +28,6 @@ import kotlin.reflect.KClass
 class TypeBased<T>(
     environment: Euclidean2DEnvironment<T>,
     node: Node<T>,
-    typeWeights: LinkedHashMap<KClass<SteeringAction<T, Euclidean2DPosition>>, Double>,
+    typeWeights: Map<KClass<SteeringAction<T, Euclidean2DPosition>>, Double>,
     defaultWeight: Double = 0.0,
 ) : Weighted<T>(environment, node, { typeWeights[this::class] ?: defaultWeight })

alchemist-cognitive-agents/src/test/kotlin/it/unibo/alchemist/model/cognitive/TestSensory.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2010-2023, Danilo Pianini and contributors
+ * Copyright (C) 2010-2026, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
@@ -11,7 +11,6 @@ package it.unibo.alchemist.model.cognitive
 
 import io.kotest.core.spec.style.StringSpec
 import io.kotest.matchers.shouldBe
-import it.unibo.alchemist.model.Incarnation
 import it.unibo.alchemist.model.SupportedIncarnations
 import it.unibo.alchemist.model.cognitive.properties.Pedestrian
 import it.unibo.alchemist.model.cognitive.properties.Perceptive2D
@@ -31,14 +30,10 @@ import org.apache.commons.math3.random.RandomGenerator
  *
  * @param T used internally
  */
-class TestSensory<T> :
-    StringSpec({
+class TestSensory<T> : StringSpec({
 
-        fun createHomogeneousPedestrian(
-            incarnation: Incarnation<T, Euclidean2DPosition>,
-            randomGenerator: RandomGenerator,
-            environment: Physics2DEnvironment<T>,
-        ) = GenericNode(incarnation, environment).apply {
+    fun createHomogeneousPedestrian(randomGenerator: RandomGenerator, environment: Physics2DEnvironment<T>) =
+        GenericNode(environment).apply {
             listOf(
                 Pedestrian(randomGenerator, this),
                 Social(this),
@@ -47,32 +42,28 @@ class TestSensory<T> :
             ).forEach(this::addProperty)
         }
 
-        "field of view" {
-            val environment =
-                ContinuousPhysics2DEnvironment<T>(
-                    SupportedIncarnations.get<T, Euclidean2DPosition>("protelis").orElseThrow(),
-                )
-            val rand = MersenneTwister(1)
-            environment.linkingRule = NoLinks()
-            val incarnation: Incarnation<T, Euclidean2DPosition> =
-                SupportedIncarnations
-                    .get<T, Euclidean2DPosition>(SupportedIncarnations.getAvailableIncarnations().first())
-                    .get()
-            val observed = createHomogeneousPedestrian(incarnation, rand, environment)
-            val origin = Euclidean2DPosition(5.0, 5.0)
-            environment.addNode(observed, origin)
-            val radius = 10.0
-            origin.surrounding(radius).forEach {
-                with(createHomogeneousPedestrian(incarnation, rand, environment)) {
-                    environment.addNode(this, it)
-                    environment.setHeading(this, origin - it)
-                }
+    "field of view" {
+        val environment =
+            ContinuousPhysics2DEnvironment<T>(
+                SupportedIncarnations.get<T, Euclidean2DPosition>("protelis").orElseThrow(),
+            )
+        val rand = MersenneTwister(1)
+        environment.linkingRule = NoLinks()
+        val observed = createHomogeneousPedestrian(rand, environment)
+        val origin = Euclidean2DPosition(5.0, 5.0)
+        environment.addNode(observed, origin)
+        val radius = 10.0
+        origin.surrounding(radius).forEach {
+            with(createHomogeneousPedestrian(rand, environment)) {
+                environment.addNode(this, it)
+                environment.setHeading(this, origin - it)
             }
-            environment.nodes.minusElement(observed).forEach {
-                with(FieldOfView2D(environment, it, radius, Math.PI / 2)) {
-                    influentialNodes().size shouldBe 1
-                    influentialNodes().first() shouldBe observed
-                }
+        }
+        environment.nodes.minusElement(observed).forEach {
+            with(FieldOfView2D(environment, it, radius, Math.PI / 2)) {
+                influentialNodes().size shouldBe 1
+                influentialNodes().first() shouldBe observed
             }
         }
-    })
+    }
+})

alchemist-composeui/build.gradle.kts

@@ -1,18 +1,16 @@
-import dev.detekt.gradle.Detekt
-import it.unibo.alchemist.build.devServer
-import it.unibo.alchemist.build.webCommonConfiguration
-import org.gradle.kotlin.dsl.withType
-import org.jetbrains.kotlin.gradle.ExperimentalWasmDsl
-
 /*
- * Copyright (C) 2010-2025, Danilo Pianini and contributors
+ * Copyright (C) 2010-2026, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
  * GNU General Public License, with a linking exception,
  * as described in the file LICENSE in the Alchemist distribution's top directory.
  */
 
+import it.unibo.alchemist.build.devServer
+import it.unibo.alchemist.build.webCommonConfiguration
+import org.jetbrains.kotlin.gradle.ExperimentalWasmDsl
+
 plugins {
     id("kotlin-multiplatform-convention")
     alias(libs.plugins.compose.multiplatform)
@@ -46,8 +44,3 @@ publishing.publications.withType<MavenPublication>().configureEach {
         }
     }
 }
-
-// exclude files in build from Detekt
-tasks.withType<Detekt>().configureEach {
-    exclude("**/alchemist_composeui/**")
-}

alchemist-engine/src/test/kotlin/it/unibo/alchemist/core/TestConcurrency.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2010-2025, Danilo Pianini and contributors
+ * Copyright (C) 2010-2026, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
@@ -36,7 +36,7 @@ internal class TestConcurrency {
     fun `simulation commands should interleave`() {
         val incarnation = BiochemistryIncarnation()
         val environment = Continuous2DEnvironment(incarnation)
-        val node = GenericNode(incarnation, environment)
+        val node = GenericNode(environment)
         environment.linkingRule = NoLinks()
         val timeDistribution = DiracComb<Double>(1.0)
         val reaction = Event(node, timeDistribution)

alchemist-engine/src/test/kotlin/it/unibo/alchemist/core/TestSimulationControl.kt

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2010-2023, Danilo Pianini and contributors
+ * Copyright (C) 2010-2025, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
@@ -68,7 +68,7 @@ class TestSimulationControl :
 
         fun Environment<Nothing, *>.tickRate(delta: Double) {
             this.simulation.schedule {
-                this.addGlobalReaction(GlobalTestReaction(DiracComb(Time.ZERO, delta), this))
+                this.addGlobalReaction(GlobalTestReaction(this, DiracComb(Time.ZERO, delta)))
             }
         }
     }

alchemist-engine/src/test/kotlin/it/unibo/alchemist/core/test/GoToTimeRegressionTest.kt

@@ -1,3 +1,12 @@
+/*
+ * Copyright (C) 2010-2025, Danilo Pianini and contributors
+ * listed, for each module, in the respective subproject's build.gradle.kts file.
+ *
+ * This file is part of Alchemist, and is distributed under the terms of the
+ * GNU General Public License, with a linking exception,
+ * as described in the file LICENSE in the Alchemist distribution's top directory.
+ */
+
 package it.unibo.alchemist.core.test
 
 import it.unibo.alchemist.model.Environment
@@ -24,7 +33,7 @@ object GoToTimeRegressionTest {
 
     private fun Environment<Nothing, *>.tickRate(delta: Double) {
         this.simulation.schedule {
-            this.addGlobalReaction(GlobalTestReaction(DiracComb(Time.ZERO, delta), this))
+            this.addGlobalReaction(GlobalTestReaction(this, DiracComb(Time.ZERO, delta)))
         }
     }
 

alchemist-euclidean-geometry/build.gradle.kts

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2010-2022, Danilo Pianini and contributors
+ * Copyright (C) 2010-2025, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
@@ -15,6 +15,8 @@ plugins {
 }
 
 dependencies {
+    ksp(alchemist("factories-generator"))
+
     api(alchemist("api"))
     api(alchemist("implementationbase"))
     api(libs.dyn4j)

alchemist-euclidean-geometry/src/test/java/it/unibo/alchemist/model/obstacles/TestContinuous2DObstacle.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2010-2025, Danilo Pianini and contributors
+ * Copyright (C) 2010-2026, Danilo Pianini and contributors
  * listed, for each module, in the respective subproject's build.gradle.kts file.
  *
  * This file is part of Alchemist, and is distributed under the terms of the
@@ -33,7 +33,7 @@ private Node<Integer> createIntNode(
         final Incarnation<Integer, Euclidean2DPosition> incarnation,
         final Environment<Integer, Euclidean2DPosition> environment
     ) {
-        return new GenericNode<>(incarnation, environment) {
+        return new GenericNode<>(environment) {
             @Override
             public Integer createT() {
                 return 0;

alchemist-euclidean-geometry/src/test/kotlin/it/unibo/alchemist/model/interfaces/geometry/TestEuclidean2DTransformation.kt

@@ -9,7 +9,6 @@
 
 package it.unibo.alchemist.model.interfaces.geometry
 
-import edu.umd.cs.findbugs.annotations.SuppressFBWarnings
 import io.kotest.core.spec.style.FreeSpec
 import io.kotest.matchers.shouldBe
 import it.unibo.alchemist.model.geometry.Euclidean2DShapeFactory
@@ -22,36 +21,24 @@ import it.unibo.alchemist.model.positions.Euclidean2DPosition
 private val factory: Euclidean2DShapeFactory =
     GeometricShapeFactory.getInstance<Euclidean2DPosition, Euclidean2DTransformation, Euclidean2DShapeFactory>()
 
-@SuppressFBWarnings("SE_BAD_FIELD_STORE")
 class TestEuclidean2DTransformation :
     FreeSpec({
         "Test origin" - {
-            factory
-                .oneOfEachWithSize(1.0)
+            factory.oneOfEachWithSize(1.0)
                 .filter { it.value !is AdimensionalShape }
                 .forEach {
                     it.key {
-                        var shape =
-                            it.value.transformed {
-                                origin(0.0, 0.0)
-                            }
+                        var shape = it.value.transformed { origin(0.0, 0.0) }
                         val reference = shape.centroid
-                        shape =
-                            shape.transformed {
-                                origin(0.0, 0.0)
-                            }
+                        shape = shape.transformed { origin(0.0, 0.0) }
                         reference.distanceTo(shape.centroid) shouldBe 0.0
-                        shape =
-                            shape.transformed {
-                                origin(0.0, 10.0)
-                            }
+                        shape = shape.transformed { origin(0.0, 10.0) }
                         reference.distanceTo(shape.centroid) shouldBe 10.0
-                        shape =
-                            shape.transformed {
-                                origin(10.0, 10.0)
-                                origin(3.0, 3.0)
-                                origin(6.0, 0.0)
-                            }
+                        shape = shape.transformed {
+                            origin(10.0, 10.0)
+                            origin(3.0, 3.0)
+                            origin(6.0, 0.0)
+                        }
                         reference.distanceTo(shape.centroid) shouldBe 6.0
                     }
                 }