@pdf-testkit/core 0.1.0

package/dist/extract/pdfjs/overflow.d.ts

@@ -0,0 +1,16 @@
+import type { BBox, OverflowInfo } from '../../types.js';
+import type { PdfTextRun } from './textRuns.js';
+/**
+ * Content box inferred from the bounding box of a page's text. FormePDF gives a
+ * real content box; here we approximate it, so overflow from this path is
+ * explicitly best-effort (documented in the reliability matrix).
+ */
+export declare function inferContentBox(runs: PdfTextRun[], pageWidth: number, pageHeight: number): BBox;
+/**
+ * Conservative overflow detector: flags a run whose right edge extends past the
+ * expected (mirror-margin) text column by more than a line's worth. Tuned to
+ * under-report rather than cry wolf — a false overflow is exactly the noise this
+ * tool exists to avoid.
+ */
+export declare function buildOverflowModel(runs: PdfTextRun[], pageWidth: number): (run: PdfTextRun) => OverflowInfo | null;
+//# sourceMappingURL=overflow.d.ts.map

package/dist/extract/pdfjs/overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.d.ts","sourceRoot":"","sources":["../../../src/extract/pdfjs/overflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO/F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAAE,EAClB,SAAS,EAAE,MAAM,GAChB,CAAC,GAAG,EAAE,UAAU,KAAK,YAAY,GAAG,IAAI,CAW1C"}

package/dist/extract/pdfjs/overflow.js

