refactor(templates): extract flamingock-template-api module (#863)

- **New module** `core/flamingock-template-api` with all
  template-specific API classes
- **Moved 14 source files**: `ChangeTemplate`,
  `AbstractChangeTemplate`, `TemplateField`, `TemplatePayload`,
  `TemplateStep`, wrapper classes, and the three template
  annotations (`@ApplyTemplate`, `@ChangeTemplate`,
  `@RollbackTemplate`)
- **Moved 1 test file**:
  `AbstractChangeTemplateReflectiveClassesTest`
- **Backward compatible**: `flamingock-core-api` exposes
  `flamingock-template-api` via `api` dep, so no consumer
  changes needed
- **No package renames**: all imports remain valid
- Registered module in `settings.gradle.kts` and
  `flamingock.project-structure.gradle.kts`

Author: dieppa

buildSrc/src/main/kotlin/flamingock.project-structure.gradle.kts

@@ -8,6 +8,7 @@ val coreProjects = setOf(
     "flamingock-core",
     "flamingock-core-commons",
     "flamingock-core-api",
+    "flamingock-template-api",
     "flamingock-processor",
     "flamingock-graalvm",
     "flamingock-test-support"

core/flamingock-core-api/build.gradle.kts

@@ -1,5 +1,6 @@
 val jacksonVersion = "2.16.0"
 dependencies {
+    api(project(":core:flamingock-template-api"))
     implementation(project(":utils:general-util"))
     api("jakarta.annotation:jakarta.annotation-api:2.1.1")//todo can this be implementation?
 

core/flamingock-template-api/build.gradle.kts

@@ -0,0 +1,11 @@
+dependencies {
+    implementation(project(":utils:general-util"))
+}
+
+description = "Public API for creating Flamingock change templates"
+
+java {
+    toolchain {
+        languageVersion.set(JavaLanguageVersion.of(8))
+    }
+}

…ngock/api/annotations/ApplyTemplate.java …ngock/api/annotations/ApplyTemplate.javacore/flamingock-core-api/src/main/java/io/flamingock/api/annotations/ApplyTemplate.java renamed to core/flamingock-template-api/src/main/java/io/flamingock/api/annotations/ApplyTemplate.java core/flamingock-core-api/src/main/java/io/flamingock/api/annotations/ApplyTemplate.java renamed to core/flamingock-template-api/src/main/java/io/flamingock/api/annotations/ApplyTemplate.java

@@ -28,7 +28,7 @@
  * including database connections, repositories, and custom dependencies.
  *
  * <p>This annotation is specifically for use in {@link ChangeTemplate} classes.
- * For code-based {@link Change} classes, use {@link Apply} instead.
+ * For code-based changes, use {@code @Apply} instead.
  *
  * @see ChangeTemplate
  * @see RollbackTemplate

…gock/api/annotations/ChangeTemplate.java …gock/api/annotations/ChangeTemplate.javacore/flamingock-core-api/src/main/java/io/flamingock/api/annotations/ChangeTemplate.java renamed to core/flamingock-template-api/src/main/java/io/flamingock/api/annotations/ChangeTemplate.java core/flamingock-core-api/src/main/java/io/flamingock/api/annotations/ChangeTemplate.java renamed to core/flamingock-template-api/src/main/java/io/flamingock/api/annotations/ChangeTemplate.java

@@ -28,7 +28,7 @@
  * safe change reversibility. They receive the same dependency injection as ApplyTemplate methods.
  *
  * <p>This annotation is specifically for use in {@link ChangeTemplate} classes.
- * For code-based {@link Change} classes, use {@link Rollback} instead.
+ * For code-based changes, use {@code @Rollback} instead.
  *
  * @see ChangeTemplate
  * @see ApplyTemplate