docground 0.1.0

package/dist/tests/normalizer.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from "vitest";
+import { parseAccountingNumber } from "../src/normalizers/currency.js";
+import { parseISODate } from "../src/normalizers/tabular.js";
+describe("parseAccountingNumber", () => {
+    it("parses US formatted currency", () => {
+        expect(parseAccountingNumber("$1,250.50")).toBe(1250.5);
+        expect(parseAccountingNumber("1,250.50")).toBe(1250.5);
+    });
+    it("parses European formatted currency", () => {
+        expect(parseAccountingNumber("1.250,50 €")).toBe(1250.5);
+        expect(parseAccountingNumber("1.250,50")).toBe(1250.5);
+        expect(parseAccountingNumber("1,50")).toBe(1.5);
+    });
+    it("parses plain integers and floats", () => {
+        expect(parseAccountingNumber("1250")).toBe(1250);
+        expect(parseAccountingNumber("1250.50")).toBe(1250.5);
+        expect(parseAccountingNumber(1250.5)).toBe(1250.5);
+    });
+    it("strips currency symbols and whitespace", () => {
+        expect(parseAccountingNumber("  $ 1,250.50  ")).toBe(1250.5);
+        expect(parseAccountingNumber("€1.250,50")).toBe(1250.5);
+        expect(parseAccountingNumber("£ 1,000.00")).toBe(1000);
+    });
+    it("handles accounting negative numbers in parentheses", () => {
+        expect(parseAccountingNumber("(450.00)")).toBe(-450);
+        expect(parseAccountingNumber("(450,50)")).toBe(-450.5);
+    });
+    it("handles explicit negative signs", () => {
+        expect(parseAccountingNumber("-1,250.50")).toBe(-1250.5);
+        expect(parseAccountingNumber("1,250.50-")).toBe(-1250.5);
+    });
+    it("returns null for non-numeric values", () => {
+        expect(parseAccountingNumber("abc")).toBeNull();
+        expect(parseAccountingNumber("")).toBeNull();
+        expect(parseAccountingNumber(NaN)).toBeNull();
+    });
+});
+describe("parseISODate", () => {
+    it("keeps already ISO dates", () => {
+        expect(parseISODate("2024-03-15")).toBe("2024-03-15");
+    });
+    it("parses year-first dates", () => {
+        expect(parseISODate("2024/03/15")).toBe("2024-03-15");
+        expect(parseISODate("2024.03.15")).toBe("2024-03-15");
+    });
+    it("parses international DD/MM/YYYY dates", () => {
+        expect(parseISODate("15/03/2024")).toBe("2024-03-15");
+        expect(parseISODate("15-03-2024")).toBe("2024-03-15");
+        expect(parseISODate("15.03.2024")).toBe("2024-03-15");
+    });
+    it("parses US MM/DD/YYYY dates", () => {
+        expect(parseISODate("03/15/2024", "us")).toBe("2024-03-15");
+    });
+    it("resolves ambiguous dates with the default international locale", () => {
+        // 05/03/2024 is ambiguous; international means DD/MM.
+        expect(parseISODate("05/03/2024")).toBe("2024-03-05");
+        // With US locale it should be interpreted as MM/DD.
+        expect(parseISODate("05/03/2024", "us")).toBe("2024-05-03");
+    });
+    it("disambiguates by out-of-range values", () => {
+        expect(parseISODate("25/03/2024")).toBe("2024-03-25");
+        expect(parseISODate("03/25/2024")).toBe("2024-03-25");
+    });
+    it("returns null for invalid dates", () => {
+        expect(parseISODate("2024-13-15")).toBeNull();
+        expect(parseISODate("not a date")).toBeNull();
+        expect(parseISODate("")).toBeNull();
+    });
+});
+//# sourceMappingURL=normalizer.test.js.map

package/dist/tests/normalizer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.test.js","sourceRoot":"","sources":["../../tests/normalizer.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/providers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=providers.test.d.ts.map

package/dist/tests/providers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.test.d.ts","sourceRoot":"","sources":["../../tests/providers.test.ts"],"names":[],"mappings":""}

package/dist/tests/providers.test.js

