chore: move @SInCE javadoc into ApiStatus.AvailableSince annotations

Author: FalsePattern

src/main/java/com/falsepattern/lib/DeprecationDetails.java

@@ -22,6 +22,8 @@
 
 package com.falsepattern.lib;
 
+import org.jetbrains.annotations.ApiStatus;
+
 import java.lang.annotation.Documented;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
@@ -31,28 +33,26 @@
  * <p>
  * Used together with {@link Deprecated} to specify when an API was marked stable, and when it was marked for deprecation.
  * Deprecated classes MAY be removed after a full deprecation cycle as described inside the {@link StableAPI} javadoc.
- * @since 0.10.0
  * @deprecated since 1.7.0
  */
+@ApiStatus.AvailableSince("0.10.0")
 @Deprecated
 @Documented
 @Retention(RetentionPolicy.RUNTIME)
 public @interface DeprecationDetails {
     String deprecatedSince();
 
-    /**
-     * @since 0.11.0
-     */
+    @ApiStatus.AvailableSince("0.11.0")
     String replacement() default "";
 
     /**
      * DEPRECATED: Use the jetbrains annotations/jspecify instead!
      * <p>
      * This marks an API for removal in a future version.
      *
-     * @since 0.12.0
      * @deprecated since 1.7.0
      */
+    @ApiStatus.AvailableSince("0.12.0")
     @Deprecated
     @Documented
     @Retention(RetentionPolicy.RUNTIME)

src/main/java/com/falsepattern/lib/StableAPI.java

@@ -21,6 +21,8 @@
  */
 package com.falsepattern.lib;
 
+import org.jetbrains.annotations.ApiStatus;
+
 import java.lang.annotation.Documented;
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
@@ -55,8 +57,8 @@
  * error, unlike __INTERNAL__, but if any issues arise from the usage of the API or the API changing, the API developer
  * shall not be blamed for it.
  * @deprecated since 1.7.0
- * @since 0.6.0
  */
+@ApiStatus.AvailableSince("0.6.0")
 @Deprecated
 @Documented
 @Retention(RetentionPolicy.RUNTIME)
@@ -80,8 +82,8 @@
      * inner classes still need to use {@link StableAPI}.
      *
      * @deprecated since 1.7.0
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Deprecated
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
@@ -99,8 +101,8 @@
      * changed or removed in any version in the library without prior notice.
      *
      * @deprecated since 1.7.0
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Deprecated
     @Documented
     @Retention(RetentionPolicy.RUNTIME)

src/main/java/com/falsepattern/lib/asm/exceptions/package-info.java

@@ -20,7 +20,7 @@
  * along with FalsePatternLib. If not, see <https://www.gnu.org/licenses/>.
  */
 
-/**
- * @since 0.10.0
- */
-package com.falsepattern.lib.asm.exceptions;
+@ApiStatus.AvailableSince("0.10.0")
+package com.falsepattern.lib.asm.exceptions;
+
+import org.jetbrains.annotations.ApiStatus;

src/main/java/com/falsepattern/lib/asm/package-info.java

@@ -20,7 +20,7 @@
  * along with FalsePatternLib. If not, see <https://www.gnu.org/licenses/>.
  */
 
-/**
- * @since 0.10.0
- */
-package com.falsepattern.lib.asm;
+@ApiStatus.AvailableSince("0.10.0")
+package com.falsepattern.lib.asm;
+
+import org.jetbrains.annotations.ApiStatus;

src/main/java/com/falsepattern/lib/compat/BlockPos.java

@@ -29,6 +29,7 @@
 import lombok.val;
 import org.apache.logging.log4j.LogManager;
 import org.apache.logging.log4j.Logger;
+import org.jetbrains.annotations.ApiStatus;
 
 import net.minecraft.entity.Entity;
 import net.minecraft.util.EnumFacing;
@@ -364,9 +365,7 @@ public BlockPos toImmutable() {
         return this;
     }
 
-    /**
-     * @since 0.10.0
-     */
+    @ApiStatus.AvailableSince("0.10.0")
     @Setter
     @Getter
     public static class MutableBlockPos extends BlockPos {
@@ -453,9 +452,7 @@ public BlockPos.MutableBlockPos move(@NonNull EnumFacing facing, int blocks) {
         }
     }
 
-    /**
-     * @since 0.10.0
-     */
+    @ApiStatus.AvailableSince("0.10.0")
     public static final class PooledMutableBlockPos extends BlockPos.MutableBlockPos {
         private static final List<BlockPos.PooledMutableBlockPos> POOL = new ArrayList<>();
         private boolean released;

src/main/java/com/falsepattern/lib/compat/GuiLabel.java

@@ -23,6 +23,7 @@
 
 import lombok.NonNull;
 import lombok.val;
+import org.jetbrains.annotations.ApiStatus;
 import org.lwjgl.opengl.GL11;
 
 import net.minecraft.client.Minecraft;
@@ -38,9 +39,8 @@
 
 /**
  * A functional equivalent to GuiLabel present in Minecraft 1.12.
- *
- * @since 0.8.0
  */
+@ApiStatus.AvailableSince("0.8.0")
 @SideOnly(Side.CLIENT)
 public class GuiLabel extends Gui {
     private final List<String> lines = new ArrayList<>();

src/main/java/com/falsepattern/lib/compat/package-info.java

@@ -20,7 +20,7 @@
  * along with FalsePatternLib. If not, see <https://www.gnu.org/licenses/>.
  */
 
-/**
- * @since 0.6.0
- */
-package com.falsepattern.lib.compat;
+@ApiStatus.AvailableSince("0.6.0")
+package com.falsepattern.lib.compat;
+
+import org.jetbrains.annotations.ApiStatus;

src/main/java/com/falsepattern/lib/config/Config.java

@@ -22,6 +22,7 @@
 package com.falsepattern.lib.config;
 
 import org.intellij.lang.annotations.Language;
+import org.jetbrains.annotations.ApiStatus;
 
 import java.lang.annotation.Documented;
 import java.lang.annotation.ElementType;
@@ -94,9 +95,8 @@
      * Define category migrations here.
      * Used to rename config categories without losing data.
      * @see #pathMigrations()
-     *
-     * @since 1.5.0
      */
+    @ApiStatus.AvailableSince("1.5.0")
     String[] categoryMigrations() default {};
 
     /**
@@ -110,9 +110,8 @@
      * customPath = "mymod.config" -> .minecraft/config/mymod.config
      * <br>
      * @see #modid()
-     *
-     * @since 1.5.0
      */
+    @ApiStatus.AvailableSince("1.5.0")
     String customPath() default "";
 
     /**
@@ -126,9 +125,8 @@
      * the category of this config.
      * @see #customPath()
      * @see #categoryMigrations()
-     *
-     * @since 1.5.0
      */
+    @ApiStatus.AvailableSince("1.5.0")
     String[] pathMigrations() default {};
 
     // region Common
@@ -182,9 +180,8 @@
 
         /**
          * Use this to migrate from old config names. "" is resolved to the name of the field
-         *
-         * @since 1.5.0
          */
+        @ApiStatus.AvailableSince("1.5.0")
         String[] migrations() default {};
     }
 
@@ -214,19 +211,17 @@
      * <p>
      * Note that synchronization ALWAYS happens FROM the server TO the client. The server should NEVER attempt to get
      * configuration values from a client. This is to avoid malicious clients manipulating the server configs.
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.TYPE)
     @interface Synchronize {}
 
     /**
      * Use this to mark config fields you don't want to synchronize in a class marked with {@link Synchronize}.
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -281,9 +276,8 @@
     /**
      * The default value for a double field.
      * @see RangeDouble
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -293,9 +287,8 @@
 
     /**
      * The range of possible values a double config can have.
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -325,9 +318,8 @@
      * This annotation limits the maximum number of characters present in a string configuration.
      * <p>
      * When used with a string list, this limit will apply to each element individually, not to the size of the list as a whole.
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -368,9 +360,8 @@
      * The default value for a boolean array field.
      * @see ListFixedLength
      * @see ListMaxLength
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -383,9 +374,8 @@
      * @see ListFixedLength
      * @see ListMaxLength
      * @see RangeInt
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -398,9 +388,8 @@
      * @see ListFixedLength
      * @see ListMaxLength
      * @see RangeDouble
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -426,9 +415,8 @@
      * If this annotation is present, the list in the config will be forced to have exactly the amount of elements as
      * the default value.
      * @see ListMaxLength
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)
@@ -437,9 +425,8 @@
     /**
      * This annotation limits the maximum number of elements present in an array configuration. Only effective if
      * {@link ListFixedLength} is NOT present.
-     *
-     * @since 0.10.0
      */
+    @ApiStatus.AvailableSince("0.10.0")
     @Documented
     @Retention(RetentionPolicy.RUNTIME)
     @Target(ElementType.FIELD)