docground 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 docground contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,217 @@
+# docground
+
+> **Extract with sight. Prove with math.**
+
+[![CI](https://github.com/docground/docground/actions/workflows/ci.yml/badge.svg)](https://github.com/docground/docground/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/docground.svg)](https://www.npmjs.com/package/docground)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+`docground` is a TypeScript SDK that extracts structured data from documents using **multimodal vision-language models**. Define your output as a [Zod](https://zod.dev) schema, pass a PNG, JPEG or a real **PDF**, and receive typed data, per-field visual groundings, extracted tables, and optional invariant checks.
+
+---
+
+## One-line demo
+
+```ts
+import { z } from "zod";
+import { DocumentExtractor } from "docground";
+
+const Invoice = z.object({ invoiceNumber: z.string(), total: z.number() });
+const result = await new DocumentExtractor().extract("invoice.pdf", Invoice, {
+  provider: "gemini",
+  prove: true,
+  invariants: [{ id: "balance", expression: "subtotal + tax === total" }],
+});
+```
+
+You get `result.data`, `result.groundings`, `result.tables`, `result.invariants` and `result.provenance`.
+
+---
+
+## Why docground?
+
+| Capability | Classic OCR | docground |
+|---|---|---|
+| Schema-guaranteed output | ❌ | ✅ via Zod |
+| Native PDF multimodal input | ❌ | ✅ (Gemini, Anthropic) |
+| Per-field visual grounding | ❌ | ✅ `[ymin, xmin, ymax, xmax]` |
+| Multi-page table stitching | ❌ | ✅ across tiles & pages |
+| Invariant checks / auto-repair | ❌ | ✅ built-in math engine |
+| Provider switch (Gemini/OpenAI/Anthropic) | ❌ | ✅ one-line |
+
+---
+
+## Architecture
+
+```
+┌─────────────┐      ┌──────────────┐      ┌─────────────────┐
+│   Input     │      │  Document    │      │   VLM Provider  │
+│ PNG/JPG/PDF │─────▶│  Extractor   │─────▶│ Gemini / OpenAI │
+└─────────────┘      └──────┬───────┘      │    / Anthropic  │
+                            │              └────────┬────────┘
+                            │                       │
+              ┌─────────────┼─────────────┐         │
+              │             │             │         │
+              ▼             ▼             ▼         │
+       ┌──────────┐  ┌──────────┐  ┌──────────┐     │
+       │  Tiler   │  │  Cutter  │  │ Invariant│◀────┘
+       └──────────┘  │ (sharp)  │  │  Engine  │
+                     └──────────┘  └────┬─────┘
+                                        │
+                                        ▼
+                              ┌─────────────────┐
+                              │  Table Stitcher │
+                              └─────────────────┘
+```
+
+---
+
+## Installation
+
+```bash
+npm install docground
+# or
+yarn add docground
+# or
+pnpm add docground
+```
+
+---
+
+## Quick start
+
+```ts
+import { z } from "zod";
+import { DocumentExtractor } from "docground";
+
+const LabReport = z.object({
+  patientName: z.string(),
+  biomarkers: z.array(
+    z.object({ marker: z.string(), value: z.number(), unit: z.string() })
+  ),
+});
+
+const result = await new DocumentExtractor().extract(
+  "lab-report.pdf",
+  LabReport,
+  { provider: "gemini" }
+);
+
+console.log(result.data);
+console.log(result.groundings);
+```
+
+---
+
+## Public API Reference
+
+### `new DocumentExtractor(config?)`
+
+Creates an extractor with an optional default provider.
+
+```ts
+new DocumentExtractor({
+  provider: "gemini",
+  apiKey: process.env.GEMINI_API_KEY,
+  model: "gemini-3.1-flash-lite",
+});
+```
+
+### `extract(input, schema, options?)`
+
+Extracts structured data from a file path, `Buffer`, `Uint8Array` or data URI.
+
+| Option | Description |
+|---|---|
+| `provider` | `gemini`, `openai`, `anthropic` or `custom` |
+| `model` | Model ID; falls back to provider default |
+| `apiKey` | API key override |
+| `prove` | Enable invariant checks |
+| `invariants` | Array of `{ id, expression, tolerance? }` checks |
+| `autoRepair` | Re-run extraction when invariants fail |
+| `tiling` | `auto`, `off`, or explicit `TileOptions` |
+| `prompt` | Extra instructions for the model |
+| `maxTokens` | Max output tokens |
+| `temperature` | Sampling temperature |
+| `seed` | Deterministic seed |
+| `onProgress` | Progress callback `(p) => void` |
+
+### `ExtractionResult<T>`
+
+| Field | Description |
+|---|---|
+| `data: T` | Typed payload (parsed with your Zod schema) |
+| `confidence: number` | Global confidence in `[0, 1]` |
+| `fields` | Per-field value + confidence + bbox |
+| `tables` | Extracted and stitched tables |
+| `groundings` | Visual grounding records |
+| `invariants` | Invariant report when `prove: true` |
+| `provenance` | Provider, model, duration, tiles used, repairs |
+
+### Invariants
+
+Use plain JavaScript expressions with comparisons or aggregates:
+
+```ts
+invariants: [
+  { id: "balance", expression: "subtotal + tax === total" },
+  { id: "items_sum", expression: "sum(items.lineTotal) === subtotal" },
+  { id: "vat_positive", expression: "tax > 0" },
+];
+```
+
+---
+
+## Supported providers & formats
+
+| Provider | Images | PDFs | Notes |
+|---|---|---|---|
+| Gemini | ✅ | ✅ Native | Send `application/pdf` inline |
+| Anthropic | ✅ | ✅ Native | Document block with `application/pdf` |
+| OpenAI | ✅ | ❌ | Convert PDF to images before sending |
+| Custom | ✅ | ✅ | Implement `VLMProvider` interface |
+
+---
+
+## Environment variables
+
+Create a `.env` file from `.env.example`:
+
+```bash
+GEMINI_API_KEY=...
+OPENAI_API_KEY=...
+ANTHROPIC_API_KEY=...
+
+# Optional model overrides
+GEMINI_MODEL=gemini-3.1-flash-lite
+OPENAI_MODEL=gpt-5.6-luna
+ANTHROPIC_MODEL=claude-opus-5
+```
+
+---
+
+## Examples
+
+```bash
+npx tsx examples/01_invoice_with_grounding.ts
+npx tsx examples/02_clinical_lab_report.ts
+npx tsx examples/03_legal_pdf_extraction.ts
+```
+
+---
+
+## Development
+
+```bash
+npm install
+npm run generate:fixtures
+npm run typecheck
+npm run test
+npm run build
+```
+
+---
+
+## License
+
+MIT © DocGround

package/dist/src/compiler/zod-compiler.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+/**
+ * Generic OpenAPI 3.0.3 / JSON Schema object.
+ */
+export type JsonSchema = Record<string, unknown>;
+/**
+ * Gemini's `responseSchema` accepts an OpenAPI 3.0.3 compatible JSON Schema.
+ * @deprecated alias for JsonSchema; kept for backwards compatibility.
+ */
+export type GeminiResponseSchema = JsonSchema;
+/**
+ * Compile a Zod schema to a generic OpenAPI/JSON Schema compatible with
+ * OpenAI, Anthropic and the Gemini REST API.
+ */
+export declare function compileZodToJsonSchema(schema: z.ZodType<any>): JsonSchema;
+/**
+ * Compile an arbitrary Zod schema into a Gemini-compatible `responseSchema`.
+ * Supports primitives, arrays, nested objects, optionals and enums.
+ *
+ * @param schema - A Zod schema describing the desired response shape.
+ * @returns A JSON Schema object ready to be passed to Gemini's responseSchema.
+ */
+export declare function compileZodToGeminiSchema(schema: z.ZodType<any>): JsonSchema;
+/**
+ * Convert a generic JSON Schema into the native `@google/genai` `Schema` object.
+ * This maps lowercase JSON Schema types to the SDK's `Type` enum values, strips
+ * unsupported fields such as `additionalProperties`, and folds `null` branches
+ * into `nullable`.
+ */
+export declare function toGeminiSDKSchema(schema: JsonSchema): Record<string, unknown>;
+//# sourceMappingURL=zod-compiler.d.ts.map

package/dist/src/compiler/zod-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-compiler.d.ts","sourceRoot":"","sources":["../../../src/compiler/zod-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAS9C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAMzE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAE3E;AA2CD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsF7E"}

package/dist/src/compiler/zod-compiler.js

@@ -0,0 +1,150 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+function cleanJsonSchema(schema) {
+    // Remove unsupported keys for strict provider subsets.
+    delete schema.$schema;
+    delete schema.$id;
+    return schema;
+}
+/**
+ * Compile a Zod schema to a generic OpenAPI/JSON Schema compatible with
+ * OpenAI, Anthropic and the Gemini REST API.
+ */
+export function compileZodToJsonSchema(schema) {
+    const jsonSchema = zodToJsonSchema(schema, {
+        target: "openApi3",
+        $refStrategy: "none",
+    });
+    return cleanJsonSchema(jsonSchema);
+}
+/**
+ * Compile an arbitrary Zod schema into a Gemini-compatible `responseSchema`.
+ * Supports primitives, arrays, nested objects, optionals and enums.
+ *
+ * @param schema - A Zod schema describing the desired response shape.
+ * @returns A JSON Schema object ready to be passed to Gemini's responseSchema.
+ */
+export function compileZodToGeminiSchema(schema) {
+    return compileZodToJsonSchema(schema);
+}
+const geminiTypeMap = {
+    string: "STRING",
+    number: "NUMBER",
+    integer: "INTEGER",
+    boolean: "BOOLEAN",
+    array: "ARRAY",
+    object: "OBJECT",
+};
+function isSchemaObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNullSchema(value) {
+    if (!isSchemaObject(value))
+        return false;
+    if (value.type === "null")
+        return true;
+    if (Array.isArray(value.type) && value.type.length === 1 && value.type[0] === "null") {
+        return true;
+    }
+    return false;
+}
+function mapType(typeValue) {
+    if (typeof typeValue === "string") {
+        if (typeValue === "null")
+            return {};
+        return { type: geminiTypeMap[typeValue] ?? typeValue.toUpperCase() };
+    }
+    if (Array.isArray(typeValue)) {
+        const nonNull = typeValue.filter((t) => t !== "null");
+        const result = {};
+        if (nonNull.length > 0) {
+            result.type = geminiTypeMap[nonNull[0]] ?? nonNull[0].toUpperCase();
+        }
+        if (typeValue.includes("null")) {
+            result.nullable = true;
+        }
+        return result;
+    }
+    return { type: typeValue };
+}
+/**
+ * Convert a generic JSON Schema into the native `@google/genai` `Schema` object.
+ * This maps lowercase JSON Schema types to the SDK's `Type` enum values, strips
+ * unsupported fields such as `additionalProperties`, and folds `null` branches
+ * into `nullable`.
+ */
+export function toGeminiSDKSchema(schema) {
+    if (!isSchemaObject(schema)) {
+        return {};
+    }
+    // Resolve root $ref from definitions if present.
+    if (typeof schema.$ref === "string" &&
+        isSchemaObject(schema.definitions)) {
+        const ref = schema.$ref.replace(/^#\//, "").replace(/^definitions\//, "");
+        const definitions = schema.definitions;
+        if (definitions && ref in definitions) {
+            return toGeminiSDKSchema(definitions[ref]);
+        }
+    }
+    // Fold anyOf [A, null] into A with nullable: true.
+    if (Array.isArray(schema.anyOf)) {
+        const hasNull = schema.anyOf.some(isNullSchema);
+        const nonNull = schema.anyOf.filter((s) => !isNullSchema(s));
+        if (nonNull.length === 1) {
+            const folded = toGeminiSDKSchema(nonNull[0]);
+            if (hasNull) {
+                folded.nullable = true;
+            }
+            return folded;
+        }
+        if (nonNull.length > 1) {
+            const out = {
+                anyOf: nonNull.map((s) => toGeminiSDKSchema(s)),
+            };
+            if (hasNull) {
+                out.nullable = true;
+            }
+            return out;
+        }
+        if (hasNull) {
+            return { nullable: true };
+        }
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(schema)) {
+        if (key === "$schema" || key === "$id" || key === "$ref" || key === "additionalProperties") {
+            continue;
+        }
+        if (key === "type") {
+            const { type, nullable } = mapType(value);
+            if (type)
+                out.type = type;
+            if (nullable)
+                out.nullable = true;
+            continue;
+        }
+        if (key === "properties" && isSchemaObject(value)) {
+            const mapped = {};
+            for (const [k, v] of Object.entries(value)) {
+                mapped[k] = toGeminiSDKSchema(v);
+            }
+            out.properties = mapped;
+            continue;
+        }
+        if (key === "items" && isSchemaObject(value)) {
+            out.items = toGeminiSDKSchema(value);
+            continue;
+        }
+        if (key === "enum" && Array.isArray(value)) {
+            out.enum = value.map((v) => (v === null ? "null" : typeof v === "object" ? JSON.stringify(v) : String(v)));
+            continue;
+        }
+        if (isSchemaObject(value)) {
+            out[key] = toGeminiSDKSchema(value);
+        }
+        else {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=zod-compiler.js.map

package/dist/src/compiler/zod-compiler.js.map

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

package/dist/src/core/extractor.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { type ProviderFactoryConfig } from "../providers/factory.js";
+import { type ExtractionOptions, type ExtractionResult } from "./types.js";
+export interface ExtractorConfig extends ProviderFactoryConfig {
+}
+export declare class DocumentExtractor {
+    private baseConfig;
+    constructor(config?: ExtractorConfig);
+    private resolveProvider;
+    private ingestPage;
+    private getTileOptions;
+    private prepareTiles;
+    private runInvariants;
+    private callProvider;
+    extract<T>(input: Buffer | Uint8Array | string, schema: z.ZodType<T>, options?: ExtractionOptions): Promise<ExtractionResult<T>>;
+}
+//# sourceMappingURL=extractor.d.ts.map

package/dist/src/core/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/core/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmB,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGtF,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAKtB,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,eAAgB,SAAQ,qBAAqB;CAAG;AAyIjE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAkB;gBAExB,MAAM,GAAE,eAAoB;IAIxC,OAAO,CAAC,eAAe;YAWT,UAAU;IAqBxB,OAAO,CAAC,cAAc;YAQR,YAAY;IAoB1B,OAAO,CAAC,aAAa;YAcP,YAAY;IAmBpB,OAAO,CAAC,CAAC,EACb,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,EACnC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAkEhC"}