Nomad changes

docs/snippets/zig/getting-started/basic_usage.md

@@ -0,0 +1,18 @@
+```zig title="Zig"
+const std = @import("std");
+const kreuzberg = @import("kreuzberg");
+
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    const allocator = gpa.allocator();
+    _ = allocator;
+
+    const config_json = "{}";
+    const result_json = try kreuzberg.extract_file_sync("document.pdf", null, config_json);
+    defer std.heap.c_allocator.free(result_json);
+
+    const stdout = std.io.getStdOut().writer();
+    try stdout.print("{s}\n", .{result_json});
+}
+```

docs/snippets/zig/getting-started/extract_file.md

@@ -0,0 +1,25 @@
+```zig title="Zig"
+const std = @import("std");
+const kreuzberg = @import("kreuzberg");
+
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    const allocator = gpa.allocator();
+
+    const config_json = "{}";
+    const result_json = try kreuzberg.extract_file_sync("document.pdf", null, config_json);
+    defer std.heap.c_allocator.free(result_json);
+
+    var parsed = try std.json.parseFromSlice(std.json.Value, allocator, result_json, .{});
+    defer parsed.deinit();
+
+    const root = parsed.value.object;
+    const content = root.get("content") orelse std.json.Value{ .string = "" };
+    const mime_type = root.get("mime_type") orelse std.json.Value{ .string = "" };
+
+    const stdout = std.io.getStdOut().writer();
+    try stdout.print("Content: {s}\n", .{content.string});
+    try stdout.print("MIME Type: {s}\n", .{mime_type.string});
+}
+```

docs/snippets/zig/getting-started/extract_with_ocr.md

@@ -0,0 +1,27 @@
+```zig title="Zig"
+const std = @import("std");
+const kreuzberg = @import("kreuzberg");
+
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    const allocator = gpa.allocator();
+    _ = allocator;
+
+    const config_json =
+        \\{
+        \\  "force_ocr": true,
+        \\  "ocr": {
+        \\    "backend": "tesseract",
+        \\    "language": "eng"
+        \\  }
+        \\}
+    ;
+
+    const result_json = try kreuzberg.extract_file_sync("scanned.pdf", null, config_json);
+    defer std.heap.c_allocator.free(result_json);
+
+    const stdout = std.io.getStdOut().writer();
+    try stdout.print("{s}\n", .{result_json});
+}
+```

docs/snippets/zig/getting-started/hello_world.md

@@ -0,0 +1,20 @@
+```zig title="Zig"
+const std = @import("std");
+const kreuzberg = @import("kreuzberg");
+
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    const allocator = gpa.allocator();
+    _ = allocator;
+
+    const stdout = std.io.getStdOut().writer();
+    try stdout.print("Hello from kreuzberg-zig\n", .{});
+
+    const config_json = "{}";
+    const result_json = try kreuzberg.extract_file_sync("document.pdf", null, config_json);
+    defer std.heap.c_allocator.free(result_json);
+
+    try stdout.print("{s}\n", .{result_json});
+}
+```

docs/snippets/zig/getting-started/install_verify.md

@@ -0,0 +1,19 @@
+```zig title="Zig"
+const std = @import("std");
+const kreuzberg = @import("kreuzberg");
+
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    const allocator = gpa.allocator();
+    _ = allocator;
+
+    const stdout = std.io.getStdOut().writer();
+    try stdout.print("kreuzberg module imported successfully\n", .{});
+    if (kreuzberg._last_error()) |context| {
+        try stdout.print("  last error context: {s}\n", .{context});
+    } else {
+        try stdout.print("  no prior FFI errors recorded\n", .{});
+    }
+}
+```

docs/snippets/zig/getting-started/read_content.md

@@ -0,0 +1,38 @@
+```zig title="Zig"
+const std = @import("std");
+const kreuzberg = @import("kreuzberg");
+
+pub fn main() !void {
+    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
+    defer _ = gpa.deinit();
+    const allocator = gpa.allocator();
+
+    const config_json = "{}";
+    const result_json = try kreuzberg.extract_file_sync("document.pdf", null, config_json);
+    defer std.heap.c_allocator.free(result_json);
+
+    var parsed = try std.json.parseFromSlice(std.json.Value, allocator, result_json, .{});
+    defer parsed.deinit();
+
+    const root = parsed.value.object;
+    const content = root.get("content") orelse std.json.Value{ .string = "" };
+
+    const stdout = std.io.getStdOut().writer();
+    try stdout.print("Extracted content: {s}\n", .{content.string});
+
+    if (root.get("tables")) |tables_value| {
+        const tables = tables_value.array;
+        try stdout.print("Tables found: {d}\n", .{tables.items.len});
+        for (tables.items, 0..) |table, index| {
+            const table_obj = table.object;
+            if (table_obj.get("page_number")) |page_number| {
+                try stdout.print("  table {d}: page {d}\n", .{ index, page_number.integer });
+            } else {
+                try stdout.print("  table {d}\n", .{index});
+            }
+        }
+    } else {
+        try stdout.print("Tables found: 0\n", .{});
+    }
+}
+```