chore: migrate to JSpecify

Author: powercasgamer

api/build.gradle.kts

@@ -14,6 +14,7 @@ dependencies {
   api(libs.examination.api)
   api(libs.examination.string)
   compileOnlyApi(libs.jetbrainsAnnotations)
+  compileOnlyApi(libs.jspecify)
   testImplementation(libs.guava)
   annotationProcessor(projects.adventureAnnotationProcessors)
 }

api/src/main/java/net/kyori/adventure/audience/Audience.java

@@ -29,13 +29,14 @@
 import java.util.stream.Collector;
 import java.util.stream.Collectors;
 import net.kyori.adventure.text.ComponentLike;
-import org.jetbrains.annotations.NotNull;
+import org.jspecify.annotations.NullMarked;
 
 /**
  * {@link Audience}-related utilities.
  *
  * @since 4.13.0
  */
+@NullMarked
 public final class Audiences {
   static final Collector<? super Audience, ?, ForwardingAudience> COLLECTOR = Collectors.collectingAndThen(
     Collectors.toCollection(ArrayList::new),
@@ -52,7 +53,7 @@ private Audiences() {
    * @return an action to send a message
    * @since 4.13.0
    */
-  public static @NotNull Consumer<? super Audience> sendingMessage(final @NotNull ComponentLike message) {
+  public static Consumer<? super Audience> sendingMessage(final ComponentLike message) {
     return audience -> audience.sendMessage(message);
   }
 }

api/src/main/java/net/kyori/adventure/audience/Audiences.java

@@ -36,86 +36,86 @@
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.ComponentLike;
 import org.jetbrains.annotations.Contract;
-import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
-import org.jetbrains.annotations.UnknownNullability;
+import org.jspecify.annotations.NullMarked;
+import org.jspecify.annotations.Nullable;
 
+@NullMarked
 final class EmptyAudience implements Audience {
   static final EmptyAudience INSTANCE = new EmptyAudience();
 
   @Override
-  public @NotNull <T> Optional<T> get(final @NotNull Pointer<T> pointer) {
+  public <T> Optional<T> get(final Pointer<T> pointer) {
     return Optional.empty();
   }
 
   @Contract("_, null -> null; _, !null -> !null")
   @Override
-  public <T> @Nullable T getOrDefault(final @NotNull Pointer<T> pointer, final @Nullable T defaultValue) {
+  public <T> @Nullable T getOrDefault(final Pointer<T> pointer, final @Nullable T defaultValue) {
     return defaultValue;
   }
 
   @Override
-  public <T> @UnknownNullability T getOrDefaultFrom(final @NotNull Pointer<T> pointer, final @NotNull Supplier<? extends T> defaultValue) {
+  public <T> @Nullable T getOrDefaultFrom(final Pointer<T> pointer, final Supplier<? extends T> defaultValue) {
     return defaultValue.get();
   }
 
   @Override
-  public @NotNull Audience filterAudience(final @NotNull Predicate<? super Audience> filter) {
+  public Audience filterAudience(final Predicate<? super Audience> filter) {
     return this;
   }
 
   @Override
-  public void forEachAudience(final @NotNull Consumer<? super Audience> action) {
+  public void forEachAudience(final Consumer<? super Audience> action) {
   }
 
   @Override
-  public void sendMessage(final @NotNull ComponentLike message) {
+  public void sendMessage(final ComponentLike message) {
   }
 
   @Override
-  public void sendMessage(final @NotNull Component message) {
+  public void sendMessage(final Component message) {
   }
 
   @Override
   @Deprecated
-  public void sendMessage(final @NotNull Identified source, final @NotNull Component message, final @NotNull MessageType type) {
+  public void sendMessage(final Identified source, final Component message, final MessageType type) {
   }
 
   @Override
   @Deprecated
-  public void sendMessage(final @NotNull Identity source, final @NotNull Component message, final @NotNull MessageType type) {
+  public void sendMessage(final Identity source, final Component message, final MessageType type) {
   }
 
   @Override
-  public void sendMessage(final @NotNull Component message, final ChatType.@NotNull Bound boundChatType) {
+  public void sendMessage(final Component message, final ChatType.Bound boundChatType) {
   }
 
   @Override
-  public void sendMessage(final @NotNull SignedMessage signedMessage, final ChatType.@NotNull Bound boundChatType) {
+  public void sendMessage(final SignedMessage signedMessage, final ChatType.Bound boundChatType) {
   }
 
   @Override
-  public void deleteMessage(final SignedMessage.@NotNull Signature signature) {
+  public void deleteMessage(final SignedMessage.Signature signature) {
   }
 
   @Override
-  public void sendActionBar(final @NotNull ComponentLike message) {
+  public void sendActionBar(final ComponentLike message) {
   }
 
   @Override
-  public void sendPlayerListHeader(final @NotNull ComponentLike header) {
+  public void sendPlayerListHeader(final ComponentLike header) {
   }
 
   @Override
-  public void sendPlayerListFooter(final @NotNull ComponentLike footer) {
+  public void sendPlayerListFooter(final ComponentLike footer) {
   }
 
   @Override
-  public void sendPlayerListHeaderAndFooter(final @NotNull ComponentLike header, final @NotNull ComponentLike footer) {
+  public void sendPlayerListHeaderAndFooter(final ComponentLike header, final ComponentLike footer) {
   }
 
   @Override
-  public void openBook(final Book.@NotNull Builder book) {
+  public void openBook(final Book.Builder book) {
   }
 
   @Override