Allow to iterate on JsonArray of JsonObject (#676)

Author: ia3andy

blog/content/docs/basics.adoc

@@ -458,7 +458,10 @@ Can be access with `{cdi:foo.bar}` in any template.
 
 == Template Extensions
 
-The Qute templating language supports a concept called https://quarkus.io/guides/qute#template-extension-methods[template extension methods]. These methods allow us to add functional to types and expose it in our templates. Moving logic from the template to Java code gives us the ability to use a more robust language for more complex logic and makes the functionality more easily reusable,as well as keeping our templates clean. Roq has several built-in template extensions (link:{roqjavadocmodelurl}RoqTemplateExtension.html[javadoc,window=_blank]):
+The Qute templating language supports a concept called https://quarkus.io/guides/qute#template-extension-methods[template extension methods]. These methods allow us to add functional to types and expose it in our templates. Moving logic from the template to Java code gives us the ability to use a more robust language for more complex logic and makes the functionality more easily reusable,as well as keeping our templates clean:
+
+- Qute provides https://quarkus.io/guides/qute-reference#built-in-template-extension[built-in template extensions,window=_blank]
+- Roq has several built-in template extensions (link:{roqjavadocmodelurl}RoqTemplateExtension.html[javadoc,window=_blank]):
 
 [cols="1,2", options="header"]
 |===
@@ -488,14 +491,11 @@ The Qute templating language supports a concept called https://quarkus.io/guides
 | ``page.contentAbstract(limit)``
 | Returns the page content limited to `limit` words
 
-| ``list.limit(n)``
-| Returns only the first `n` items of the list
-
 | ``list.randomise``
 | Returns the list in random order
 
-| ``list.reverse``
-| Returns the list in reverse order
+| ``jsonArray.asJsonObjects``
+| Returns a list of JsonObject. All items must be JSON objects.
 
 | ``collections.collection(key)``
 | Returns the collection for the given key

roq-data/deployment/src/main/java/io/quarkiverse/roq/data/deployment/RoqDataBeanProcessor.java

@@ -34,6 +34,7 @@ FeatureBuildItem feature() {
     @BuildStep
     @Record(ExecutionTime.STATIC_INIT)
     void generateSyntheticBeans(RoqDataConfig config,
+
             BuildProducer<SyntheticBeanBuildItem> beansProducer,
             List<RoqDataJsonBuildItem> roqDataJsonBuildItems,
             List<RoqDataBeanBuildItem> dataBeanBuildItems,

roq-frontmatter/runtime/src/main/java/io/quarkiverse/roq/frontmatter/runtime/RoqTemplateExtension.java

@@ -15,6 +15,7 @@
 import io.quarkus.qute.TemplateExtension;
 import io.vertx.core.http.impl.MimeMapping;
 import io.vertx.core.json.JsonArray;
+import io.vertx.core.json.JsonObject;
 
 @TemplateExtension
 public class RoqTemplateExtension {
@@ -152,11 +153,18 @@ public static String mimeType(String fileName) {
     }
 
     /**
-     * Returns the same list with a limited number of items.<br>
-     * Example: "{list.limit(5)}" → Only the first 5 items of the list.
+     * Returns a list of JsonObject. All items must be Json objects.
      */
-    public static <T> List<T> limit(List<T> list, int limit) {
-        return list.subList(0, Math.min(limit, list.size()));
+    @SuppressWarnings({ "unchecked", "rawtypes" })
+    public static List<JsonObject> asJsonObjects(JsonArray jsonArray) {
+        return jsonArray.stream().map(item -> {
+            if (item instanceof JsonObject o) {
+                return o;
+            } else {
+                throw new RuntimeException(
+                        "asJsonObjects should only be called if all items are instance of JsonObject (not: %s)".formatted(item));
+            }
+        }).toList();
     }
 
     /**
@@ -168,15 +176,6 @@ public static <T> List<T> randomise(List<T> l) {
         return list;
     }
 
-    /**
-     * Returns a new list with the elements of the given list in reverse order.
-     */
-    public static <T> List<T> reverse(List<T> l) {
-        List<T> copy = new ArrayList<>(l);
-        Collections.reverse(copy);
-        return copy;
-    }
-
     /**
      * Returns a new list with all the documents that matches the given value for the key (in the FM data).<br>
      * Example: "{list.filter('author', 'john')}" → Only the documents where the author is john.