Add first empty slot expression

Author: sovdeeth

src/main/java/ch/njol/skript/expressions/ExprFirstEmptySlot.java

@@ -0,0 +1,41 @@
+package ch.njol.skript.expressions;
+
+import ch.njol.skript.Skript;
+import ch.njol.skript.expressions.base.SimplePropertyExpression;
+import ch.njol.skript.lang.ExpressionType;
+import ch.njol.skript.util.slot.InventorySlot;
+import ch.njol.skript.util.slot.Slot;
+import org.bukkit.inventory.Inventory;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
+public class ExprFirstEmptySlot extends SimplePropertyExpression<Inventory, Slot> {
+
+	static {
+		// support `first empty slot in inventory` as well as typical property syntax
+		List<String> patterns = new ArrayList<>(Arrays.asList(getPatterns("first empty slot", "inventory")));
+		patterns.add("[the] first empty slot in %inventory%");
+		Skript.registerExpression(ExprFirstEmptySlot.class, Slot.class, ExpressionType.PROPERTY, patterns.toArray(new String[0]));
+	}
+
+	@Override
+	public @Nullable Slot convert(Inventory from) {
+		int slotIndex = from.firstEmpty();
+		if (slotIndex == -1)
+			return null; // No empty slot found
+		return new InventorySlot(from, slotIndex);
+	}
+
+	@Override
+	public Class<? extends Slot> getReturnType() {
+		return Slot.class;
+	}
+
+	@Override
+	protected String getPropertyName() {
+		return "first empty slot";
+	}
+}

src/test/skript/tests/syntaxes/expressions/ExprFirstEmptySlot.sk

@@ -0,0 +1,13 @@
+test "first empty slot":
+	set {_inv} to a chest inventory with 3 rows
+	assert the index of the first empty slot in {_inv} is 0 with "First empty slot in empty inventory should be 0"
+	set slot 0 of {_inv} to a stone
+	assert the index of the first empty slot in {_inv} is 1 with "First empty slot in inventory should be 1"
+	set slot 3 of {_inv} to a stone
+	assert the index of the first empty slot in {_inv} is 1 with "First empty slot in inventory should be 1"
+	set slot 1 of {_inv} to a stone
+	assert the index of the first empty slot in {_inv} is 2 with "First empty slot in inventory should be 2"
+
+	set first empty slot of {_inv} to diamond sword
+	assert slot 2 of {_inv} is a diamond sword with "First empty slot should be set to diamond sword"
+	assert the index of the first empty slot in {_inv} is 4 with "First empty slot in inventory should be 4"