@@ -0,0 +1,110 @@
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { GeminiProvider } from "../src/providers/gemini-provider.js";
+import { OpenAIProvider } from "../src/providers/openai-provider.js";
+import { AnthropicProvider } from "../src/providers/anthropic-provider.js";
+import { resolveProvider } from "../src/providers/factory.js";
+const expectedSchema = {
+    type: "object",
+    properties: {
+        invoiceNumber: { type: "string" },
+        total: { type: "number" },
+    },
+    required: ["invoiceNumber", "total"],
+};
+function firstCall(spy) {
+    const call = spy.mock.calls[0];
+    return (call[0] ?? {});
+}
+describe("providers", () => {
+    describe("GeminiProvider", () => {
+        it("sends the correct responseMimeType and native schema", async () => {
+            const provider = new GeminiProvider({ apiKey: "test", model: "gemini-2.5-flash" });
+            const client = provider.client;
+            const spy = vi.spyOn(client.models, "generateContent").mockResolvedValue({
+                text: JSON.stringify({ invoiceNumber: "001", total: 100 }),
+            });
+            await provider.extract({
+                images: [{ mimeType: "image/png", base64: "iVBORw0KGgo=", width: 100, height: 100 }],
+                prompt: "Extract",
+                schema: expectedSchema,
+                responseMimeType: "application/json",
+            });
+            const params = firstCall(spy);
+            expect(params.model).toBe("gemini-2.5-flash");
+            const config = params.config ?? {};
+            expect(config.responseMimeType).toBe("application/json");
+            const schema = config.responseSchema ?? {};
+            expect(schema.type).toBe("OBJECT");
+            expect(schema.properties).toBeDefined();
+        });
+    });
+    describe("OpenAIProvider", () => {
+        it("sends strict json_schema response_format with image_url content", async () => {
+            const provider = new OpenAIProvider({ apiKey: "test", model: "gpt-4o" });
+            const client = provider.client;
+            const spy = vi.spyOn(client.chat.completions, "create").mockResolvedValue({
+                choices: [{ message: { content: JSON.stringify({ invoiceNumber: "002", total: 200 }) } }],
+            });
+            await provider.extract({
+                images: [{ mimeType: "image/png", base64: "iVBORw0KGgo=", width: 100, height: 100 }],
+                prompt: "Extract",
+                schema: expectedSchema,
+            });
+            const body = firstCall(spy);
+            const responseFormat = body.response_format ?? {};
+            expect(responseFormat.type).toBe("json_schema");
+            const messages = body.messages ?? [];
+            const content = messages[0]?.content;
+            const imagePart = content?.find((c) => c.type === "image_url");
+            expect(imagePart?.image_url?.url).toMatch(/^data:image\/png;base64,/);
+        });
+    });
+    describe("AnthropicProvider", () => {
+        it("sends a single extract_document tool with the schema as input_schema", async () => {
+            const provider = new AnthropicProvider({ apiKey: "test", model: "claude-sonnet-4-20250514" });
+            const client = provider.client;
+            const spy = vi.spyOn(client.messages, "create").mockResolvedValue({
+                content: [
+                    {
+                        type: "tool_use",
+                        id: "tu_1",
+                        name: "extract_document",
+                        input: { invoiceNumber: "003", total: 300 },
+                    },
+                ],
+            });
+            await provider.extract({
+                images: [{ mimeType: "image/png", base64: "iVBORw0KGgo=", width: 100, height: 100 }],
+                prompt: "Extract",
+                schema: expectedSchema,
+            });
+            const body = firstCall(spy);
+            expect(body.tool_choice).toEqual({ type: "tool", name: "extract_document" });
+            const tools = body.tools ?? [];
+            expect(tools).toHaveLength(1);
+            expect(tools[0].name).toBe("extract_document");
+            expect(tools[0].input_schema).toEqual(expectedSchema);
+        });
+    });
+    describe("factory", () => {
+        const OLD_ENV = process.env;
+        beforeEach(() => {
+            vi.resetModules();
+            process.env = { ...OLD_ENV };
+            delete process.env.GEMINI_API_KEY;
+            delete process.env.OPENAI_API_KEY;
+            delete process.env.ANTHROPIC_API_KEY;
+        });
+        it("selects the provider based on env variables", () => {
+            process.env.OPENAI_API_KEY = "sk-test";
+            const provider = resolveProvider();
+            expect(provider.name).toBe("openai");
+        });
+        it("uses an explicit custom provider", () => {
+            const custom = { name: "custom", extract: vi.fn() };
+            const provider = resolveProvider({ customVLM: custom });
+            expect(provider.name).toBe("custom");
+        });
+    });
+});
+//# sourceMappingURL=providers.test.js.map

