🐛 fix monster variants

- use versions of monsters from source data
- remove notes per conjured spell level
- look for the most specific version key for determining reprints

src/main/java/dev/ebullient/convert/tools/JsonNodeReader.java

@@ -453,12 +453,16 @@ default ArrayNode ensureArrayIn(JsonNode target) {
         return target.withArray(this.nodeName());
     }
 
+    default JsonNode copyFrom(JsonNode source) {
+        return getFrom(source).deepCopy();
+    }
+
     /** Destructive! */
-    default void removeFrom(JsonNode target) {
+    default JsonNode removeFrom(JsonNode target) {
         if (target == null) {
-            return;
+            return null;
         }
-        ((ObjectNode) target).remove(this.nodeName());
+        return ((ObjectNode) target).remove(this.nodeName());
     }
 
     /** Destructive! */
@@ -497,4 +501,15 @@ default void link(JsonNode source, JsonNode target) {
         }
         ((ObjectNode) target).set(this.nodeName(), getFrom(source));
     }
+
+    /** Destructive! */
+    default void moveFrom(JsonNode source, JsonNode target) {
+        if (source == null || target == null) {
+            return;
+        }
+        JsonNode value = removeFrom(source);
+        if (value != null) {
+            ((ObjectNode) target).set(this.nodeName(), value);
+        }
+    }
 }

src/main/java/dev/ebullient/convert/tools/JsonSourceCopier.java

@@ -85,17 +85,17 @@ public JsonNode handleCopy(T type, JsonNode copyTo) {
      * @param _copy Node containing metadata about the copy
      */
     protected void copyValues(T type, JsonNode copyFrom, ObjectNode copyTo, JsonNode _copy) {
-        JsonNode _preserve = MetaFields._preserve.getFromOrEmptyObjectNode(_copy);
+        JsonNode _preserve = MetaFields._preserve.getFrom(_copy); // null is ok
         // Copy required values from...
         for (Entry<String, JsonNode> from : iterableFields(copyFrom)) {
             String k = from.getKey();
             JsonNode copyToField = copyTo.get(k);
             if (copyToField != null && copyToField.isNull()) {
-                // copyToField exists as `null`. Remove the field.
+                // copyToField is present / exists as an intentional `null`. Remove the field.
                 copyTo.remove(k);
                 continue;
             }
-            if (copyToField == null) {
+            if (copyToField == null) { // undefined
                 // not already present in copyTo -- should we copyFrom?
                 // Do merge rules indicate the value should be preserved
                 if (mergePreserveKey(type, k)) {
@@ -166,7 +166,7 @@ protected void doModProp(
             case setProps -> doSetProps(originKey, modInfo, prop, target);
             case prefixSuffixStringProp -> doPrefixSuffixStringProp(originKey, modInfo, prop, target);
             // Arrays
-            case prependArr, appendArr, replaceArr, replaceOrAppendArr, appendIfNotExistsArr, insertArr, removeArr ->
+            case prependArr, appendArr, renameArr, replaceArr, replaceOrAppendArr, appendIfNotExistsArr, insertArr, removeArr ->
                 doModArray(originKey, mode, modInfo, prop, target);
             // MATH
             case scalarAddProp -> doScalarAddProp(originKey, modInfo, prop, target);
@@ -444,7 +444,7 @@ private void doModArray(String originKey, ModFieldMode mode, JsonNode modInfo, S
         String propPath = nodePath(prop);
 
         switch (mode) {
-            case insertArr, removeArr, replaceArr -> {
+            case insertArr, removeArr, renameArr, replaceArr -> {
                 if (target.at(propPath).isMissingNode()) {
                     tui().errorf("Error (%s): Unable to %s; %s is not present: %s", originKey, mode, prop, target);
                     return;
@@ -464,6 +464,7 @@ private void doModArray(String originKey, ModFieldMode mode, JsonNode modInfo, S
                     MetaFields.index.intFrom(modInfo).filter(n -> n >= 0).orElse(targetArray.size()),
                     items);
             case removeArr -> removeFromArray(originKey, modInfo, prop, targetArray);
+            case renameArr -> renameInArray(originKey, modInfo, targetArray);
             case replaceArr -> replaceArray(originKey, modInfo, targetArray, items);
             case replaceOrAppendArr -> {
                 boolean didReplace = !targetArray.isEmpty() && replaceArray(originKey, modInfo, targetArray, items);
@@ -557,6 +558,21 @@ public void removeFromArr(ArrayNode tgtArray, JsonNode items) {
         }
     }
 
+    protected void renameInArray(String originKey, JsonNode modInfo, ArrayNode tgtArray) {
+        JsonNode renames = ensureArray(MetaFields.renames.getFrom(modInfo));
+        if (renames == null || !renames.isArray()) {
+            return;
+        }
+
+        for (JsonNode renameNode : iterableElements(renames)) {
+            int index = findIndexByName(originKey, tgtArray, MetaFields.rename.getTextOrEmpty(renameNode));
+            if (index >= 0) {
+                JsonNode element = tgtArray.get(index);
+                SourceField.name.setIn(element, MetaFields.with.getFrom(renameNode));
+            }
+        }
+    }
+
     protected boolean replaceArray(String originKey, JsonNode modInfo, ArrayNode tgtArray, JsonNode items) {
         if (items == null || !items.isArray()) {
             return false;
@@ -657,6 +673,8 @@ public enum MetaFields implements JsonNodeReader {
         props,
         range,
         regex,
+        rename,
+        renames,
         replace,
         root,
         scalar,
@@ -696,6 +714,7 @@ public enum ModFieldMode implements JsonNodeReader.FieldValue {
 
         prependArr,
         appendArr,
+        renameArr,
         replaceArr,
         replaceOrAppendArr,
         appendIfNotExistsArr,

src/main/java/dev/ebullient/convert/tools/ToolsIndex.java

@@ -16,11 +16,13 @@
 public interface ToolsIndex {
     // Special one-offs for accounting/tracking
     enum TtrpgValue implements JsonNodeReader {
-        indexKey,
-        indexInputType,
         indexBaseItem,
-        isHomebrew,
         indexFluffKey,
+        indexInputType,
+        indexKey,
+        indexParentKey,
+        indexVersionKeys,
+        isHomebrew,
     }
 
     static ToolsIndex createIndex() {