feat: migrate to multi-module architecture with Jakarta Validation support

Split project into sift-core and sift-annotations. Added @SiftMatch constraint. Achieved 100% test coverage and resolved all Gradle warnings. Applied strict encapsulation and Apache 2.0 licenses.

Author: Mirkoddd

build.gradle

@@ -1,70 +1,8 @@
-plugins {
-    id 'java-library'
-    id 'maven-publish'
-    id 'signing'
-}
-
-group = 'com.mirkoddd'
-version = '1.0.0'
-
-java {
-    toolchain {
-        languageVersion = JavaLanguageVersion.of(17)
-    }
-    withJavadocJar()
-    withSourcesJar()
-}
-
-dependencies {
-    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.2'
-}
-
-test {
-    useJUnitPlatform()
-}
-
-publishing {
-    publications {
-        mavenJava(MavenPublication) {
-            from components.java
-
-            pom {
-                name = 'Sift'
-                description = 'A Fluent Regex Builder for Java based on SOLID principles.'
-                url = 'https://github.com/mirkoddd/Sift'
-
-                licenses {
-                    license {
-                        name = 'The Apache License, Version 2.0'
-                        url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
-                    }
-                }
-
-                developers {
-                    developer {
-                        id = 'mirkoddd'
-                        name = 'Mirko Dimartino'
-                        email = 'mirkoddd@gmail.com'
-                    }
-                }
-
-                scm {
-                    connection = 'scm:git:git://github.com/mirkoddd/Sift.git'
-                    developerConnection = 'scm:git:ssh://github.com:mirkoddd/Sift.git'
-                    url = 'https://github.com/mirkoddd/Sift'
-                }
-            }
-        }
-    }
+allprojects {
+    group = 'com.mirkoddd'
+    version = '1.1.0'
 
     repositories {
-        maven {
-            name = "Staging"
-            url = layout.buildDirectory.dir("repos/bundles")
-        }
+        mavenCentral()
     }
-}
-
-signing {
-    sign publishing.publications.mavenJava
 }

settings.gradle

@@ -1,14 +1,8 @@
-pluginManagement {
-    repositories {
-        mavenCentral()
-        gradlePluginPortal()
-    }
-}
-dependencyResolutionManagement {
-    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
-    repositories {
-        mavenCentral()
-    }
+plugins {
+    id 'org.gradle.toolchains.foojay-resolver-convention' version '0.8.0'
 }
 
-rootProject.name = "Sift"
+rootProject.name = 'Sift'
+
+include ':sift-core'
+include ':sift-annotations'

sift-annotations/build.gradle

@@ -0,0 +1,76 @@
+plugins {
+    id 'java-library'
+    id 'maven-publish'
+    id 'signing'
+}
+
+java {
+    toolchain {
+        languageVersion = JavaLanguageVersion.of(17)
+    }
+    withJavadocJar()
+    withSourcesJar()
+}
+
+dependencies {
+    api project(':sift-core')
+
+    compileOnly 'jakarta.validation:jakarta.validation-api:3.0.2'
+
+    testImplementation 'org.junit.jupiter:junit-jupiter:5.10.2'
+    testImplementation 'org.hibernate.validator:hibernate-validator:8.0.1.Final'
+    testImplementation 'org.glassfish:jakarta.el:4.0.2'
+
+    testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
+}
+
+test {
+    useJUnitPlatform()
+}
+
+publishing {
+    publications {
+        mavenJava(MavenPublication) {
+            artifactId = 'sift-annotations'
+            from components.java
+
+            pom {
+                name = 'Sift Annotations'
+                description = 'Jakarta Validation annotations powered by Sift Fluent Regex Builder.'
+                url = 'https://github.com/mirkoddd/Sift'
+
+                licenses {
+                    license {
+                        name = 'The Apache License, Version 2.0'
+                        url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
+                    }
+                }
+
+                developers {
+                    developer {
+                        id = 'mirko_ddd'
+                        name = 'Mirko Dimartino'
+                        email = 'mirkoddd@gmail.com'
+                    }
+                }
+
+                scm {
+                    connection = 'scm:git:git://github.com/mirkoddd/Sift.git'
+                    developerConnection = 'scm:git:ssh://github.com:mirkoddd/Sift.git'
+                    url = 'https://github.com/mirkoddd/Sift'
+                }
+            }
+        }
+    }
+
+    repositories {
+        maven {
+            name = "Staging"
+            url = layout.buildDirectory.dir("repos/bundles")
+        }
+    }
+}
+
+signing {
+    sign publishing.publications.mavenJava
+}

sift-annotations/src/main/java/com/mirkoddd/sift/SiftMatch.java

@@ -0,0 +1,63 @@
+/*
+ * Copyright 2026 Mirko Dimartino
+ *
+ * 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
+ *
+ * http://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 com.mirkoddd.sift;
+
+import jakarta.validation.Constraint;
+import jakarta.validation.Payload;
+import java.lang.annotation.Documented;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * The annotated {@code CharSequence} must match the regular expression defined
+ * by the specified {@link SiftRegexProvider}.
+ * <p>
+ * {@code null} elements are considered valid. Use standard {@link jakarta.validation.constraints.NotNull}
+ * annotations alongside {@link SiftMatch} to ensure the value is present.
+ * @author Mirko Dimartino
+ * @since 1.1.0
+ */
+@Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.METHOD, ElementType.ANNOTATION_TYPE})
+@Retention(RetentionPolicy.RUNTIME)
+@Constraint(validatedBy = SiftMatchValidator.class)
+@Documented
+public @interface SiftMatch {
+
+    /**
+     * The class implementing {@link SiftRegexProvider} that contains the {@link SiftBuilder} logic.
+     * The referenced class must have a public no-args constructor.
+     *
+     * @return the provider class
+     */
+    Class<? extends SiftRegexProvider> value();
+
+    /**
+     * @return the error message template
+     */
+    String message() default "The provided value does not match the required Sift pattern";
+
+    /**
+     * @return the groups the constraint belongs to
+     */
+    Class<?>[] groups() default {};
+
+    /**
+     * @return the payload associated to the constraint
+     */
+    Class<? extends Payload>[] payload() default {};
+}

