chore: migrate to jspecify

Author: Strokkur424

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

@@ -50,7 +50,6 @@
 import net.kyori.adventure.text.ComponentLike;
 import net.kyori.adventure.title.Title;
 import net.kyori.adventure.title.TitlePart;
-import org.jetbrains.annotations.NotNull;
 
 /**
  * A receiver of Minecraft media.
@@ -106,7 +105,7 @@ public interface Audience extends Pointered {
    * @return a do-nothing audience
    * @since 4.0.0
    */
-  static @NotNull Audience empty() {
+  static Audience empty() {
     return EmptyAudience.INSTANCE;
   }
 
@@ -118,7 +117,7 @@ public interface Audience extends Pointered {
    * @see ForwardingAudience
    * @since 4.0.0
    */
-  static @NotNull Audience audience(final @NotNull Audience@NotNull... audiences) {
+  static Audience audience(final Audience... audiences) {
     final int length = audiences.length;
     if (length == 0) {
       return empty();
@@ -139,7 +138,7 @@ public interface Audience extends Pointered {
    * @see ForwardingAudience
    * @since 4.0.0
    */
-  static @NotNull ForwardingAudience audience(final @NotNull Iterable<? extends Audience> audiences) {
+  static ForwardingAudience audience(final Iterable<? extends Audience> audiences) {
     return () -> audiences;
   }
 
@@ -151,7 +150,7 @@ public interface Audience extends Pointered {
    * @return a collector to create a forwarding audience
    * @since 4.0.0
    */
-  static @NotNull Collector<? super Audience, ?, ForwardingAudience> toAudience() {
+  static Collector<? super Audience, ?, ForwardingAudience> toAudience() {
     return Audiences.COLLECTOR;
   }
 
@@ -168,7 +167,7 @@ public interface Audience extends Pointered {
    * @return an audience providing a snapshot of all audiences that match the predicate when this method is invoked
    * @since 4.9.0
    */
-  default @NotNull Audience filterAudience(final @NotNull Predicate<? super Audience> filter) {
+  default Audience filterAudience(final Predicate<? super Audience> filter) {
     return filter.test(this)
       ? this
       : empty();
@@ -187,7 +186,7 @@ public interface Audience extends Pointered {
    * @param action the action
    * @since 4.9.0
    */
-  default void forEachAudience(final @NotNull Consumer<? super Audience> action) {
+  default void forEachAudience(final Consumer<? super Audience> action) {
     action.accept(this);
   }
 
@@ -200,7 +199,7 @@ default void forEachAudience(final @NotNull Consumer<? super Audience> action) {
    * @since 4.1.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendMessage(final @NotNull ComponentLike message) {
+  default void sendMessage(final ComponentLike message) {
     this.sendMessage(message.asComponent());
   }
 
@@ -211,7 +210,7 @@ default void sendMessage(final @NotNull ComponentLike message) {
    * @see Component
    * @since 4.1.0
    */
-  default void sendMessage(final @NotNull Component message) {
+  default void sendMessage(final Component message) {
   }
   /* End: system messages */
 
@@ -224,7 +223,7 @@ default void sendMessage(final @NotNull Component message) {
    * @since 4.12.0
    * @sinceMinecraft 1.19
    */
-  default void sendMessage(final @NotNull Component message, final ChatType.@NotNull Bound boundChatType) {
+  default void sendMessage(final Component message, final ChatType.Bound boundChatType) {
   }
 
   /**
@@ -236,7 +235,7 @@ default void sendMessage(final @NotNull Component message, final ChatType.@NotNu
    * @sinceMinecraft 1.19
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendMessage(final @NotNull ComponentLike message, final ChatType.@NotNull Bound boundChatType) {
+  default void sendMessage(final ComponentLike message, final ChatType.Bound boundChatType) {
     this.sendMessage(message.asComponent(), boundChatType);
   }
   /* End: disguised player messages
@@ -250,7 +249,7 @@ default void sendMessage(final @NotNull ComponentLike message, final ChatType.@N
    * @since 4.12.0
    * @sinceMinecraft 1.19
    */
-  default void sendMessage(final @NotNull SignedMessage signedMessage, final ChatType.@NotNull Bound boundChatType) {
+  default void sendMessage(final SignedMessage signedMessage, final ChatType.Bound boundChatType) {
   }
 
   /**
@@ -262,7 +261,7 @@ default void sendMessage(final @NotNull SignedMessage signedMessage, final ChatT
    * @sinceMinecraft 1.19
    */
   @ForwardingAudienceOverrideNotRequired
-  default void deleteMessage(final @NotNull SignedMessage signedMessage) {
+  default void deleteMessage(final SignedMessage signedMessage) {
     if (signedMessage.canDelete()) {
       this.deleteMessage(Objects.requireNonNull(signedMessage.signature()));
     }
@@ -275,7 +274,7 @@ default void deleteMessage(final @NotNull SignedMessage signedMessage) {
    * @since 4.12.0
    * @sinceMinecraft 1.19
    */
-  default void deleteMessage(final SignedMessage.@NotNull Signature signature) {
+  default void deleteMessage(final SignedMessage.Signature signature) {
   }
   /* End: signed player messages */
 
@@ -287,7 +286,7 @@ default void deleteMessage(final SignedMessage.@NotNull Signature signature) {
    * @since 4.0.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendActionBar(final @NotNull ComponentLike message) {
+  default void sendActionBar(final ComponentLike message) {
     this.sendActionBar(message.asComponent());
   }
 
@@ -298,7 +297,7 @@ default void sendActionBar(final @NotNull ComponentLike message) {
    * @see Component
    * @since 4.0.0
    */
-  default void sendActionBar(final @NotNull Component message) {
+  default void sendActionBar(final Component message) {
   }
 
   /**
@@ -311,7 +310,7 @@ default void sendActionBar(final @NotNull Component message) {
    * @since 4.3.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendPlayerListHeader(final @NotNull ComponentLike header) {
+  default void sendPlayerListHeader(final ComponentLike header) {
     this.sendPlayerListHeader(header.asComponent());
   }
 
@@ -324,7 +323,7 @@ default void sendPlayerListHeader(final @NotNull ComponentLike header) {
    * @param header the header
    * @since 4.3.0
    */
-  default void sendPlayerListHeader(final @NotNull Component header) {
+  default void sendPlayerListHeader(final Component header) {
     this.sendPlayerListHeaderAndFooter(header, Component.empty());
   }
 
@@ -338,7 +337,7 @@ default void sendPlayerListHeader(final @NotNull Component header) {
    * @since 4.3.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendPlayerListFooter(final @NotNull ComponentLike footer) {
+  default void sendPlayerListFooter(final ComponentLike footer) {
     this.sendPlayerListFooter(footer.asComponent());
   }
 
@@ -351,7 +350,7 @@ default void sendPlayerListFooter(final @NotNull ComponentLike footer) {
    * @param footer the footer
    * @since 4.3.0
    */
-  default void sendPlayerListFooter(final @NotNull Component footer) {
+  default void sendPlayerListFooter(final Component footer) {
     this.sendPlayerListHeaderAndFooter(Component.empty(), footer);
   }
 
@@ -363,7 +362,7 @@ default void sendPlayerListFooter(final @NotNull Component footer) {
    * @since 4.3.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendPlayerListHeaderAndFooter(final @NotNull ComponentLike header, final @NotNull ComponentLike footer) {
+  default void sendPlayerListHeaderAndFooter(final ComponentLike header, final ComponentLike footer) {
     this.sendPlayerListHeaderAndFooter(header.asComponent(), footer.asComponent());
   }
 
@@ -374,7 +373,7 @@ default void sendPlayerListHeaderAndFooter(final @NotNull ComponentLike header,
    * @param footer the footer
    * @since 4.3.0
    */
-  default void sendPlayerListHeaderAndFooter(final @NotNull Component header, final @NotNull Component footer) {
+  default void sendPlayerListHeaderAndFooter(final Component header, final Component footer) {
   }
 
   /**
@@ -385,7 +384,7 @@ default void sendPlayerListHeaderAndFooter(final @NotNull Component header, fina
    * @since 4.0.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void showTitle(final @NotNull Title title) {
+  default void showTitle(final Title title) {
     final Title.Times times = title.times();
     if (times != null) this.sendTitlePart(TitlePart.TIMES, times);
 
@@ -401,7 +400,7 @@ default void showTitle(final @NotNull Title title) {
    * @param <T> the type of the value of the part
    * @since 4.9.0
    */
-  default <T> void sendTitlePart(final @NotNull TitlePart<T> part, final @NotNull T value) {
+  default <T> void sendTitlePart(final TitlePart<T> part, final T value) {
   }
 
   /**
@@ -429,7 +428,7 @@ default void resetTitle() {
    * @see BossBar
    * @since 4.0.0
    */
-  default void showBossBar(final @NotNull BossBar bar) {
+  default void showBossBar(final BossBar bar) {
   }
 
   /**
@@ -439,7 +438,7 @@ default void showBossBar(final @NotNull BossBar bar) {
    * @see BossBar
    * @since 4.0.0
    */
-  default void hideBossBar(final @NotNull BossBar bar) {
+  default void hideBossBar(final BossBar bar) {
   }
 
   /**
@@ -451,7 +450,7 @@ default void hideBossBar(final @NotNull BossBar bar) {
    * @see Sound
    * @since 4.0.0
    */
-  default void playSound(final @NotNull Sound sound) {
+  default void playSound(final Sound sound) {
   }
 
   /**
@@ -464,7 +463,7 @@ default void playSound(final @NotNull Sound sound) {
    * @see Sound
    * @since 4.0.0
    */
-  default void playSound(final @NotNull Sound sound, final double x, final double y, final double z) {
+  default void playSound(final Sound sound, final double x, final double y, final double z) {
   }
 
   /**
@@ -481,7 +480,7 @@ default void playSound(final @NotNull Sound sound, final double x, final double
    * @param emitter an emitter
    * @since 4.8.0
    */
-  default void playSound(final @NotNull Sound sound, final Sound.@NotNull Emitter emitter) {
+  default void playSound(final Sound sound, final Sound.Emitter emitter) {
   }
 
   /**
@@ -491,7 +490,7 @@ default void playSound(final @NotNull Sound sound, final Sound.@NotNull Emitter
    * @since 4.8.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void stopSound(final @NotNull Sound sound) {
+  default void stopSound(final Sound sound) {
     this.stopSound(Objects.requireNonNull(sound, "sound").asStop());
   }
 
@@ -502,7 +501,7 @@ default void stopSound(final @NotNull Sound sound) {
    * @see SoundStop
    * @since 4.0.0
    */
-  default void stopSound(final @NotNull SoundStop stop) {
+  default void stopSound(final SoundStop stop) {
   }
 
   /**
@@ -515,7 +514,7 @@ default void stopSound(final @NotNull SoundStop stop) {
    * @since 4.0.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void openBook(final Book.@NotNull Builder book) {
+  default void openBook(final Book.Builder book) {
     this.openBook(book.build());
   }
 
@@ -528,7 +527,7 @@ default void openBook(final Book.@NotNull Builder book) {
    * @see Book
    * @since 4.0.0
    */
-  default void openBook(final @NotNull Book book) {
+  default void openBook(final Book book) {
   }
 
   // ------------------------
@@ -546,7 +545,7 @@ default void openBook(final @NotNull Book book) {
    * @since 4.15.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendResourcePacks(final @NotNull ResourcePackInfoLike first, final @NotNull ResourcePackInfoLike... others) {
+  default void sendResourcePacks(final ResourcePackInfoLike first, final ResourcePackInfoLike... others) {
     this.sendResourcePacks(ResourcePackRequest.addingRequest(first, others));
   }
 
@@ -560,7 +559,7 @@ default void sendResourcePacks(final @NotNull ResourcePackInfoLike first, final
    * @since 4.15.0
    */
   @ForwardingAudienceOverrideNotRequired
-  default void sendResourcePacks(final @NotNull ResourcePackRequestLike request) {
+  default void sendResourcePacks(final ResourcePackRequestLike request) {
     this.sendResourcePacks(request.asResourcePackRequest());
   }
 
@@ -573,7 +572,7 @@ default void sendResourcePacks(final @NotNull ResourcePackRequestLike request) {
    * @see ResourcePackInfo
    * @since 4.15.0
    */
-  default void sendResourcePacks(final @NotNull ResourcePackRequest request) {
+  default void sendResourcePacks(final ResourcePackRequest request) {
   }
 
   /**
@@ -584,7 +583,7 @@ default void sendResourcePacks(final @NotNull ResourcePackRequest request) {
    * @sinceMinecraft 1.20.3
    */
   @ForwardingAudienceOverrideNotRequired
-  default void removeResourcePacks(final @NotNull ResourcePackRequestLike request) {
+  default void removeResourcePacks(final ResourcePackRequestLike request) {
     this.removeResourcePacks(request.asResourcePackRequest());
   }
 
@@ -596,7 +595,7 @@ default void removeResourcePacks(final @NotNull ResourcePackRequestLike request)
    * @sinceMinecraft 1.20.3
    */
   @ForwardingAudienceOverrideNotRequired
-  default void removeResourcePacks(final @NotNull ResourcePackRequest request) {
+  default void removeResourcePacks(final ResourcePackRequest request) {
     final List<ResourcePackInfo> infos = request.packs();
     if (infos.size() == 1) {
       this.removeResourcePacks(infos.getFirst().id());
@@ -620,7 +619,7 @@ default void removeResourcePacks(final @NotNull ResourcePackRequest request) {
    * @sinceMinecraft 1.20.3
    */
   @ForwardingAudienceOverrideNotRequired
-  default void removeResourcePacks(final @NotNull ResourcePackInfoLike request, final @NotNull ResourcePackInfoLike @NotNull... others) {
+  default void removeResourcePacks(final ResourcePackInfoLike request, final ResourcePackInfoLike ... others) {
     final UUID[] otherReqs = new UUID[others.length];
     for (int i = 0; i < others.length; i++) {
       otherReqs[i] = others[i].asResourcePackInfo().id();
@@ -635,7 +634,7 @@ default void removeResourcePacks(final @NotNull ResourcePackInfoLike request, fi
    * @since 4.16.0
    * @sinceMinecraft 1.20.3
    */
-  default void removeResourcePacks(final @NotNull Iterable<UUID> ids) {
+  default void removeResourcePacks(final Iterable<UUID> ids) {
     // break these out to id + arrays
     final Iterator<UUID> it = ids.iterator();
     if (!it.hasNext()) return;
@@ -668,7 +667,7 @@ default void removeResourcePacks(final @NotNull Iterable<UUID> ids) {
    * @since 4.15.0
    * @sinceMinecraft 1.20.3
    */
-  default void removeResourcePacks(final @NotNull UUID id, final @NotNull UUID@NotNull... others) {
+  default void removeResourcePacks(final UUID id, final UUID... others) {
   }
 
   /**
@@ -693,7 +692,7 @@ default void clearResourcePacks() {
    * @since 4.22.0
    * @sinceMinecraft 1.21.6
    */
-  default void showDialog(final @NotNull DialogLike dialog) {
+  default void showDialog(final DialogLike dialog) {
   }
 
   /**

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

@@ -30,7 +30,6 @@
 import java.util.stream.Collectors;
 import net.kyori.adventure.resource.ResourcePackCallback;
 import net.kyori.adventure.text.ComponentLike;
-import org.jetbrains.annotations.NotNull;
 
 /**
  * {@link Audience}-related utilities.
@@ -53,11 +52,11 @@ 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);
   }
 
-  static @NotNull ResourcePackCallback unwrapCallback(final Audience forwarding, final Audience dest, final @NotNull ResourcePackCallback cb) {
+  static ResourcePackCallback unwrapCallback(final Audience forwarding, final Audience dest, final ResourcePackCallback cb) {
     if (cb == ResourcePackCallback.noOp()) return cb;
 
     return (uuid, status, audience) -> {