docground 0.1.0

package/dist/src/core/extractor.js

@@ -0,0 +1,268 @@
+import { z } from "zod";
+import { promises as fs } from "fs";
+import { resolveProvider } from "../providers/factory.js";
+import { compileZodToJsonSchema } from "../compiler/zod-compiler.js";
+import { planTiling, needsTiling } from "../tiling/tiler.js";
+import { cropTile, getImageMetadata } from "../tiling/cutter.js";
+import { TableStitcher } from "../stitcher/table-stitcher.js";
+import { InvariantEngine } from "../validators/invariants.js";
+function toBase64String(buffer) {
+    return buffer.toString("base64");
+}
+function detectMimeType(buffer) {
+    if (buffer[0] === 0x25 && buffer[1] === 0x50 && buffer[2] === 0x44 && buffer[3] === 0x46) {
+        return "application/pdf";
+    }
+    if (buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {
+        return "image/png";
+    }
+    if (buffer[0] === 0xff && buffer[1] === 0xd8) {
+        return "image/jpeg";
+    }
+    if (buffer[0] === 0x47 && buffer[1] === 0x49 && buffer[2] === 0x46) {
+        return "image/gif";
+    }
+    if (buffer[0] === 0x52 && buffer[1] === 0x49 && buffer[2] === 0x46 && buffer[3] === 0x46) {
+        return "image/webp";
+    }
+    return "image/png";
+}
+const A4_PAGE_SIZE = { width: 595, height: 842 };
+function isDocumentImage(mimeType) {
+    return mimeType === "application/pdf";
+}
+async function readInput(input) {
+    if (typeof input === "string") {
+        const dataUri = input.match(/^data:([^;]+);base64,(.+)$/);
+        if (dataUri) {
+            return { buffer: Buffer.from(dataUri[2], "base64"), mimeType: dataUri[1] };
+        }
+        try {
+            await fs.access(input);
+            const buffer = await fs.readFile(input);
+            return { buffer, mimeType: detectMimeType(buffer) };
+        }
+        catch {
+            return { buffer: Buffer.from(input, "base64"), mimeType: "image/png" };
+        }
+    }
+    const buffer = Buffer.isBuffer(input) ? input : Buffer.from(input);
+    return { buffer, mimeType: detectMimeType(buffer) };
+}
+function wrapSchema(userSchema) {
+    const BBoxSchema = z.array(z.number()).length(4);
+    const GroundingSchema = z.object({
+        pageIndex: z.number(),
+        field: z.string(),
+        value: z.unknown(),
+        bbox: BBoxSchema,
+        confidence: z.number().optional(),
+    });
+    const CellSpanSchema = z.object({
+        rowspan: z.number().optional(),
+        colspan: z.number().optional(),
+    });
+    const TableSchema = z.object({
+        pageIndex: z.number(),
+        rows: z.array(z.array(z.unknown())),
+        header: z.array(z.string()).optional(),
+        bbox: BBoxSchema,
+        html: z.string().optional(),
+        spans: z.array(z.array(CellSpanSchema.optional()).optional()).optional(),
+    });
+    return z.object({
+        data: userSchema,
+        groundings: z.array(GroundingSchema).optional(),
+        tables: z.array(TableSchema).optional(),
+    });
+}
+function buildPrompt(schemaName = "document", options = {}) {
+    const lines = [
+        `Extract the ${schemaName} from the provided image(s).`,
+        "Return valid JSON matching the requested schema exactly.",
+        "For each extracted field, include a visual grounding with `bbox` as normalized [ymin, xmin, ymax, xmax] coordinates.",
+        "If you detect tables, include them in the `tables` array with rows, header, and bbox.",
+    ];
+    if (options.prompt) {
+        lines.push(`Additional instructions: ${options.prompt}`);
+    }
+    return lines.join("\n");
+}
+function buildRepairPrompt(basePrompt, report) {
+    return [
+        basePrompt,
+        "",
+        "The previous extraction failed the following invariant checks; please correct the output and return the full JSON again:",
+        report.checks
+            .filter((c) => !c.passed)
+            .map((c) => `- ${c.id}: ${c.message ?? `diff ${c.diff}`}`)
+            .join("\n"),
+    ].join("\n");
+}
+function collectFields(data, groundings) {
+    const fields = {};
+    function visit(value, path) {
+        if (Array.isArray(value)) {
+            value.forEach((v, i) => visit(v, path ? `${path}.${i}` : `${i}`));
+            return;
+        }
+        if (value !== null && typeof value === "object") {
+            for (const [k, v] of Object.entries(value)) {
+                visit(v, path ? `${path}.${k}` : k);
+            }
+            return;
+        }
+        const g = groundings.find((gr) => gr.field === path);
+        fields[path] = {
+            value,
+            confidence: g?.confidence ?? 1,
+            pageIndex: g?.pageIndex,
+            bbox: g?.bbox,
+        };
+    }
+    visit(data, "");
+    return fields;
+}
+function computeGlobalConfidence(invariants, groundings) {
+    const invConfidence = invariants?.confidenceScore ?? 1;
+    if (groundings.length === 0)
+        return invConfidence;
+    const groundingAvg = groundings.reduce((sum, g) => sum + (g.confidence ?? 1), 0) / groundings.length;
+    return Math.max(0, Math.min(1, invConfidence * groundingAvg));
+}
+export class DocumentExtractor {
+    baseConfig;
+    constructor(config = {}) {
+        this.baseConfig = config;
+    }
+    resolveProvider(options = {}) {
+        if (options.customVLM)
+            return options.customVLM;
+        if (this.baseConfig.customVLM)
+            return this.baseConfig.customVLM;
+        return resolveProvider({
+            provider: options.provider ?? this.baseConfig.provider,
+            apiKey: options.apiKey ?? this.baseConfig.apiKey,
+            model: options.model ?? this.baseConfig.model,
+            baseUrl: options.baseUrl ?? this.baseConfig.baseUrl,
+        });
+    }
+    async ingestPage(input) {
+        const { buffer, mimeType } = await readInput(input);
+        const base64 = toBase64String(buffer);
+        const image = { mimeType, base64, width: 0, height: 0 };
+        if (isDocumentImage(mimeType)) {
+            image.width = A4_PAGE_SIZE.width;
+            image.height = A4_PAGE_SIZE.height;
+        }
+        else {
+            const meta = await getImageMetadata(image);
+            image.width = meta.width;
+            image.height = meta.height;
+        }
+        return {
+            index: 0,
+            image,
+            size: { width: image.width, height: image.height },
+        };
+    }
+    getTileOptions(options) {
+        if (options.tiling === "off")
+            return undefined;
+        if (options.tiling === "auto" || options.tiling === undefined) {
+            return { maxTileWidth: 1536, maxTileHeight: 1536, overlap: 0.15 };
+        }
+        return options.tiling;
+    }
+    async prepareTiles(page, options) {
+        if (isDocumentImage(page.image.mimeType)) {
+            return [page.image];
+        }
+        const tileOpts = this.getTileOptions(options);
+        if (!tileOpts || !needsTiling(page.size, tileOpts)) {
+            return [page.image];
+        }
+        const plan = planTiling(page.index, page.size, tileOpts);
+        const tileImages = [];
+        for (const tile of plan.tiles) {
+            const cropped = await cropTile(page.image, tile);
+            tileImages.push(cropped);
+            options.onProgress?.({ step: "tiling", page: page.index, tile: tile.row * tile.cols + tile.col });
+        }
+        return tileImages;
+    }
+    runInvariants(data, tables, options) {
+        const engine = new InvariantEngine();
+        for (const check of options.invariants ?? []) {
+            engine.addCheck(check);
+        }
+        const context = data !== null && typeof data === "object" ? { ...data, tables } : { value: data, tables };
+        return engine.check(context);
+    }
+    async callProvider(provider, tileImages, prompt, schema, options) {
+        options.onProgress?.({ step: "vlm", page: 0 });
+        return provider.extract({
+            images: tileImages,
+            prompt,
+            schema,
+            responseMimeType: "application/json",
+            maxTokens: options.maxTokens,
+            temperature: options.temperature ?? 0,
+            seed: options.seed,
+        });
+    }
+    async extract(input, schema, options = {}) {
+        const start = Date.now();
+        const provider = this.resolveProvider(options);
+        const page = await this.ingestPage(input);
+        const tileImages = await this.prepareTiles(page, options);
+        const wrappedSchema = wrapSchema(schema);
+        const providerSchema = compileZodToJsonSchema(wrappedSchema);
+        const prompt = buildPrompt(schema.constructor.name, options);
+        let raw = await this.callProvider(provider, tileImages, prompt, providerSchema, options);
+        let parsed;
+        try {
+            parsed = JSON.parse(raw.text);
+        }
+        catch {
+            throw new Error(`Provider returned invalid JSON: ${raw.text.slice(0, 200)}`);
+        }
+        let data = wrappedSchema.shape.data.parse(parsed.data);
+        let groundings = parsed.groundings ?? [];
+        let tables = parsed.tables ?? [];
+        let invariantReport;
+        let repairs = 0;
+        if (options.prove) {
+            invariantReport = this.runInvariants(data, tables, options);
+            if (!invariantReport.ok && options.autoRepair) {
+                const repairPrompt = buildRepairPrompt(prompt, invariantReport);
+                const repairRaw = await this.callProvider(provider, tileImages, repairPrompt, providerSchema, options);
+                const repairParsed = JSON.parse(repairRaw.text);
+                data = wrappedSchema.shape.data.parse(repairParsed.data);
+                groundings = repairParsed.groundings ?? [];
+                tables = repairParsed.tables ?? [];
+                invariantReport = this.runInvariants(data, tables, options);
+                repairs = 1;
+            }
+        }
+        const stitchedTables = new TableStitcher().stitch(tables);
+        const confidence = computeGlobalConfidence(invariantReport, groundings);
+        const fields = collectFields(data, groundings);
+        return {
+            data,
+            confidence,
+            fields,
+            tables: stitchedTables,
+            groundings,
+            invariants: invariantReport,
+            provenance: {
+                provider: provider.name,
+                model: provider.model ?? "unknown",
+                durationMs: Date.now() - start,
+                tilesUsed: tileImages.length,
+                repairs,
+            },
+        };
+    }
+}
+//# sourceMappingURL=extractor.js.map

package/dist/src/core/extractor.js.map

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

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

@@ -0,0 +1,102 @@
+import type { NormalizedBBox } from "../grounding/bbox.js";
+import type { GroundedField, PageImage, VLMProvider } from "../providers/types.js";
+import type { InvariantReport } from "../validators/invariants.js";
+export interface ExtractedTable {
+    pageIndex: number;
+    rows: unknown[][];
+    header?: string[];
+    bbox: NormalizedBBox;
+    html?: string;
+    /** Optional per-cell metadata (colspan/rowspan). */
+    spans?: Array<Array<{
+        rowspan?: number;
+        colspan?: number;
+    } | undefined>>;
+}
+export interface FieldResult {
+    value: unknown;
+    confidence: number;
+    pageIndex?: number;
+    bbox?: NormalizedBBox;
+}
+export interface ExtractionProvenance {
+    provider: string;
+    model: string;
+    durationMs: number;
+    tilesUsed: number;
+    repairs: number;
+}
+export interface ExtractionResult<T> {
+    /** Typed extraction payload. */
+    data: T;
+    /** Global confidence score in [0, 1]. */
+    confidence: number;
+    /** Per-field confidence and grounding (best available). */
+    fields: Record<string, FieldResult>;
+    /** Extracted and optionally stitched tables. */
+    tables: ExtractedTable[];
+    /** Visual grounding records for all detected fields. */
+    groundings: GroundedField[];
+    /** Invariant check report when `prove: true` is used. */
+    invariants?: InvariantReport;
+    provenance: ExtractionProvenance;
+}
+export interface TileOptions {
+    /** Maximum tile width in pixels (default 1536). */
+    maxTileWidth?: number;
+    /** Maximum tile height in pixels (default 1536). */
+    maxTileHeight?: number;
+    /** Overlap ratio between tiles in [0, 1] (default 0.15). */
+    overlap?: number;
+    /** Minimum number of pixels per tile. */
+    minPixels?: number;
+    /** Maximum number of pixels per tile. */
+    maxPixels?: number;
+}
+export interface ExtractionOptions {
+    /** Provider to use; defaults to env-variable resolution. */
+    provider?: "gemini" | "openai" | "anthropic" | "custom";
+    /** Model id; falls back to provider default. */
+    model?: string;
+    /** API key or falls back to environment variables. */
+    apiKey?: string;
+    /** Base URL override for OpenAI-compatible endpoints. */
+    baseUrl?: string;
+    /** Custom VLM provider callable. */
+    customVLM?: VLMProvider;
+    /** Tiling behaviour: `auto`, `off`, or explicit options. */
+    tiling?: "auto" | "off" | TileOptions;
+    /** Run invariant checks. */
+    prove?: boolean;
+    /** Custom invariant checks. */
+    invariants?: Array<{
+        id: string;
+        expression: string;
+        tolerance?: number;
+    }>;
+    /** Re-invoke the VLM with the discrepancy report when invariants fail. */
+    autoRepair?: boolean;
+    /** Max output tokens. */
+    maxTokens?: number;
+    /** Sampling temperature. */
+    temperature?: number;
+    /** Deterministic seed. */
+    seed?: number;
+    /** Prompt override. */
+    prompt?: string;
+    /** Optional progress callback. */
+    onProgress?: (p: {
+        step: string;
+        page: number;
+        tile?: number;
+    }) => void;
+}
+export interface IngestedPage {
+    index: number;
+    image: PageImage;
+    size: {
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/src/grounding/bbox.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A normalized bounding box in the form `[ymin, xmin, ymax, xmax]`
+ * where each value is in the range [0, 1] relative to the page dimensions.
+ */
+export type NormalizedBBox = [ymin: number, xmin: number, ymax: number, xmax: number];
+export interface PointBox {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+export interface PageSize {
+    width: number;
+    height: number;
+}
+export interface GroundedEntity<T = unknown> {
+    value: T;
+    pageIndex: number;
+    bbox: NormalizedBBox;
+    confidence?: number;
+    source: "vlm" | "ocr" | "anchor";
+}
+/**
+ * Convert absolute pixel coordinates into a normalized [ymin, xmin, ymax, xmax] box.
+ */
+export declare function normalizeBBox(box: PointBox, pageSize: PageSize): NormalizedBBox;
+/**
+ * Convert a normalized box back to absolute pixel coordinates.
+ */
+export declare function denormalizeBBox(bbox: NormalizedBBox, pageSize: PageSize): PointBox;
+/**
+ * Compute the Intersection over Union (IoU) of two normalized boxes.
+ * Returns a value in [0, 1].
+ */
+export declare function iou(a: NormalizedBBox, b: NormalizedBBox): number;
+/**
+ * Greedily merge overlapping boxes whose IoU is at least `iouThreshold`.
+ */
+export declare function mergeBoxes(boxes: NormalizedBBox[], iouThreshold?: number): NormalizedBBox[];
+//# sourceMappingURL=bbox.d.ts.map

package/dist/src/grounding/bbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bbox.d.ts","sourceRoot":"","sources":["../../../src/grounding/bbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAEtF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;CAClC;AAsBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAY/E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAQlF;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAqBhE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,SAAM,GACjB,cAAc,EAAE,CA4BlB"}

package/dist/src/grounding/bbox.js

@@ -0,0 +1,98 @@
+function validBox(b) {
+    return (Number.isFinite(b[0]) &&
+        Number.isFinite(b[1]) &&
+        Number.isFinite(b[2]) &&
+        Number.isFinite(b[3]) &&
+        b[0] <= b[2] &&
+        b[1] <= b[3]);
+}
+function safeBox(b) {
+    return [
+        Math.min(b[0], b[2]),
+        Math.min(b[1], b[3]),
+        Math.max(b[0], b[2]),
+        Math.max(b[1], b[3]),
+    ];
+}
+/**
+ * Convert absolute pixel coordinates into a normalized [ymin, xmin, ymax, xmax] box.
+ */
+export function normalizeBBox(box, pageSize) {
+    const minX = Math.min(box.x1, box.x2);
+    const maxX = Math.max(box.x1, box.x2);
+    const minY = Math.min(box.y1, box.y2);
+    const maxY = Math.max(box.y1, box.y2);
+    return [
+        minY / pageSize.height,
+        minX / pageSize.width,
+        maxY / pageSize.height,
+        maxX / pageSize.width,
+    ];
+}
+/**
+ * Convert a normalized box back to absolute pixel coordinates.
+ */
+export function denormalizeBBox(bbox, pageSize) {
+    const [ymin, xmin, ymax, xmax] = safeBox(bbox);
+    return {
+        x1: xmin * pageSize.width,
+        y1: ymin * pageSize.height,
+        x2: xmax * pageSize.width,
+        y2: ymax * pageSize.height,
+    };
+}
+/**
+ * Compute the Intersection over Union (IoU) of two normalized boxes.
+ * Returns a value in [0, 1].
+ */
+export function iou(a, b) {
+    const aBox = safeBox(a);
+    const bBox = safeBox(b);
+    if (!validBox(aBox) || !validBox(bBox))
+        return 0;
+    const ymin = Math.max(aBox[0], bBox[0]);
+    const xmin = Math.max(aBox[1], bBox[1]);
+    const ymax = Math.min(aBox[2], bBox[2]);
+    const xmax = Math.min(aBox[3], bBox[3]);
+    const interWidth = xmax - xmin;
+    const interHeight = ymax - ymin;
+    if (interWidth <= 0 || interHeight <= 0)
+        return 0;
+    const interArea = interWidth * interHeight;
+    const aArea = (aBox[2] - aBox[0]) * (aBox[3] - aBox[1]);
+    const bArea = (bBox[2] - bBox[0]) * (bBox[3] - bBox[1]);
+    const unionArea = aArea + bArea - interArea;
+    return unionArea === 0 ? 0 : interArea / unionArea;
+}
+/**
+ * Greedily merge overlapping boxes whose IoU is at least `iouThreshold`.
+ */
+export function mergeBoxes(boxes, iouThreshold = 0.5) {
+    if (boxes.length === 0)
+        return [];
+    const working = boxes.map(safeBox);
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (let i = 0; i < working.length; i++) {
+            for (let j = i + 1; j < working.length; j++) {
+                if (iou(working[i], working[j]) >= iouThreshold) {
+                    const merged = [
+                        Math.min(working[i][0], working[j][0]),
+                        Math.min(working[i][1], working[j][1]),
+                        Math.max(working[i][2], working[j][2]),
+                        Math.max(working[i][3], working[j][3]),
+                    ];
+                    working.splice(j, 1);
+                    working[i] = merged;
+                    changed = true;
+                    break;
+                }
+            }
+            if (changed)
+                break;
+        }
+    }
+    return working;
+}
+//# sourceMappingURL=bbox.js.map

package/dist/src/grounding/bbox.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./compiler/zod-compiler.js";
+export * from "./grounding/bbox.js";
+export * from "./normalizers/currency.js";
+export * from "./normalizers/tabular.js";
+export * from "./validators/invariants.js";
+export * from "./core/types.js";
+export { DocumentExtractor } from "./core/extractor.js";
+export * from "./providers/types.js";
+export { resolveProvider } from "./providers/factory.js";
+export { GeminiProvider } from "./providers/gemini-provider.js";
+export { OpenAIProvider } from "./providers/openai-provider.js";
+export { AnthropicProvider } from "./providers/anthropic-provider.js";
+export * from "./tiling/tiler.js";
+export { cropTile, getImageMetadata } from "./tiling/cutter.js";
+export { TableStitcher } from "./stitcher/table-stitcher.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,16 @@
+export * from "./compiler/zod-compiler.js";
+export * from "./grounding/bbox.js";
+export * from "./normalizers/currency.js";
+export * from "./normalizers/tabular.js";
+export * from "./validators/invariants.js";
+export * from "./core/types.js";
+export { DocumentExtractor } from "./core/extractor.js";
+export * from "./providers/types.js";
+export { resolveProvider } from "./providers/factory.js";
+export { GeminiProvider } from "./providers/gemini-provider.js";
+export { OpenAIProvider } from "./providers/openai-provider.js";
+export { AnthropicProvider } from "./providers/anthropic-provider.js";
+export * from "./tiling/tiler.js";
+export { cropTile, getImageMetadata } from "./tiling/cutter.js";
+export { TableStitcher } from "./stitcher/table-stitcher.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/src/normalizers/currency.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse an accounting number in multi-region formats and return a plain number.
+ *
+ * Supported inputs:
+ * - `$1,250.50` => 1250.5
+ * - `1.250,50 €` => 1250.5
+ * - `1,250` => 1250
+ * - `(450.00)` => -450
+ * - `-1.250,50` => -1250.5
+ *
+ * Returns `null` if the value cannot be parsed.
+ */
+export declare function parseAccountingNumber(val: string | number): number | null;
+//# sourceMappingURL=currency.d.ts.map

package/dist/src/normalizers/currency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency.d.ts","sourceRoot":"","sources":["../../../src/normalizers/currency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAmFzE"}