feat(annotations): make @SimpleBuilderFor repeatable

[igel-devin-ai]

Issues: follow-up to #296 and #293

Summary

Makes @SimpleBuilderFor @Repeatable: several declarations may be placed on the same holder class or package-info.java, each carrying its own value list and options. This lets one holder route different types into different generated packages:

@SimpleBuilderFor(
    value = ExternalUser.class,
    options = @SimpleBuilder.Options(packageName = "com.example.users"))
@SimpleBuilderFor(
    value = ExternalOrder.class,
    options = @SimpleBuilder.Options(packageName = "com.example.orders"))
public class ExternalBuildersProvider { }

Implementation

• SimpleBuilderFors — the container annotation javac wraps repeated declarations in (same {TYPE, PACKAGE} target, CLASS retention).
• JavaLangAnalyser.findAnnotationInstances — generic repeatable-annotation lookup: direct mirrors plus entries unwrapped from the container, in declaration order.
• BuilderProcessor — collects holders annotated with either the annotation or its container, then resolves value and options per instance, so each declaration gets its own packageName/builderSuffix/etc. Duplicate targets across declarations still hit the existing "already generated elsewhere" skip.
• BuilderConfigurationReader.resolveHolderConfiguration — now takes the specific annotation instance instead of re-finding one on the element.

Tests

• repeatable_GeneratesBuildersIntoDifferentPackages — two declarations with different packageName on one holder
• repeatable_OnPackageInfo_GeneratesBuildersIntoAnnotatedPackage — repeated declarations in package-info.java
• repeatable_DuplicateType_SecondDeclarationSkippedWithWarning — same type listed twice

499 processor tests + example regeneration check green locally.

Documentation

• Javadoc on @SimpleBuilderFor documents the repeatable usage
• docs/CONFIGURATION.md: repeatable example in the "Generating Builders for External Types" section

Written by Devin

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
84.9% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud