proof of concept of loading html to define ui

DEPENDENCIES.md

@@ -21,3 +21,4 @@
  - [MathUtils](https://github.com/StudioRailgun/MathUtils) --- [MIT](https://github.com/StudioRailgun/MathUtils/blob/main/LICENSE)
  - [DataStructures](https://github.com/StudioRailgun/DataStructures) --- [MIT](https://github.com/StudioRailgun/DataStructures/blob/main/LICENSE)
  - [Typescript](https://github.com/microsoft/TypeScript) --- [Apache 2](https://github.com/microsoft/TypeScript/blob/main/LICENSE.txt)
+ - [JSoup](https://jsoup.org/) --- [MIT](https://github.com/jhy/jsoup/blob/master/LICENSE)

assets/Data/menu/npcintro.html

@@ -0,0 +1 @@
+<p>Hello!</p>

docs/src/progress/renderertodo.md

@@ -1680,6 +1680,8 @@ Block pathing work
 
 (05/05/2025)
 Scaffolding for structure scanning service
+Add JSoup dependency
+Proof of concept of loading html to define ui
 
 
 

pom.xml

@@ -296,6 +296,14 @@
             <classifier>${lwjgl.natives}</classifier>
         </dependency>
 
+        <!--JSoup-->
+        <!--License: MIT-->
+        <dependency>
+            <groupId>org.jsoup</groupId>
+            <artifactId>jsoup</artifactId>
+            <version>1.20.1</version>
+        </dependency>
+
         <!--MathUtils-->
         <!--License: MIT-->
         <dependency>
@@ -313,6 +321,7 @@
         </dependency>
 
 
+
     </dependencies>
 
     <profiles>

src/main/java/electrosphere/client/ui/menu/debug/ImGuiUIFramework.java

@@ -1,5 +1,6 @@
 package electrosphere.client.ui.menu.debug;
 
+import electrosphere.client.ui.menu.dialog.DialogMenuGenerator;
 import electrosphere.engine.Globals;
 import electrosphere.logger.LoggerInterface;
 import electrosphere.renderer.debug.DebugRendering;
@@ -44,6 +45,10 @@ public class ImGuiUIFramework {
                     printUITrees();
                 }
 
+                if(ImGui.button("Test load dialog")){
+                    DialogMenuGenerator.displayDialog("Data/menu/npcintro.html");
+                }
+
             }
         });
         uiFrameworkWindow.setOpen(false);

src/main/java/electrosphere/client/ui/menu/dialog/DialogMenuGenerator.java

@@ -0,0 +1,41 @@
+package electrosphere.client.ui.menu.dialog;
+
+import java.io.IOException;
+
+import org.jsoup.Jsoup;
+import org.jsoup.nodes.Document;
+import org.jsoup.nodes.Node;
+
+import electrosphere.client.ui.parsing.HtmlParser;
+import electrosphere.renderer.ui.elements.Div;
+import electrosphere.renderer.ui.elementtypes.Element;
+import electrosphere.util.FileUtils;
+
+/**
+ * Generates dialog menus
+ */
+public class DialogMenuGenerator {
+    
+    /**
+     * Displays a dialog menu
+     * @param path The path to the html
+     * @return The element that is the root for the window
+     */
+    public static Element displayDialog(String path){
+        Div container = Div.createCol();
+        try {
+            String content = FileUtils.getAssetFileAsString(path);
+            Document doc = Jsoup.parseBodyFragment(content);
+            Node bodyNode = doc.getElementsByTag("body").first();
+            for(Node node : bodyNode.childNodes()){
+                container.addChild(
+                    HtmlParser.recursivelyParseChildren(node));
+            }
+        } catch (IOException e) {
+            // TODO Auto-generated catch block
+            e.printStackTrace();
+        }
+        return container;
+    }
+
+}

src/main/java/electrosphere/client/ui/parsing/HtmlParser.java

@@ -0,0 +1,46 @@
+package electrosphere.client.ui.parsing;
+
+import org.jsoup.nodes.Node;
+
+import electrosphere.renderer.ui.elements.Div;
+import electrosphere.renderer.ui.elements.Label;
+import electrosphere.renderer.ui.elementtypes.Element;
+
+/**
+ * Converts HTML to engine elements
+ */
+public class HtmlParser {
+    
+    /**
+     * Recursively parses a jsoup node into engine ui elements
+     * @param jsoupNode The jsoup node
+     * @return The engine ui elements
+     */
+    public static Element recursivelyParseChildren(Node jsoupNode){
+        String tag = jsoupNode.nodeName();
+        Element rVal = null;
+        switch(tag){
+            case "p": {
+                rVal = Div.createDiv();
+                for(Node child : jsoupNode.childNodes()){
+                    ((Div)rVal).addChild(HtmlParser.recursivelyParseChildren(child));
+                }
+            } break;
+            case "#text": {
+                String content = jsoupNode.outerHtml();
+                rVal = Label.createLabel(content);
+            } break;
+            case "div": {
+                rVal = Div.createDiv();
+                for(Node child : jsoupNode.childNodes()){
+                    ((Div)rVal).addChild(HtmlParser.recursivelyParseChildren(child));
+                }
+            } break;
+            default: {
+                throw new Error("Unsupported element type " + tag);
+            }
+        }
+        return Div.createDiv();
+    }
+
+}