Nomad changes

packages/java/dev/kreuzberg/DocumentNode.java

@@ -0,0 +1,179 @@
+// This file is auto-generated by alef — DO NOT EDIT.
+// alef:hash:4e15143f4af1ae8bafbdb1506ef057da924484c66a19483966333558ad437e75
+// To regenerate: alef generate
+// To verify freshness: alef verify --exit-code
+// Issues & docs: https://github.com/kreuzberg-dev/alef
+package dev.kreuzberg;
+
+import java.util.List;
+import java.util.Map;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import com.fasterxml.jackson.databind.annotation.JsonPOJOBuilder;
+import org.jspecify.annotations.Nullable;
+
+/**
+ * A single node in the document tree.
+ *
+ * Each node has deterministic {@code id}, typed {@code content}, optional {@code parent}/{@code children}
+ * for tree structure, and metadata like page number, bounding box, and content layer.
+ */
+@JsonInclude(JsonInclude.Include.NON_ABSENT)
+@JsonDeserialize(builder = DocumentNode.Builder.class)
+public record DocumentNode(
+    /**
+     * Deterministic identifier (hash of content + position).
+     */
+    @JsonProperty("id") String id,
+    /**
+     * Node content — tagged enum, type-specific data only.
+     */
+    @JsonProperty("content") NodeContent content,
+    /**
+     * Parent node index ({@code None} = root-level node).
+     */
+    @Nullable @JsonProperty("parent") Integer parent,
+    /**
+     * Child node indices in reading order.
+     */
+    @Nullable @JsonProperty("children") List<Integer> children,
+    /**
+     * Content layer classification.
+     */
+    @Nullable @JsonProperty("content_layer") ContentLayer contentLayer,
+    /**
+     * Page number where this node starts (1-indexed).
+     */
+    @Nullable @JsonProperty("page") Integer page,
+    /**
+     * Page number where this node ends (for multi-page tables/sections).
+     */
+    @Nullable @JsonProperty("page_end") Integer pageEnd,
+    /**
+     * Bounding box in document coordinates.
+     */
+    @Nullable @JsonProperty("bbox") BoundingBox bbox,
+    /**
+     * Inline annotations (formatting, links) on this node's text content.
+     *
+     * Only meaningful for text-carrying nodes; empty for containers.
+     */
+    @Nullable @JsonProperty("annotations") List<TextAnnotation> annotations,
+    /**
+     * Format-specific key-value attributes.
+     *
+     * Extensible bag for miscellaneous data without a dedicated typed field: CSS classes,
+     * LaTeX environment names, Excel cell formulas, slide layout names, etc.
+     */
+    @Nullable @JsonProperty("attributes") Map<String, String> attributes
+) {
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    // CPD-OFF
+    @JsonPOJOBuilder(withPrefix = "with", buildMethodName = "build")
+    public static final class Builder {
+
+private String id = "";
+private NodeContent content = null;
+private Integer parent = null;
+private List<Integer> children = null;
+        @JsonProperty("content_layer")
+        @Nullable private ContentLayer contentLayer = ContentLayer.Body;
+private Integer page = null;
+        @JsonProperty("page_end")
+private Integer pageEnd = null;
+private BoundingBox bbox = null;
+private List<TextAnnotation> annotations = null;
+private Map<String, String> attributes = null;
+
+        /** Sets the id field. */
+        @JsonProperty("id")
+        public Builder withId(final String value) {
+            this.id = value;
+            return this;
+        }
+
+        /** Sets the content field. */
+        @JsonProperty("content")
+        public Builder withContent(final NodeContent value) {
+            this.content = value;
+            return this;
+        }
+
+        /** Sets the parent field. */
+        @JsonProperty("parent")
+        public Builder withParent(final @Nullable int value) {
+            this.parent = value;
+            return this;
+        }
+
+        /** Sets the children field. */
+        @JsonProperty("children")
+        public Builder withChildren(final @Nullable List<Integer> value) {
+            this.children = value;
+            return this;
+        }
+
+        /** Sets the contentLayer field. */
+        @JsonProperty("content_layer")
+        public Builder withContentLayer(final @Nullable ContentLayer value) {
+            this.contentLayer = value;
+            return this;
+        }
+
+        /** Sets the page field. */
+        @JsonProperty("page")
+        public Builder withPage(final @Nullable int value) {
+            this.page = value;
+            return this;
+        }
+
+        /** Sets the pageEnd field. */
+        @JsonProperty("page_end")
+        public Builder withPageEnd(final @Nullable int value) {
+            this.pageEnd = value;
+            return this;
+        }
+
+        /** Sets the bbox field. */
+        @JsonProperty("bbox")
+        public Builder withBbox(final @Nullable BoundingBox value) {
+            this.bbox = value;
+            return this;
+        }
+
+        /** Sets the annotations field. */
+        @JsonProperty("annotations")
+        public Builder withAnnotations(final @Nullable List<TextAnnotation> value) {
+            this.annotations = value;
+            return this;
+        }
+
+        /** Sets the attributes field. */
+        @JsonProperty("attributes")
+        public Builder withAttributes(final @Nullable Map<String, String> value) {
+            this.attributes = value;
+            return this;
+        }
+
+        /** Builds the DocumentNode instance. */
+        public DocumentNode build() {
+            return new DocumentNode(
+                id,
+                content,
+                parent,
+                children,
+                contentLayer,
+                page,
+                pageEnd,
+                bbox,
+                annotations,
+                attributes
+            );
+        }
+    }
+    // CPD-ON
+}