feat: enhance pagination management with max page tracking and UI adjustments

Author: 1robie

API/src/main/java/fr/maxlego08/menu/api/button/GenericPaginationButton.java

@@ -43,10 +43,12 @@ public final void onRender(@NotNull Player player, @NotNull InventoryEngine inve
         int pageSize = slots.size();
         int currentPage = getCurrentPageOneIndexed(player);
 
-        int maxPage = getMaxPage(player, pageSize) + 1;
+        int maxPage = getMaxPage(player, pageSize);
+        
+        getPaginationManager().setMaxPage(player.getUniqueId(), getContextId(player), maxPage);
 
         Pagination<T> pagination = new Pagination<>();
-        List<T> paginatedElements = pagination.paginate(elements, pageSize, currentPage - 1);
+        List<T> paginatedElements = pagination.paginate(elements, pageSize, currentPage);
 
         int slotIndex = 0;
         for (Integer slot : slots) {
@@ -55,7 +57,7 @@ public final void onRender(@NotNull Player player, @NotNull InventoryEngine inve
             T element = paginatedElements.get(slotIndex);
             Placeholders placeholders = new Placeholders();
             placeholders.register("page", String.valueOf(currentPage));
-            placeholders.register("max_page", String.valueOf(maxPage));
+            placeholders.register("max_page", String.valueOf(maxPage + 1));
 
             renderElement(player, inventory, slot, element, placeholders);
             slotIndex++;

API/src/main/java/fr/maxlego08/menu/api/pagination/PaginationManager.java

@@ -95,6 +95,24 @@ default boolean hasState(@NotNull UUID playerId, @NotNull String contextId) {
      */
     void removePlayerStates(@NotNull UUID playerId);
 
+    /**
+     * Gets the maximum page for a player and context.
+     *
+     * @param playerId  the player's UUID
+     * @param contextId the context identifier
+     * @return the maximum page (0-based index), or 0 if not found
+     */
+    int getMaxPage(@NotNull UUID playerId, @NotNull String contextId);
+
+    /**
+     * Sets the maximum page for a player and context.
+     *
+     * @param playerId  the player's UUID
+     * @param contextId the context identifier
+     * @param maxPage   the maximum page to set (0-based index)
+     */
+    void setMaxPage(@NotNull UUID playerId, @NotNull String contextId, int maxPage);
+
     /**
      * Clears all pagination states.
      */

API/src/main/java/fr/maxlego08/menu/api/pagination/PaginationState.java

@@ -2,6 +2,7 @@
 
 public class PaginationState {
     private int currentPage;
+    private int maxPage = 0;
 
     public PaginationState() {
         this(0);
@@ -39,8 +40,35 @@ public void previousPage() {
         }
     }
 
+    /**
+     * Gets the maximum page number (0-based index).
+     *
+     * @return the maximum page
+     */
+    public int getMaxPage() {
+        return maxPage;
+    }
+
+    /**
+     * Sets the maximum page number (0-based index).
+     *
+     * @param maxPage the maximum page to set
+     */
+    public void setMaxPage(int maxPage) {
+        this.maxPage = Math.max(0, maxPage);
+    }
+
+    /**
+     * Gets the maximum page number (1-based index for UI purposes).
+     *
+     * @return the maximum page (1-based)
+     */
+    public int getMaxPageOneIndexed() {
+        return this.maxPage + 1;
+    }
+
     @Override
     public String toString() {
-        return String.format("PaginationState{currentPage=%d}", currentPage);
+        return String.format("PaginationState{currentPage=%d, maxPage=%d}", currentPage, maxPage);
     }
 }

src/main/java/fr/maxlego08/menu/pagination/ZPaginationManager.java

@@ -45,6 +45,17 @@ public void reset(@NotNull UUID playerId, @NotNull String contextId) {
         removeState(playerId, contextId);
     }
 
+    @Override
+    public int getMaxPage(@NotNull UUID playerId, @NotNull String contextId) {
+        PaginationState state = getState(playerId, contextId);
+        return state != null ? state.getMaxPage() : 0;
+    }
+
+    @Override
+    public void setMaxPage(@NotNull UUID playerId, @NotNull String contextId, int maxPage) {
+        getOrCreateState(playerId, contextId).setMaxPage(maxPage);
+    }
+
     @Override
     public @Nullable PaginationState getState(@NotNull UUID playerId, @NotNull String contextId) {
         Map<String, PaginationState> playerStates = paginationStates.get(playerId);

src/main/java/fr/maxlego08/menu/placeholder/MenuPlaceholders.java

@@ -41,7 +41,7 @@ public void register(MenuPlugin plugin) {
 
         placeholder.register("pagination_next_page_", (player, contextId) -> {
             if (paginationManager == null) return "0";
-            return String.valueOf(paginationManager.getPage(player.getUniqueId(), contextId) + 1);
+            return String.valueOf(paginationManager.getPage(player.getUniqueId(), contextId) + 2);
         });
 
         placeholder.register("pagination_previous_page_", (player, contextId) -> {
@@ -50,6 +50,26 @@ public void register(MenuPlugin plugin) {
             return String.valueOf(Math.max(0, currentPage - 1));
         });
 
+        placeholder.register("pagination_max_page_", (player, contextId) -> {
+            if (paginationManager == null) return "1";
+            
+            String actualContextId = contextId;
+            int defaultMaxPage = 0;
+            
+            if (contextId.contains(":")) {
+                String[] parts = contextId.split(":", 2);
+                actualContextId = parts[0];
+                try {
+                    defaultMaxPage = Integer.parseInt(parts[1]);
+                } catch (NumberFormatException ignored) {
+                }
+            }
+            
+            int storedMaxPage = paginationManager.getMaxPage(player.getUniqueId(), actualContextId);
+            int maxPage = Math.max(storedMaxPage, defaultMaxPage);
+            return String.valueOf(maxPage + 1);
+        });
+        
         placeholder.register("player_previous_inventories", (playeofflinePlayer, s) -> {
             if (playeofflinePlayer.isOnline()) {
                 Player player = playeofflinePlayer.getPlayer();