Bumped version to 3.0.0-pre1

Updated deprecation annotations to mark methods for removal in version 3.0.0. Added `@since 3.0.0` annotations to newly introduced methods in `CurrencyHolder`.

Author: NonSwag

src/main/java/net/thenextlvl/service/api/economy/Account.java

@@ -28,7 +28,7 @@ public interface Account extends Comparable<Account> {
      * @return the new balance after the deposit
      * @deprecated use {@link #deposit(Number, Currency)}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default BigDecimal deposit(Number amount) {
         return deposit(amount, getController().getDefaultCurrency());
     }
@@ -48,7 +48,7 @@ default BigDecimal deposit(Number amount) {
      * @return the balance of the account
      * @deprecated use {@link #getBalance(Currency)}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default BigDecimal getBalance() {
         return getBalance(getController().getDefaultCurrency());
     }
@@ -62,7 +62,7 @@ default BigDecimal getBalance() {
      * @return the new balance after the withdrawal
      * @deprecated use {@link #withdraw(Number, Currency)}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default BigDecimal withdraw(Number amount) {
         return withdraw(amount, getController().getDefaultCurrency());
     }
@@ -99,7 +99,7 @@ default BigDecimal withdraw(Number amount) {
      * @deprecated use {@link #compareTo(Account, Currency)}
      */
     @Override
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default int compareTo(Account account) {
         return compareTo(account, getController().getDefaultCurrency());
     }
@@ -122,7 +122,7 @@ default int compareTo(Account account, Currency currency) {
      * @param balance the new balance of the account
      * @deprecated use {@link #setBalance(Number, Currency)}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default void setBalance(Number balance) {
         setBalance(balance, getController().getDefaultCurrency());
     }

src/main/java/net/thenextlvl/service/api/economy/EconomyController.java

@@ -28,7 +28,7 @@ public interface EconomyController extends Controller, CurrencyHolder {
      * @return the plural form of the currency name as a string
      * @deprecated use {@link Currency#getDisplayNamePlural(Locale)}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default String getCurrencyNamePlural(Locale locale) {
         return PlainTextComponentSerializer.plainText().serialize(getDefaultCurrency().getDisplayNamePlural(locale));
     }
@@ -40,7 +40,7 @@ default String getCurrencyNamePlural(Locale locale) {
      * @return the name of the currency as a string
      * @deprecated use {@link Currency#getDisplayNameSingular(Locale)}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default String getCurrencyNameSingular(Locale locale) {
         return PlainTextComponentSerializer.plainText().serialize(getDefaultCurrency().getDisplayNameSingular(locale));
     }
@@ -51,7 +51,7 @@ default String getCurrencyNameSingular(Locale locale) {
      * @return the currency symbol as a string
      * @deprecated use {@link Currency#getSymbol()}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default String getCurrencySymbol() {
         return PlainTextComponentSerializer.plainText().serialize(getDefaultCurrency().getSymbol());
     }

src/main/java/net/thenextlvl/service/api/economy/currency/CurrencyHolder.java

@@ -21,7 +21,7 @@ public interface CurrencyHolder {
      * @return the formatted amount as a string
      * @deprecated use {@link Currency#format(Number, Locale)}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default String format(Number amount) {
         return PlainTextComponentSerializer.plainText().serialize(getDefaultCurrency().format(amount, Locale.US));
     }
@@ -32,7 +32,7 @@ default String format(Number amount) {
      * @return the number of fractional digits used for formatting currency amounts
      * @deprecated use {@link Currency#getFractionalDigits()}
      */
-    @Deprecated(forRemoval = true, since = "2.4.0")
+    @Deprecated(forRemoval = true, since = "3.0.0")
     default int fractionalDigits() {
         return getDefaultCurrency().getFractionalDigits();
     }
@@ -42,6 +42,7 @@ default int fractionalDigits() {
      *
      * @return an unmodifiable set of currencies
      * @throws UnsupportedOperationException if {@link #hasMultiCurrencySupport()} is {@code false}
+     * @since 3.0.0
      */
     default @Unmodifiable Set<Currency> getCurrencies() {
         throw new UnsupportedOperationException("Not implemented yet");
@@ -53,6 +54,7 @@ default int fractionalDigits() {
      * @param name the name of the currency to retrieve
      * @return an {@code Optional} containing the currency, or empty
      * @throws UnsupportedOperationException if {@link #hasMultiCurrencySupport()} is {@code false}
+     * @since 3.0.0
      */
     default Optional<Currency> getCurrency(String name) {
         throw new UnsupportedOperationException("Not implemented yet");
@@ -64,6 +66,7 @@ default Optional<Currency> getCurrency(String name) {
      * @param name the name of the currency to check for existence
      * @return {@code true} if the currency exists, otherwise {@code false}
      * @throws UnsupportedOperationException if {@link #hasMultiCurrencySupport()} is {@code false}
+     * @since 3.0.0
      */
     default boolean hasCurrency(String name) {
         throw new UnsupportedOperationException("Not implemented yet");
@@ -78,6 +81,7 @@ default boolean hasCurrency(String name) {
      * @param builder a consumer to configure the {@link Currency.Builder} for currency creation
      * @return an optional containing the created {@link Currency}, or empty
      * @throws UnsupportedOperationException if {@link #hasMultiCurrencySupport()} is {@code false}
+     * @since 3.0.0
      */
     default Optional<Currency> createCurrency(String name, Consumer<Currency.Builder> builder) {
         throw new UnsupportedOperationException("Not implemented yet");
@@ -89,6 +93,7 @@ default Optional<Currency> createCurrency(String name, Consumer<Currency.Builder
      * @param name the name of the currency to delete
      * @return {@code true} if the currency was successfully deleted, otherwise {@code false}
      * @throws UnsupportedOperationException if {@link #hasMultiCurrencySupport()} is {@code false}
+     * @since 3.0.0
      */
     default boolean deleteCurrency(String name) {
         throw new UnsupportedOperationException("Not implemented yet");
@@ -98,6 +103,7 @@ default boolean deleteCurrency(String name) {
      * Retrieves the default currency for this economy controller.
      *
      * @return the default currency
+     * @since 3.0.0
      */
     Currency getDefaultCurrency();
 
@@ -111,6 +117,7 @@ default boolean deleteCurrency(String name) {
      * @see #getCurrencies()
      * @see #getCurrency(String)
      * @see #hasCurrency(String)
+     * @since 3.0.0
      */
     default boolean hasMultiCurrencySupport() {
         return false;