feat: render structured checker paths

Fixes #80

Author: Philip Z

examples/conformance/lib/pom.xml

@@ -52,7 +52,7 @@
         <dependency>
           <groupId>io.teaql</groupId>
           <artifactId>teaql-sqlite</artifactId>
-          <version>1.538-RELEASE</version>
+          <version>1.539-RELEASE</version>
         </dependency>
     <dependency>
       <groupId>io.teaql</groupId>
@@ -124,4 +124,4 @@
       <url>https://maven.teaql.io/repository/maven-releases/</url>
     </repository>
   </distributionManagement>
-</project>
+</project>

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>io.teaql</groupId>
     <artifactId>teaql-java-parent</artifactId>
-    <version>1.538-RELEASE</version>
+    <version>1.539-RELEASE</version>
     <packaging>pom</packaging>
 
     <name>teaql-java-parent</name>

teaql-android/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.teaql</groupId>
         <artifactId>teaql-java-parent</artifactId>
-        <version>1.538-RELEASE</version>
+        <version>1.539-RELEASE</version>
     </parent>
 
     <artifactId>teaql-android</artifactId>

teaql-business-id-jdbc/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.teaql</groupId>
         <artifactId>teaql-java-parent</artifactId>
-        <version>1.538-RELEASE</version>
+        <version>1.539-RELEASE</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
 

teaql-cloud/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>io.teaql</groupId>
         <artifactId>teaql-java-parent</artifactId>
-        <version>1.538-RELEASE</version>
+        <version>1.539-RELEASE</version>
     </parent>
     <artifactId>teaql-cloud</artifactId>
     <name>teaql-cloud</name>

teaql-context-runtime-tools/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>io.teaql</groupId>
         <artifactId>teaql-java-parent</artifactId>
-        <version>1.538-RELEASE</version>
+        <version>1.539-RELEASE</version>
     </parent>
 
     <artifactId>teaql-context-runtime-tools</artifactId>

teaql-core/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>io.teaql</groupId>
         <artifactId>teaql-java-parent</artifactId>
-        <version>1.538-RELEASE</version>
+        <version>1.539-RELEASE</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
 

teaql-core/src/main/java/io/teaql/core/checker/ObjectLocation.java

@@ -1,5 +1,8 @@
 package io.teaql.core.checker;
 
+import java.util.ArrayList;
+import java.util.List;
+
 public class ObjectLocation {
     private ObjectLocation parent;
 
@@ -45,4 +48,56 @@ public boolean isSecondLevel() {
     public boolean isThirdLevel() {
         return getLevel() == 3;
     }
+
+    /** Canonical casing-neutral path using KSML property names. */
+    public String modelPath() {
+        return render(false, false);
+    }
+
+    /** Java diagnostic path using lower-camel property names. */
+    public String nativePath() {
+        return render(true, false);
+    }
+
+    /** RFC 6901 JSON pointer using TeaQL's default lower-camel wire policy. */
+    public String instancePath() {
+        return render(true, true);
+    }
+
+    private String render(boolean lowerCamel, boolean pointer) {
+        List<ObjectLocation> locations = new ArrayList<>();
+        for (ObjectLocation current = this; current != null; current = current.getParent()) {
+            locations.add(0, current);
+        }
+        StringBuilder result = new StringBuilder();
+        for (ObjectLocation location : locations) {
+            if (location instanceof HashLocation hash) {
+                String member = lowerCamel ? lowerCamel(hash.getMember()) : hash.getMember();
+                if (pointer) {
+                    result.append('/').append(escapePointer(member));
+                } else {
+                    if (!result.isEmpty()) result.append('.');
+                    result.append(member);
+                }
+            } else if (location instanceof ArrayLocation array) {
+                if (pointer) result.append('/').append(array.getIndex());
+                else result.append('[').append(array.getIndex()).append(']');
+            }
+        }
+        return result.toString();
+    }
+
+    private static String lowerCamel(String name) {
+        String[] parts = name.split("_", -1);
+        StringBuilder result = new StringBuilder(parts.length == 0 ? "" : parts[0]);
+        for (int i = 1; i < parts.length; i++) {
+            if (parts[i].isEmpty()) continue;
+            result.append(Character.toUpperCase(parts[i].charAt(0))).append(parts[i].substring(1));
+        }
+        return result.toString();
+    }
+
+    private static String escapePointer(String value) {
+        return value.replace("~", "~0").replace("/", "~1");
+    }
 }

teaql-core/src/test/java/io/teaql/core/checker/ObjectLocationTest.java

@@ -5,6 +5,23 @@
 
 public class ObjectLocationTest {
 
+    @Test
+    public void rendersCanonicalNativeAndExternalPaths() {
+        ObjectLocation location = ObjectLocation.hashRoot("order_items")
+                .element(2)
+                .member("user_url");
+
+        assertEquals("order_items[2].user_url", location.modelPath());
+        assertEquals("orderItems[2].userUrl", location.nativePath());
+        assertEquals("/orderItems/2/userUrl", location.instancePath());
+        assertEquals("order_items[2].user_url", location.toString());
+    }
+
+    @Test
+    public void escapesJsonPointerMembers() {
+        assertEquals("/a~0~1b", ObjectLocation.hashRoot("a~/b").instancePath());
+    }
+
     @Test
     public void testObjectLocationFormattingAndNestingLevels() {
         // Test hashRoot

teaql-data-service-sql/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>io.teaql</groupId>
         <artifactId>teaql-java-parent</artifactId>
-        <version>1.538-RELEASE</version>
+        <version>1.539-RELEASE</version>
         <relativePath>../pom.xml</relativePath>
     </parent>