@@ -0,0 +1,35 @@
+import { round1 } from '../../geometry.js';
+/**
+ * Content box inferred from the bounding box of a page's text. FormePDF gives a
+ * real content box; here we approximate it, so overflow from this path is
+ * explicitly best-effort (documented in the reliability matrix).
+ */
+export function inferContentBox(runs, pageWidth, pageHeight) {
+    if (runs.length === 0)
+        return { x: 0, y: 0, width: pageWidth, height: pageHeight };
+    const minX = Math.min(...runs.map((r) => r.x));
+    const maxX = Math.max(...runs.map((r) => r.x + r.width));
+    const minY = Math.min(...runs.map((r) => r.y));
+    const maxY = Math.max(...runs.map((r) => r.y + r.height));
+    return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+/**
+ * Conservative overflow detector: flags a run whose right edge extends past the
+ * expected (mirror-margin) text column by more than a line's worth. Tuned to
+ * under-report rather than cry wolf — a false overflow is exactly the noise this
+ * tool exists to avoid.
+ */
+export function buildOverflowModel(runs, pageWidth) {
+    if (runs.length === 0)
+        return () => null;
+    const leftMargin = Math.min(...runs.map((r) => r.x));
+    const rightLimit = pageWidth - leftMargin;
+    return (run) => {
+        const over = run.x + run.width - rightLimit;
+        if (over > Math.max(2, run.fontSize)) {
+            return { axis: 'x', overflowPts: round1(over), container: 'page-content' };
+        }
+        return null;
+    };
+}
+//# sourceMappingURL=overflow.js.map

package/dist/extract/pdfjs/overflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.js","sourceRoot":"","sources":["../../../src/extract/pdfjs/overflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAkB,EAAE,SAAiB,EAAE,UAAkB;IACvF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAkB,EAClB,SAAiB;IAEjB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,GAAG,UAAU,CAAC;QAC5C,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;QAC7E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist/extract/pdfjs/tables.d.ts

@@ -0,0 +1,31 @@
+import type { BBox } from '../../types.js';
+import type { PdfTextRun } from './textRuns.js';
+export interface DetectedCell {
+    bbox: BBox;
+    text: string;
+    runs: PdfTextRun[];
+}
+export interface DetectedRow {
+    bbox: BBox;
+    cells: DetectedCell[];
+}
+export interface DetectedTable {
+    bbox: BBox;
+    rows: DetectedRow[];
+    cols: number;
+}
+/**
+ * The single hardest problem in v0.1: PDF has no native concept of a table, so
+ * one is inferred from the geometry of text runs. Heuristic (borderless, text-
+ * driven — ruled/border-only tables need operator-list parsing and are deferred):
+ *
+ *   1. Group runs into row bands by y (tolerance from median line height).
+ *   2. Cluster run left-edges across the page into columns.
+ *   3. A table = a maximal run of >= 3 consecutive bands that each populate
+ *      >= 2 of the same columns.
+ *
+ * Emits low-confidence regions (callers tag them ~0.5); false positives/negatives
+ * are expected on merged/wrapped cells and are managed via `minConfidence`.
+ */
+export declare function detectTables(runs: PdfTextRun[]): DetectedTable[];
+//# sourceMappingURL=tables.d.ts.map

package/dist/extract/pdfjs/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../src/extract/pdfjs/tables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AACD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AACD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,aAAa,EAAE,CAsChE"}

package/dist/extract/pdfjs/tables.js

@@ -0,0 +1,142 @@
+import { median } from '../../geometry.js';
+/**
+ * The single hardest problem in v0.1: PDF has no native concept of a table, so
+ * one is inferred from the geometry of text runs. Heuristic (borderless, text-
+ * driven — ruled/border-only tables need operator-list parsing and are deferred):
+ *
+ *   1. Group runs into row bands by y (tolerance from median line height).
+ *   2. Cluster run left-edges across the page into columns.
+ *   3. A table = a maximal run of >= 3 consecutive bands that each populate
+ *      >= 2 of the same columns.
+ *
+ * Emits low-confidence regions (callers tag them ~0.5); false positives/negatives
+ * are expected on merged/wrapped cells and are managed via `minConfidence`.
+ */
+export function detectTables(runs) {
+    if (runs.length < 6)
+        return [];
+    const heights = runs.map((r) => r.height).filter((h) => h > 0);
+    const rowTol = Math.max(2, 0.6 * median(heights));
+    const bands = groupBands(runs, rowTol);
+    if (bands.length < 3)
+        return [];
+    const charWidths = runs.map((r) => r.width / Math.max(1, r.text.length)).filter((w) => w > 0);
+    const colTol = Math.max(4, (median(charWidths) || median(heights) * 0.5) * 2);
+    const columns = clusterValues(bands.flatMap((b) => b.map((r) => r.x)), colTol);
+    const colOf = (x) => nearestIndex(columns, x, colTol);
+    const bandCols = bands.map((b) => new Set(b.map((r) => colOf(r.x)).filter((i) => i >= 0)));
+    const tables = [];
+    let i = 0;
+    while (i < bands.length) {
+        if (bandCols[i].size < 2) {
+            i++;
+            continue;
+        }
+        let j = i;
+        while (j + 1 < bands.length &&
+            bandCols[j + 1].size >= 2 &&
+            intersectionSize(bandCols[i], bandCols[j + 1]) >= 2) {
+            j++;
+        }
+        if (j - i + 1 >= 3) {
+            tables.push(buildTable(bands.slice(i, j + 1), columns, colTol));
+        }
+        i = j + 1;
+    }
+    return tables;
+}
+function groupBands(runs, rowTol) {
+    const sorted = [...runs].sort((a, b) => a.y - b.y || a.x - b.x);
+    const bands = [];
+    let current = [];
+    let bandY = -Infinity;
+    for (const r of sorted) {
+        if (current.length === 0 || Math.abs(r.y - bandY) <= rowTol) {
+            current.push(r);
+            bandY = current.length === 1 ? r.y : bandY;
+        }
+        else {
+            bands.push(current);
+            current = [r];
+            bandY = r.y;
+        }
+    }
+    if (current.length)
+        bands.push(current);
+    return bands.map((b) => b.sort((a, c) => a.x - c.x));
+}
+function buildTable(bands, columns, colTol) {
+    const rows = bands.map((band) => {
+        const byCol = new Map();
+        for (const r of band) {
+            const c = nearestIndex(columns, r.x, colTol);
+            const key = c >= 0 ? c : columns.length + Math.round(r.x);
+            const bucket = byCol.get(key);
+            if (bucket)
+                bucket.push(r);
+            else
+                byCol.set(key, [r]);
+        }
+        const cells = [...byCol.entries()]
+            .sort((a, b) => a[0] - b[0])
+            .map(([, cellRuns]) => ({
+            bbox: unionBBox(cellRuns),
+            text: cellRuns
+                .sort((a, b) => a.x - b.x)
+                .map((r) => r.text)
+                .join(' ')
+                .trim(),
+            runs: cellRuns,
+        }));
+        return { bbox: unionBBox(band), cells };
+    });
+    const cols = Math.max(0, ...rows.map((r) => r.cells.length));
+    return { bbox: unionBBox(bands.flat()), rows, cols };
+}
+function unionBBox(runs) {
+    const minX = Math.min(...runs.map((r) => r.x));
+    const maxX = Math.max(...runs.map((r) => r.x + r.width));
+    const minY = Math.min(...runs.map((r) => r.y));
+    const maxY = Math.max(...runs.map((r) => r.y + r.height));
+    return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+/** 1-D gap clustering: values within `tol` of the running group join it. */
+function clusterValues(values, tol) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const centers = [];
+    let group = [];
+    for (const v of sorted) {
+        const last = group[group.length - 1];
+        if (last !== undefined && v - last > tol) {
+            centers.push(mean(group));
+            group = [];
+        }
+        group.push(v);
+    }
+    if (group.length)
+        centers.push(mean(group));
+    return centers;
+}
+function nearestIndex(centers, x, tol) {
+    let bestI = -1;
+    let bestD = tol;
+    for (let i = 0; i < centers.length; i++) {
+        const d = Math.abs(centers[i] - x);
+        if (d <= bestD) {
+            bestD = d;
+            bestI = i;
+        }
+    }
+    return bestI;
+}
+function intersectionSize(a, b) {
+    let n = 0;
+    for (const v of a)
+        if (b.has(v))
+            n++;
+    return n;
+}
+function mean(values) {
+    return values.reduce((s, v) => s + v, 0) / values.length;
+}
+//# sourceMappingURL=tables.js.map

package/dist/extract/pdfjs/tables.js.map

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

package/dist/extract/pdfjs/textRuns.d.ts

@@ -0,0 +1,26 @@
+import type { LoadedPdfPage } from './loadDocument.js';
+/** A merged text run with top-left coordinates and inferred font attributes. */
+export interface PdfTextRun {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    text: string;
+    fontSize: number;
+    fontName: string;
+    bold: boolean;
+    italic: boolean;
+    charCount: number;
+}
+/**
+ * Extract merged text runs from a pdfjs page, converting bottom-left PDF
+ * coordinates to the top-left origin the rest of the model uses. pdfjs emits
+ * per-glyph-cluster items, so adjacent items on the same baseline are merged
+ * into runs to stabilize node identity.
+ */
+export declare function extractTextRuns(page: LoadedPdfPage): Promise<{
+    runs: PdfTextRun[];
+    width: number;
+    height: number;
+}>;
+//# sourceMappingURL=textRuns.d.ts.map

package/dist/extract/pdfjs/textRuns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textRuns.d.ts","sourceRoot":"","sources":["../../../src/extract/pdfjs/textRuns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,mBAAmB,CAAC;AAEpE,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BhE"}

package/dist/extract/pdfjs/textRuns.js

@@ -0,0 +1,69 @@
+const BOLD_RE = /bold|black|semibold|heavy/i;
+const ITALIC_RE = /italic|oblique/i;
+/**
+ * pdfjs names loaded fonts `g_d{docId}_f{n}`, where `docId` is a process-global
+ * counter that increments on every `getDocument` call — so the raw name differs
+ * between two loads of the same file and would make snapshots non-deterministic.
+ * Strip the volatile doc-id segment, keeping the stable per-document font index.
+ */
+function sanitizeFontName(name) {
+    return name.replace(/^g_d\d+_/, 'g_');
+}
+/**
+ * Extract merged text runs from a pdfjs page, converting bottom-left PDF
+ * coordinates to the top-left origin the rest of the model uses. pdfjs emits
+ * per-glyph-cluster items, so adjacent items on the same baseline are merged
+ * into runs to stabilize node identity.
+ */
+export async function extractTextRuns(page) {
+    const viewport = page.getViewport({ scale: 1 });
+    const content = await page.getTextContent();
+    const items = content.items.filter((it) => typeof it?.str === 'string');
+    const raw = [];
+    for (const it of items) {
+        if (it.str.length === 0)
+            continue;
+        const t = it.transform;
+        const x = t[4] ?? 0;
+        const yBottom = t[5] ?? 0;
+        const fontSize = Math.hypot(t[2] ?? 0, t[3] ?? 0) || Math.abs(t[3] ?? 0) || it.height || 0;
+        const height = it.height || fontSize;
+        const width = it.width || 0;
+        const fontName = sanitizeFontName(it.fontName ?? '');
+        raw.push({
+            x,
+            y: viewport.height - (yBottom + height),
+            width,
+            height,
+            text: it.str,
+            fontSize,
+            fontName,
+            bold: BOLD_RE.test(fontName),
+            italic: ITALIC_RE.test(fontName),
+            charCount: it.str.length,
+        });
+    }
+    return { runs: mergeRuns(raw), width: viewport.width, height: viewport.height };
+}
+function mergeRuns(items) {
+    const sorted = [...items].sort((a, b) => a.y - b.y || a.x - b.x);
+    const out = [];
+    for (const it of sorted) {
+        const prev = out[out.length - 1];
+        const sameLine = prev && Math.abs(prev.y - it.y) <= Math.max(1, prev.height * 0.4);
+        const sameFont = prev && Math.abs(prev.fontSize - it.fontSize) <= 0.5;
+        const gap = prev ? it.x - (prev.x + prev.width) : Infinity;
+        const adjacent = prev && gap <= prev.fontSize * 0.6 && it.x >= prev.x - 0.5;
+        if (prev && sameLine && sameFont && adjacent) {
+            prev.text += (gap > prev.fontSize * 0.2 ? ' ' : '') + it.text;
+            prev.width = it.x + it.width - prev.x;
+            prev.charCount += it.charCount;
+            prev.bold = prev.bold || it.bold;
+        }
+        else {
+            out.push({ ...it });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=textRuns.js.map

package/dist/extract/pdfjs/textRuns.js.map

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

package/dist/extract/raw.d.ts

@@ -0,0 +1,29 @@
+import type { BBox, FontInfo, NodeRole, OverflowInfo } from '../types.js';
+/**
+ * Intermediate extractor output, before `finalize` assigns stable ids, reading
+ * order, normalized text, and the content hash. Extractors reference parents by
+ * a temporary key; finalize remaps those to final ids.
+ */
+export interface RawNode {
+    tempId: string;
+    parentTempId: string | null;
+    role: NodeRole;
+    pageIndex: number;
+    bbox: BBox;
+    text: string | null;
+    font: FontInfo | null;
+    headingLevel: number | null;
+    overflow: OverflowInfo | null;
+    table?: {
+        rows: number;
+        cols: number;
+    };
+    confidence: number;
+}
+export interface RawPage {
+    index: number;
+    width: number;
+    height: number;
+    contentBox: BBox;
+}
+//# sourceMappingURL=raw.d.ts.map

package/dist/extract/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/extract/raw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;CAClB"}

package/dist/extract/raw.js

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

package/dist/extract/raw.js.map

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

package/dist/geometry.d.ts

@@ -0,0 +1,13 @@
+import type { BBox, OverflowInfo } from './types.js';
+/** Round to 0.1pt so trivial float noise never creates a diff. */
+export declare function round1(n: number): number;
+export declare function roundBBox(b: BBox): BBox;
+/** Center-to-center distance between two boxes (used for on-page move detection). */
+export declare function centerDistance(a: BBox, b: BBox): number;
+/**
+ * Overflow of `node` past `container`, or null if it fits (within `tol`).
+ * Considers all four edges; reports the dominant axis and the max overshoot.
+ */
+export declare function computeOverflow(node: BBox, container: BBox, kind: OverflowInfo['container'], tol?: number): OverflowInfo | null;
+export declare function median(values: number[]): number;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAErD,kEAAkE;AAClE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAEvC;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAMvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,IAAI,EACf,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC,EAC/B,GAAG,SAAM,GACR,YAAY,GAAG,IAAI,CAUrB;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAO/C"}

package/dist/geometry.js

@@ -0,0 +1,41 @@
+/** Round to 0.1pt so trivial float noise never creates a diff. */
+export function round1(n) {
+    return Math.round((n + Number.EPSILON) * 10) / 10;
+}
+export function roundBBox(b) {
+    return { x: round1(b.x), y: round1(b.y), width: round1(b.width), height: round1(b.height) };
+}
+/** Center-to-center distance between two boxes (used for on-page move detection). */
+export function centerDistance(a, b) {
+    const ax = a.x + a.width / 2;
+    const ay = a.y + a.height / 2;
+    const bx = b.x + b.width / 2;
+    const by = b.y + b.height / 2;
+    return Math.hypot(ax - bx, ay - by);
+}
+/**
+ * Overflow of `node` past `container`, or null if it fits (within `tol`).
+ * Considers all four edges; reports the dominant axis and the max overshoot.
+ */
+export function computeOverflow(node, container, kind, tol = 0.5) {
+    const overRight = node.x + node.width - (container.x + container.width);
+    const overBottom = node.y + node.height - (container.y + container.height);
+    const overLeft = container.x - node.x;
+    const overTop = container.y - node.y;
+    const xOver = Math.max(overRight, overLeft, 0);
+    const yOver = Math.max(overBottom, overTop, 0);
+    if (xOver <= tol && yOver <= tol)
+        return null;
+    const axis = xOver > tol && yOver > tol ? 'both' : xOver > tol ? 'x' : 'y';
+    return { axis, overflowPts: round1(Math.max(xOver, yOver)), container: kind };
+}
+export function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0
+        ? (sorted[mid - 1] + sorted[mid]) / 2
+        : sorted[mid];
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/** Public API for @pdf-testkit/core. */
+export type { BBox, FontInfo, NodeRole, OverflowInfo, PageSnapshot, Producer, SnapshotSchemaVersion, StructuralNode, StructuralSnapshot, } from './types.js';
+export type { BaseEvent, DiffOptions, DiffResult, ElementAddedEvent, ElementMovedToPageEvent, ElementRemovedEvent, HeadingHierarchyChangedEvent, PageCountChangedEvent, SemanticEvent, SemanticEventType, Severity, TableMovedEvent, TextOverflowedEvent, } from './events.js';
+export { DEFAULT_SEVERITY, DEFAULT_POSITION_THRESHOLD_PTS } from './events.js';
+export { fromFormeLayout, FormeShapeError, FORME_ROLE_BY_NODE_TYPE, FORME_INTENTIONALLY_UNMAPPED, } from './extract/fromFormeLayout.js';
+export type { FormeLayoutInfo, FormePageInfo, FormeElementInfo, } from './extract/fromFormeLayout.js';
+export { fromPdf } from './extract/fromPdf.js';
+export { diffSnapshots } from './diff/diff.js';
+export { matchNodes } from './diff/match.js';
+export type { MatchResult, NodePair } from './diff/match.js';
+export { readSnapshotFile, writeSnapshotFile } from './snapshot/io.js';
+export { loadSnapshotFromFile } from './snapshot/load.js';
+export { serializeSnapshot, computeContentHash, stableStringify } from './snapshot/serialize.js';
+export { normalizeText, textPreview, textSimilarity } from './text/normalize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAGxC,YAAY,EACV,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,qBAAqB,EACrB,cAAc,EACd,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAG/E,OAAO,EACL,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/** Public API for @pdf-testkit/core. */
+export { DEFAULT_SEVERITY, DEFAULT_POSITION_THRESHOLD_PTS } from './events.js';
+// Extractors
+export { fromFormeLayout, FormeShapeError, FORME_ROLE_BY_NODE_TYPE, FORME_INTENTIONALLY_UNMAPPED, } from './extract/fromFormeLayout.js';
+export { fromPdf } from './extract/fromPdf.js';
+// Diff engine
+export { diffSnapshots } from './diff/diff.js';
+export { matchNodes } from './diff/match.js';
+// Snapshot IO + helpers
+export { readSnapshotFile, writeSnapshotFile } from './snapshot/io.js';
+export { loadSnapshotFromFile } from './snapshot/load.js';
+export { serializeSnapshot, computeContentHash, stableStringify } from './snapshot/serialize.js';
+export { normalizeText, textPreview, textSimilarity } from './text/normalize.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AA+BxC,OAAO,EAAE,gBAAgB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAE/E,aAAa;AACb,OAAO,EACL,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,wBAAwB;AACxB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/snapshot/io.d.ts

@@ -0,0 +1,4 @@
+import type { StructuralSnapshot } from '../types.js';
+export declare function readSnapshotFile(path: string): Promise<StructuralSnapshot>;
+export declare function writeSnapshotFile(path: string, snapshot: StructuralSnapshot): Promise<void>;
+//# sourceMappingURL=io.d.ts.map

package/dist/snapshot/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/snapshot/io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAGhF;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/snapshot/io.js

@@ -0,0 +1,12 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { serializeSnapshot } from './serialize.js';
+export async function readSnapshotFile(path) {
+    const raw = await readFile(path, 'utf8');
+    return JSON.parse(raw);
+}
+export async function writeSnapshotFile(path, snapshot) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, serializeSnapshot(snapshot) + '\n', 'utf8');
+}
+//# sourceMappingURL=io.js.map

package/dist/snapshot/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/snapshot/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,QAA4B;IAE5B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}

package/dist/snapshot/load.d.ts

@@ -0,0 +1,9 @@
+import type { StructuralSnapshot } from '../types.js';
+/**
+ * Resolve a filesystem path to a structural snapshot. Accepts a `.pdf` (parsed
+ * via pdfjs), a `.json` StructuralSnapshot (used as-is), or a `.json` FormePDF
+ * LayoutInfo (converted). Shared by the CLI and the GitHub Action so both accept
+ * PDFs and snapshots interchangeably.
+ */
+export declare function loadSnapshotFromFile(path: string): Promise<StructuralSnapshot>;
+//# sourceMappingURL=load.d.ts.map

package/dist/snapshot/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/snapshot/load.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAapF"}

package/dist/snapshot/load.js

@@ -0,0 +1,25 @@
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { fromFormeLayout } from '../extract/fromFormeLayout.js';
+import { fromPdf } from '../extract/fromPdf.js';
+/**
+ * Resolve a filesystem path to a structural snapshot. Accepts a `.pdf` (parsed
+ * via pdfjs), a `.json` StructuralSnapshot (used as-is), or a `.json` FormePDF
+ * LayoutInfo (converted). Shared by the CLI and the GitHub Action so both accept
+ * PDFs and snapshots interchangeably.
+ */
+export async function loadSnapshotFromFile(path) {
+    if (extname(path).toLowerCase() === '.json') {
+        const raw = JSON.parse(await readFile(path, 'utf8'));
+        if (raw && raw['contentHash'] && Array.isArray(raw['nodes'])) {
+            return raw;
+        }
+        if (raw && Array.isArray(raw['pages'])) {
+            return fromFormeLayout(raw, { source: { name: path } });
+        }
+        throw new Error(`${path}: JSON is neither a StructuralSnapshot nor a FormePDF LayoutInfo`);
+    }
+    const bytes = new Uint8Array(await readFile(path));
+    return fromPdf(bytes, { source: { name: path } });
+}
+//# sourceMappingURL=load.js.map

package/dist/snapshot/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/snapshot/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAA4B,CAAC;QAChF,IAAI,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC7D,OAAO,GAAoC,CAAC;QAC9C,CAAC;QACD,IAAI,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,eAAe,CAAC,GAAY,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kEAAkE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/snapshot/serialize.d.ts

@@ -0,0 +1,14 @@
+import type { StructuralSnapshot } from '../types.js';
+/** Deterministic JSON with recursively sorted object keys. */
+export declare function stableStringify(value: unknown): string;
+/**
+ * Content hash over everything that describes the document structure, excluding
+ * volatile/derived fields (`createdAt`, `contentHash` itself, and reporting-only
+ * `source`). Identical structure -> identical hash, which lets the matcher and
+ * CLI short-circuit to "no change".
+ */
+export declare function computeContentHash(snapshot: Omit<StructuralSnapshot, 'contentHash'> & {
+    contentHash?: string;
+}): string;
+export declare function serializeSnapshot(snapshot: StructuralSnapshot, pretty?: boolean): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/snapshot/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/snapshot/serialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3E,MAAM,CAGR;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,UAAO,GAAG,MAAM,CAErF"}