package/dist/tests/providers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.test.js","sourceRoot":"","sources":["../../tests/providers.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/stitcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stitcher.test.d.ts.map

package/dist/tests/stitcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitcher.test.d.ts","sourceRoot":"","sources":["../../tests/stitcher.test.ts"],"names":[],"mappings":""}

package/dist/tests/stitcher.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect } from "vitest";
+import { TableStitcher } from "../src/stitcher/table-stitcher.js";
+describe("TableStitcher", () => {
+    it("merges tables that continue across pages", () => {
+        const t1 = {
+            pageIndex: 1,
+            header: ["Item", "Qty", "Price"],
+            rows: [
+                ["A", 1, 100],
+                ["B", 2, 200],
+            ],
+            bbox: [0.1, 0.1, 0.5, 0.9],
+        };
+        const t2 = {
+            pageIndex: 2,
+            header: ["Item", "Qty", "Price"],
+            rows: [
+                ["Item", "Qty", "Price"], // repeated header
+                ["C", 1, 150],
+                ["D", 3, 300],
+            ],
+            bbox: [0.1, 0.1, 0.5, 0.9],
+        };
+        const stitcher = new TableStitcher();
+        const merged = stitcher.stitch([t1, t2]);
+        expect(merged).toHaveLength(1);
+        expect(merged[0].rows).toHaveLength(4);
+        expect(merged[0].header).toEqual(["Item", "Qty", "Price"]);
+        expect(merged[0].rows[2]).toEqual(["C", 1, 150]);
+    });
+    it("does not merge tables with different column counts", () => {
+        const t1 = {
+            pageIndex: 1,
+            header: ["A", "B"],
+            rows: [[1, 2]],
+            bbox: [0, 0, 0.5, 1],
+        };
+        const t2 = {
+            pageIndex: 2,
+            header: ["A", "B", "C"],
+            rows: [[3, 4, 5]],
+            bbox: [0, 0, 0.5, 1],
+        };
+        const stitcher = new TableStitcher();
+        const merged = stitcher.stitch([t1, t2]);
+        expect(merged).toHaveLength(2);
+    });
+    it("does not merge tables with low horizontal overlap", () => {
+        const t1 = {
+            pageIndex: 1,
+            header: ["A", "B"],
+            rows: [[1, 2]],
+            bbox: [0, 0, 0.5, 0.4],
+        };
+        const t2 = {
+            pageIndex: 2,
+            header: ["A", "B"],
+            rows: [[3, 4]],
+            bbox: [0.6, 0, 0.5, 1],
+        };
+        const stitcher = new TableStitcher();
+        const merged = stitcher.stitch([t1, t2]);
+        expect(merged).toHaveLength(2);
+    });
+    it("preserves rowspan/colspan metadata when present", () => {
+        const t1 = {
+            pageIndex: 1,
+            header: ["A", "B"],
+            rows: [[1, 2]],
+            bbox: [0, 0, 0.5, 1],
+            spans: [[{ rowspan: 2 }, undefined]],
+        };
+        const t2 = {
+            pageIndex: 2,
+            header: ["A", "B"],
+            rows: [[3, 4]],
+            bbox: [0, 0, 0.5, 1],
+            spans: [[undefined, { colspan: 2 }]],
+        };
+        const stitcher = new TableStitcher();
+        const merged = stitcher.stitch([t1, t2]);
+        expect(merged[0].spans).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=stitcher.test.js.map

package/dist/tests/stitcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitcher.test.js","sourceRoot":"","sources":["../../tests/stitcher.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/tiling.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tiling.test.d.ts.map

package/dist/tests/tiling.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiling.test.d.ts","sourceRoot":"","sources":["../../tests/tiling.test.ts"],"names":[],"mappings":""}

package/dist/tests/tiling.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, beforeAll } from "vitest";
+import { planTiling, remapTileBoxes } from "../src/tiling/tiler.js";
+import { cropTile, getImageMetadata } from "../src/tiling/cutter.js";
+import { createBlankImage } from "./fixtures.js";
+describe("tiling", () => {
+    let largeImage;
+    beforeAll(async () => {
+        largeImage = await createBlankImage(2000, 2000);
+    });
+    describe("planTiling", () => {
+        it("returns a single tile when the page fits within limits", () => {
+            const plan = planTiling(0, { width: 800, height: 600 }, { maxTileWidth: 1024, maxTileHeight: 1024, overlap: 0.15 });
+            expect(plan.tiles).toHaveLength(1);
+            expect(plan.tiles[0].bbox).toEqual([0, 0, 1, 1]);
+        });
+        it("produces a grid with overlap when the page exceeds tile limits", () => {
+            const plan = planTiling(0, { width: 2000, height: 2000 }, {
+                maxTileWidth: 1024,
+                maxTileHeight: 1024,
+                overlap: 0.2,
+            });
+            expect(plan.tiles.length).toBeGreaterThan(1);
+            expect(plan.tiles.every((t) => t.bbox[0] >= 0 && t.bbox[3] <= 1)).toBe(true);
+        });
+        it("tiles overlap by the configured ratio", () => {
+            const plan = planTiling(0, { width: 2000, height: 1000 }, {
+                maxTileWidth: 1200,
+                maxTileHeight: 1200,
+                overlap: 0.25,
+            });
+            expect(plan.tiles.length).toBeGreaterThanOrEqual(2);
+            const first = plan.tiles[0];
+            const second = plan.tiles.find((t) => t.col === 1 && t.row === 0);
+            expect(second).toBeDefined();
+            // The second tile should start before the first tile ends.
+            expect(second.bbox[1]).toBeLessThan(first.bbox[3]);
+        });
+    });
+    describe("remapTileBoxes", () => {
+        it("remaps local bboxes back to page-normalized space", () => {
+            const tile = {
+                pageIndex: 0,
+                bbox: [0.1, 0.1, 0.6, 0.6],
+                localBox: [0, 0, 1, 1],
+                row: 0,
+                col: 0,
+                rows: 1,
+                cols: 1,
+            };
+            const localBoxes = [
+                [0, 0, 0.5, 0.5],
+            ];
+            const remapped = remapTileBoxes(localBoxes, tile);
+            expect(remapped[0]).toEqual([
+                0.1,
+                0.1,
+                0.35,
+                0.35,
+            ]);
+        });
+    });
+    describe("cropTile", () => {
+        it("crops a tile from the full image with correct dimensions", async () => {
+            const metadata = await getImageMetadata(largeImage);
+            expect(metadata.width).toBe(2000);
+            expect(metadata.height).toBe(2000);
+            const plan = planTiling(0, { width: 2000, height: 2000 }, {
+                maxTileWidth: 1024,
+                maxTileHeight: 1024,
+                overlap: 0.2,
+            });
+            const firstTile = plan.tiles[0];
+            const cropped = await cropTile({
+                mimeType: largeImage.mimeType,
+                base64: largeImage.base64,
+                width: 2000,
+                height: 2000,
+            }, firstTile);
+            expect(cropped.width).toBeLessThanOrEqual(1024);
+            expect(cropped.height).toBeLessThanOrEqual(1024);
+            expect(cropped.base64).toBeTruthy();
+        });
+    });
+});
+//# sourceMappingURL=tiling.test.js.map

package/dist/tests/tiling.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiling.test.js","sourceRoot":"","sources":["../../tests/tiling.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/validators.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validators.test.d.ts.map

package/dist/tests/validators.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.test.d.ts","sourceRoot":"","sources":["../../tests/validators.test.ts"],"names":[],"mappings":""}

package/dist/tests/validators.test.js

@@ -0,0 +1,125 @@
+import { describe, it, expect } from "vitest";
+import { InvariantEngine } from "../src/validators/invariants.js";
+describe("InvariantEngine", () => {
+    it("passes a simple balance check", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({ id: "balance", expression: "subtotal + tax === total" });
+        const report = engine.check({
+            subtotal: 1000,
+            tax: 210,
+            total: 1210,
+        });
+        expect(report.ok).toBe(true);
+        expect(report.checks[0].passed).toBe(true);
+        expect(report.confidenceScore).toBe(1);
+        expect(report.discrepancies).toHaveLength(0);
+    });
+    it("flags an incorrect balance with exact diff", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({ id: "balance", expression: "subtotal + tax === total" });
+        const report = engine.check({
+            subtotal: 1000,
+            tax: 210,
+            total: 1200,
+        });
+        expect(report.ok).toBe(false);
+        expect(report.checks[0].passed).toBe(false);
+        expect(report.checks[0].diff).toBeCloseTo(10);
+        expect(report.discrepancies[0]).toEqual({
+            id: "balance",
+            actual: 1210,
+            expected: 1200,
+            diff: 10,
+        });
+        expect(report.confidenceScore).toBeLessThan(1);
+    });
+    it("validates sum of table items", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({
+            id: "items-total",
+            expression: "sum(items.amount) === total",
+        });
+        const report = engine.check({
+            items: [{ amount: 100 }, { amount: 250 }, { amount: 50 }],
+            total: 400,
+        });
+        expect(report.ok).toBe(true);
+        expect(report.checks[0].passed).toBe(true);
+    });
+    it("flags a mismatch between sum of items and total", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({
+            id: "items-total",
+            expression: "sum(items.amount) === total",
+        });
+        const report = engine.check({
+            items: [{ amount: 100 }, { amount: 250 }, { amount: 50 }],
+            total: 350,
+        });
+        expect(report.ok).toBe(false);
+        expect(report.checks[0].passed).toBe(false);
+        expect(report.checks[0].actual).toBe(400);
+        expect(report.checks[0].expected).toBe(350);
+        expect(report.checks[0].diff).toBe(50);
+    });
+    it("computes a confidence score with multiple checks", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({ id: "a", expression: "x === y" });
+        engine.addCheck({ id: "b", expression: "total >= 0" });
+        const report = engine.check({
+            x: 10,
+            y: 10,
+            total: 100,
+        });
+        expect(report.ok).toBe(true);
+        expect(report.confidenceScore).toBe(1);
+    });
+    it("computes a lower confidence score when some checks fail", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({ id: "a", expression: "x === y" });
+        engine.addCheck({ id: "b", expression: "total === 0" });
+        const report = engine.check({
+            x: 10,
+            y: 9,
+            total: 100,
+        });
+        expect(report.ok).toBe(false);
+        expect(report.confidenceScore).toBeGreaterThanOrEqual(0);
+        expect(report.confidenceScore).toBeLessThan(1);
+        expect(report.checks).toHaveLength(2);
+        expect(report.checks[0].passed).toBe(false);
+        expect(report.checks[1].passed).toBe(false);
+    });
+    it("supports count and avg aggregations", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({
+            id: "avg-equals",
+            expression: "avg(items.score) === 50",
+        });
+        engine.addCheck({
+            id: "count-equals",
+            expression: "count(items) === 3",
+        });
+        const report = engine.check({
+            items: [{ score: 40 }, { score: 50 }, { score: 60 }],
+        });
+        expect(report.ok).toBe(true);
+        expect(report.checks[0].passed).toBe(true);
+        expect(report.checks[1].passed).toBe(true);
+    });
+    it("respects a custom numeric tolerance", () => {
+        const engine = new InvariantEngine();
+        engine.addCheck({
+            id: "float-balance",
+            expression: "a + b === c",
+            tolerance: 0.001,
+        });
+        const report = engine.check({
+            a: 0.1,
+            b: 0.2,
+            c: 0.3000001,
+        });
+        expect(report.ok).toBe(true);
+    });
+});
+//# sourceMappingURL=validators.test.js.map

