Limit exposure to too many KnowledgeService methods with some starting "API" + javadoc

Author: 62832

src/main/java/gripe/_90/appliede/AppliedE.java

@@ -58,6 +58,7 @@
 import gripe._90.appliede.me.misc.LearnAllItemsPacket;
 import gripe._90.appliede.me.misc.TransmutationTerminalHost;
 import gripe._90.appliede.me.service.KnowledgeService;
+import gripe._90.appliede.me.service.KnowledgeServiceImpl;
 import gripe._90.appliede.me.service.TransmutationPattern;
 import gripe._90.appliede.menu.EMCInterfaceMenu;
 import gripe._90.appliede.menu.EMCSetStockAmountMenu;
@@ -85,7 +86,7 @@ public final class AppliedE {
     @SuppressWarnings("UnstableApiUsage")
     public static final DeferredItem<Item> EMC_MODULE = ITEMS.register("emc_module", () -> {
         AEKeyTypes.register(EMCKeyType.TYPE);
-        GridServices.register(KnowledgeService.class, KnowledgeService.class);
+        GridServices.register(KnowledgeService.class, KnowledgeServiceImpl.class);
         ContainerItemStrategy.register(EMCKeyType.TYPE, EMCKey.class, EMCContainerItemStrategy.INSTANCE);
         return part(EMCModulePart.class, EMCModulePart::new);
     });

src/main/java/gripe/_90/appliede/me/misc/TransmutationCapable.java

@@ -2,11 +2,31 @@
 
 import appeng.api.networking.security.IActionHost;
 
+/**
+ * An extension of {@link IActionHost} implemented on machines or other objects (such as {@linkplain
+ * gripe._90.appliede.menu.TransmutationTerminalMenu menus}) capable of transmuting items into / out of EMC when
+ * carrying out regular {@linkplain appeng.api.networking.storage.IStorageService storage service} I/O.
+ */
 public interface TransmutationCapable extends IActionHost {
+    /**
+     * @return Whether this machine is allowed to "learn" an inserted item on behalf of the player owning the associated
+     * grid node.
+     */
     boolean mayLearn();
 
+    /**
+     * Overridden to provide custom behaviour upon {@linkplain TransmutationCapable#mayLearn() learning} an item, e.g.
+     * {@link gripe._90.appliede.menu.TransmutationTerminalMenu TransmutationTerminalMenu} displaying a text label on
+     * its associated screen.
+     */
     default void onLearn() {}
 
+    /**
+     * @return Whether this machine should consume any network power specifically when <i>inserting</i> items into
+     * storage to turn into EMC. This should typically only be overridden if a machine isn't meant primarily for
+     * insertion to begin with but may still need to insert items back in case of overflow issues when already
+     * retrieved, such as the {@linkplain gripe._90.appliede.part.EMCExportBusPart Transmutation Export Bus}.
+     */
     default boolean consumePowerOnInsert() {
         return true;
     }

src/main/java/gripe/_90/appliede/me/service/EMCStorage.java

@@ -30,7 +30,7 @@
 import moze_intel.projecte.api.capabilities.IKnowledgeProvider;
 import moze_intel.projecte.api.proxy.IEMCProxy;
 
-record EMCStorage(KnowledgeService service, IEnergySource energy) implements MEStorage {
+record EMCStorage(KnowledgeServiceImpl service, IEnergySource energy) implements MEStorage {
     @Override
     public void getAvailableStacks(KeyCounter out) {
         var emc = service.getEMC();