sift-annotations/src/main/java/com/mirkoddd/sift/SiftMatchValidator.java

@@ -0,0 +1,52 @@
+/*
+ * Copyright 2026 Mirko Dimartino
+ *
+ * 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
+ *
+ * http://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 com.mirkoddd.sift;
+
+import jakarta.validation.ConstraintValidator;
+import jakarta.validation.ConstraintValidatorContext;
+import java.util.regex.Pattern;
+
+/**
+ * Engine that validates a {@link CharSequence} against a rule defined by a {@link SiftRegexProvider}.
+ * <p>
+ * For performance optimization, this validator compiles the regular expression into a
+ * {@link java.util.regex.Pattern} only once during initialization, rather than on every validation call.
+ * @author Mirko Dimartino
+ * @since 1.1.0
+ */
+public final class SiftMatchValidator implements ConstraintValidator<SiftMatch, CharSequence> {
+
+    private Pattern compiledPattern;
+
+    @Override
+    public void initialize(SiftMatch constraintAnnotation) {
+        try {
+            SiftRegexProvider provider = constraintAnnotation.value().getDeclaredConstructor().newInstance();
+            String rawRegex = provider.getRegex();
+            this.compiledPattern = Pattern.compile(rawRegex);
+        } catch (Exception e) {
+            throw new RuntimeException("Failed to initialize SiftRegexProvider: " + constraintAnnotation.value().getName() + ". Ensure it has a public no-args constructor.", e);
+        }
+    }
+
+    @Override
+    public boolean isValid(CharSequence value, ConstraintValidatorContext context) {
+        if (value == null) {
+            return true;
+        }
+        return compiledPattern.matcher(value).matches();
+    }
+}

sift-annotations/src/main/java/com/mirkoddd/sift/SiftRegexProvider.java

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2026 Mirko Dimartino
+ *
+ * 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
+ *
+ * http://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 com.mirkoddd.sift;
+
+/**
+ * Contract for defining a custom Regular Expression rule using the Sift Fluent Builder.
+ * <p>
+ * Implementations of this interface must provide a no-argument constructor so the
+ * validation engine can instantiate them via reflection.
+ * <p>
+ * <b>Example usage:</b>
+ * <pre>
+ * {@code
+ * public class AlphanumericRule implements SiftRegexProvider {
+ *     @Override
+ *     public String getRegex() {
+ *         return Sift.fromStart()
+ *             .oneOrMore().alphanumeric()
+ *             .shake();
+ *     }
+ *  }
+ * }
+ * </pre>
+ * @author Mirko Dimartino
+ * @since 1.1.0
+ */
+public interface SiftRegexProvider {
+
+    /**
+     * Provides the raw Regex string generated by {@link SiftBuilder}.
+     *
+     * @return the compiled regex string (typically obtained by calling {@code .shake()})
+     */
+    String getRegex();
+}