package/dist/tests/validators.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.test.js","sourceRoot":"","sources":["../../tests/validators.test.ts"],"names":[],"mappings":"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"}

package/dist/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAUG"}

package/dist/vitest.config.js

@@ -0,0 +1,13 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: "node",
+        include: ["tests/**/*.test.ts"],
+        coverage: {
+            reporter: ["text", "json", "html"],
+            exclude: ["node_modules/", "dist/", "vitest.config.ts"],
+        },
+    },
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,oBAAoB,CAAC;QAC/B,QAAQ,EAAE;YACR,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAClC,OAAO,EAAE,CAAC,eAAe,EAAE,OAAO,EAAE,kBAAkB,CAAC;SACxD;KACF;CACF,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "docground",
+  "version": "0.1.0",
+  "description": "Extract with sight. Prove with math.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "generate:fixtures": "tsx scripts/generate_fixtures.ts"
+  },
+  "keywords": [
+    "document-extraction",
+    "visual-grounding",
+    "zod",
+    "structured-output",
+    "multimodal",
+    "pdf",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@google/genai": "^0.14.0",
+    "openai": "^4.80.0",
+    "sharp": "^0.35.4",
+    "zod": "^3.24.0",
+    "zod-to-json-schema": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "pdf-lib": "^1.17.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}