📝 Add docstrings to feat/add-farmers-workbench

Docstrings generation was requested by @The-Code-Monkey.

* #54 (comment)

The following files were modified:

* `src/client/java/com/tcm/MineTale/block/workbenches/screen/ArmorersWorkbenchScreen.java`
* `src/client/java/com/tcm/MineTale/block/workbenches/screen/BuildersWorkbenchScreen.java`
* `src/client/java/com/tcm/MineTale/block/workbenches/screen/FarmersWorkbenchScreen.java`
* `src/client/java/com/tcm/MineTale/block/workbenches/screen/WorkbenchWorkbenchScreen.java`
* `src/client/java/com/tcm/MineTale/datagen/recipes/BuilderRecipes.java`
* `src/main/java/com/tcm/MineTale/MineTale.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/BuildersWorkbench.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/FarmersWorkbench.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/entity/BuildersWorkbenchEntity.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/menu/ArmorersWorkbenchMenu.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/menu/BuildersWorkbenchMenu.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/menu/CampfireWorkbenchMenu.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/menu/FarmersWorkbenchMenu.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/menu/FurnaceWorkbenchMenu.java`
* `src/main/java/com/tcm/MineTale/block/workbenches/menu/WorkbenchWorkbenchMenu.java`
* `src/main/java/com/tcm/MineTale/registry/ModRecipes.java`

Author: coderabbitai[bot]

src/client/java/com/tcm/MineTale/block/workbenches/screen/ArmorersWorkbenchScreen.java

@@ -72,10 +72,10 @@ private ArmorersWorkbenchScreen(ArmorersWorkbenchMenu menu, Inventory inventory,
     }
 
     /**
-     * Create a MineTaleRecipeBookComponent configured for the workbench screen.
+     * Creates a MineTaleRecipeBookComponent preconfigured for the armourer's workbench.
      *
-     * @param menu the workbench menu used to initialize the recipe book component
-     * @return a MineTaleRecipeBookComponent containing the workbench tab and associated recipe category
+     * @param menu the workbench menu used to bind the recipe book to the current container
+     * @return the configured MineTaleRecipeBookComponent containing the workbench tab and associated recipe type
      */
     private static MineTaleRecipeBookComponent createRecipeBookComponent(ArmorersWorkbenchMenu menu) {
         ItemStack tabIcon = new ItemStack(ModBlocks.ARMORERS_WORKBENCH_BLOCK.asItem());
@@ -88,12 +88,12 @@ private static MineTaleRecipeBookComponent createRecipeBookComponent(ArmorersWor
     }
 
     /**
-         * Configure the screen's GUI dimensions and initialize widgets.
-         *
-         * Sets the layout size (imageWidth = 176, imageHeight = 166), delegates remaining
-         * layout initialization to the superclass, and creates the three craft buttons
-         * ("1", "10", "All") wired to their respective handlers.
-         */
+     * Initialises the screen layout and registers three crafting buttons.
+     *
+     * Sets the GUI image dimensions, delegates further initialisation to the superclass,
+     * and creates three buttons that request crafting of 1, 10 or all results (the
+     * "all" action is represented by -1).
+     */
     @Override
     protected void init() {
         // Important: Set your GUI size before super.init()
@@ -119,45 +119,14 @@ protected void init() {
     }
 
     /**
-     * Sends a crafting request for the currently selected recipe in the integrated recipe book.
+     * Send a craft request for the recipe remembered by the screen's last known selection.
      *
-     * Locates the last recipe collection and last selected recipe ID from the recipe book component,
-     * resolves the recipe's result item, and sends a CraftRequestPayload to the server containing that
-     * item and the requested amount.
+     * Resolves the remembered recipe to its resulting item(s) and, if a result exists, sends a
+     * network CraftRequestPayload containing the first result and the specified amount. If there
+     * is no remembered selection or no results, no network payload is sent.
      *
-     * @param amount the quantity to craft; use -1 to request crafting of the full available stack ("All")
+     * @param amount the quantity to craft; use -1 to request crafting all available units
      */
-
-    // private void handleCraftRequest(int amount) {
-    //     // 1. Cast the book component to the Accessor to get the selected data
-    //     RecipeBookComponentAccessor accessor = (RecipeBookComponentAccessor) this.mineTaleRecipeBook;
-        
-    //     RecipeCollection collection = accessor.getLastRecipeCollection();
-    //     RecipeDisplayId displayId = accessor.getLastRecipe();
-
-    //     if (collection != null && displayId != null) {
-    //         // 2. Find the visual entry
-    //         for (RecipeDisplayEntry entry : collection.getSelectedRecipes(RecipeCollection.CraftableStatus.ANY)) {
-    //             if (entry.id().equals(displayId)) {
-    //                 // 3. Resolve result for the packet
-    //                 List<ItemStack> results = entry.resultItems(SlotDisplayContext.fromLevel(this.minecraft.level));
-                    
-    //                 if (!results.isEmpty()) {
-    //                     ItemStack resultStack = results.get(0);
-                        
-    //                     // 4. LOG FOR DEBUGGING
-    //                     System.out.println("Sending craft request for: " + resultStack + " amount: " + amount);
-                        
-    //                     ClientPlayNetworking.send(new CraftRequestPayload(resultStack, amount));
-    //                 }
-    //                 break;
-    //             }
-    //         }
-    //     } else {
-    //         System.out.println("Request failed: Collection or DisplayID is null!");
-    //     }
-    // }
-
     private void handleCraftRequest(int amount) {
         // Look at our "Memory" instead of the component
         if (this.lastKnownSelectedId != null) {