@mikashboks/capture-intelligence-core 0.1.0

package/dist/esm/quality-checks.js

@@ -0,0 +1,400 @@
+/**
+ * Quality checks -- threshold comparison logic and failure escalation rules.
+ *
+ * DOM-free: no HTMLElement, no document.*, no navigator.*. All functions
+ * operate on plain data (FrameMetrics, QualityCheckResults, numeric values).
+ *
+ * The DOM-coupled parts of quality-review.ts (banner updates, button state,
+ * shake animations, Svelte store, etc.) remain in the SDK. This module
+ * exposes the pure decision logic that can be reused in React Native or
+ * Node.js environments.
+ */
+import { CAM_BRIGHTNESS_MIN, CAM_BRIGHTNESS_MAX, DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD, SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD, ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD, } from './types.js';
+import { checkDocumentLikelihood } from './document-classifier.js';
+/* -- Quality bucket classification ---------------------------------------- */
+/**
+ * Map a step signature string and optional review mode to a quality bucket.
+ */
+export function getQualityBucket(stepSig, reviewMode = 'document') {
+    if (!stepSig)
+        return '';
+    if (reviewMode === 'front-door')
+        return 'address_front_door';
+    if (reviewMode === 'address-document')
+        return 'address_document';
+    if (stepSig.indexOf('selfie') !== -1)
+        return 'selfie';
+    if (stepSig.indexOf('address') !== -1)
+        return 'address_document';
+    if (stepSig.indexOf('back') !== -1)
+        return 'document_back';
+    return 'document_front';
+}
+/* -- Submit-anyway threshold lookup --------------------------------------- */
+/**
+ * Get the number of consecutive failures required before the "submit anyway"
+ * override becomes available for a given step signature.
+ */
+export function getSubmitAnywayThreshold(stepSig, reviewMode) {
+    const bucket = getQualityBucket(stepSig, reviewMode);
+    if (bucket === 'selfie')
+        return SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD;
+    if (bucket === 'document_front' || bucket === 'document_back') {
+        return DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD;
+    }
+    if (bucket === 'address_document' || bucket === 'address_front_door') {
+        return ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD;
+    }
+    return Number.POSITIVE_INFINITY;
+}
+/**
+ * Create a fresh failure state.
+ */
+export function createQualityFailureState() {
+    return {
+        document_front: 0,
+        document_back: 0,
+        selfie: 0,
+        address_document: 0,
+        address_front_door: 0,
+        lastFailedSignature: '',
+    };
+}
+/**
+ * Increment the failure counter for a bucket if this is a new failure
+ * (not a re-render of the same failed review).
+ *
+ * @param state         - Mutable failure state
+ * @param stepSig       - Step signature string
+ * @param failSignature - Unique signature for this failure (e.g. bucket + image src)
+ * @param anyFail       - Whether any quality check actually failed
+ * @returns true if the counter was incremented
+ */
+export function countFailedReview(state, stepSig, failSignature, anyFail, reviewMode) {
+    if (!anyFail)
+        return false;
+    const bucket = getQualityBucket(stepSig, reviewMode);
+    if (!bucket)
+        return false;
+    if (!failSignature || failSignature === state.lastFailedSignature)
+        return false;
+    const current = getFailureCount(state, bucket);
+    setFailureCount(state, bucket, current + 1);
+    state.lastFailedSignature = failSignature;
+    return true;
+}
+/**
+ * Check whether the submit-anyway override should be available.
+ */
+export function shouldShowSubmitAnyway(state, stepSig, reviewMode) {
+    const bucket = getQualityBucket(stepSig, reviewMode);
+    if (!bucket)
+        return false;
+    const failCount = getFailureCount(state, bucket);
+    return failCount >= getSubmitAnywayThreshold(stepSig, reviewMode);
+}
+/* -- Internal helpers for typed bucket access ------------------------------ */
+function getFailureCount(state, bucket) {
+    switch (bucket) {
+        case 'document_front': return state.document_front;
+        case 'document_back': return state.document_back;
+        case 'selfie': return state.selfie;
+        case 'address_document': return state.address_document;
+        case 'address_front_door': return state.address_front_door;
+        default: return 0;
+    }
+}
+function setFailureCount(state, bucket, value) {
+    switch (bucket) {
+        case 'document_front':
+            state.document_front = value;
+            break;
+        case 'document_back':
+            state.document_back = value;
+            break;
+        case 'selfie':
+            state.selfie = value;
+            break;
+        case 'address_document':
+            state.address_document = value;
+            break;
+        case 'address_front_door':
+            state.address_front_door = value;
+            break;
+    }
+}
+/**
+ * Run quality checks on a static document image. Returns the check results
+ * and a human-readable failure message.
+ *
+ * This is the pure-logic extraction from `runQualityCheck()`. The caller
+ * handles image loading, Canvas rasterization, and UI updates.
+ */
+export function runDocumentQualityChecks(input) {
+    const checks = {};
+    const brightnessOk = input.avgBrightness >= CAM_BRIGHTNESS_MIN && input.avgBrightness <= CAM_BRIGHTNESS_MAX;
+    const sharpnessOk = input.laplacianVariance >= 60;
+    if (input.isAddressProof) {
+        checks['address_readable'] = sharpnessOk && brightnessOk;
+    }
+    else {
+        const textReadableOk = sharpnessOk && input.cornersOk !== false;
+        checks['text_readable'] = textReadableOk;
+        checks['good_lighting'] = brightnessOk;
+        if (input.cornersOk === true) {
+            checks['corners_visible'] = true;
+        }
+        else if (input.cornersOk === false) {
+            checks['corners_visible'] = false;
+        }
+        // Canvas heuristic: does this look like the submitted document type?
+        const docResult = checkDocumentLikelihood(input.grey, input.imgData, input.w, input.h, input.documentType);
+        const docLooksValid = docResult.isLikelyDoc && input.cornersOk !== false && textReadableOk;
+        checks['content_valid'] = docLooksValid;
+        // Surface glare detection
+        if (docResult.glareDetected) {
+            checks['glare_free'] = false;
+        }
+        if (!docResult.isLikelyDoc) {
+            checks['text_readable'] = false;
+        }
+        else if (input.cornersOk === false) {
+            checks['text_readable'] = false;
+        }
+    }
+    // Determine the prioritised failure message
+    const { anyFail, failMessage } = evaluateDocumentFailure(checks, input.isAddressProof);
+    return { checks, anyFail, failMessage };
+}
+/**
+ * Run basic selfie quality checks (lighting + sharpness, before face
+ * detection). Returns the `good_lighting` check result.
+ */
+export function runSelfieQualityChecks(input) {
+    const checks = {};
+    const sharpnessOk = input.laplacianVariance >= 50;
+    const brightnessOk = input.avgBrightness >= 35 && input.avgBrightness <= 240;
+    checks['good_lighting'] = brightnessOk && sharpnessOk;
+    return checks;
+}
+/* -- Face quality checks -------------------------------------------------- */
+/**
+ * Check face position and size relative to image dimensions.
+ * Returns an array of warning strings (empty = face is OK).
+ *
+ * @param faces       - Detected faces
+ * @param imageWidth  - Full image width
+ * @param imageHeight - Full image height
+ */
+export function checkFaceInImage(faces, imageWidth, imageHeight) {
+    const warnings = [];
+    if (!faces || faces.length === 0) {
+        warnings.push('No face found. Try retaking.');
+        return warnings;
+    }
+    const face = faces[0];
+    const box = face.boundingBox;
+    const faceArea = box.width * box.height;
+    const imageArea = imageWidth * imageHeight;
+    const faceRatio = faceArea / imageArea;
+    if (faceRatio < 0.03) {
+        warnings.push('Face too small. Hold phone closer.');
+    }
+    const faceCenterX = box.x + box.width / 2;
+    const faceCenterY = box.y + box.height / 2;
+    const imageCenterX = imageWidth / 2;
+    const imageCenterY = imageHeight / 2;
+    const xTolerance = imageWidth * 0.25;
+    const yTolerance = imageHeight * 0.25;
+    if (Math.abs(faceCenterX - imageCenterX) >= xTolerance ||
+        Math.abs(faceCenterY - imageCenterY) >= yTolerance) {
+        warnings.push('Face is off-center. Try retaking.');
+    }
+    return warnings;
+}
+/**
+ * Check whether a detected face is well-centered and appropriately sized
+ * for live capture (stricter than static image checks).
+ *
+ * @param face        - Detected face
+ * @param videoWidth  - Video frame width
+ * @param videoHeight - Video frame height
+ */
+export function isFaceCentered(face, videoWidth, videoHeight) {
+    const box = face.boundingBox;
+    const faceCenterX = box.x + box.width / 2;
+    const faceCenterY = box.y + box.height / 2;
+    const videoCenterX = videoWidth / 2;
+    const videoCenterY = videoHeight / 2;
+    const xTolerance = videoWidth * 0.2;
+    const yTolerance = videoHeight * 0.2;
+    const centeredX = Math.abs(faceCenterX - videoCenterX) < xTolerance;
+    const centeredY = Math.abs(faceCenterY - videoCenterY) < yTolerance;
+    const faceArea = box.width * box.height;
+    const videoArea = videoWidth * videoHeight;
+    const faceRatio = faceArea / videoArea;
+    const goodSize = faceRatio > 0.025 && faceRatio < 0.45;
+    return centeredX && centeredY && goodSize;
+}
+/* -- Failure evaluation helpers ------------------------------------------- */
+/**
+ * Evaluate document quality check results and produce a prioritised failure
+ * message. Handles address-proof and ID-document modes.
+ */
+export function evaluateDocumentFailure(checks, isAddressProof) {
+    let anyFail = false;
+    let failMessage = '';
+    if (isAddressProof) {
+        if (checks.hasOwnProperty('address_readable') && !checks['address_readable']) {
+            anyFail = true;
+            failMessage = 'Can\u2019t read the text. Try again in better light.';
+        }
+    }
+    else {
+        if (checks.hasOwnProperty('corners_visible') && !checks['corners_visible']) {
+            anyFail = true;
+            failMessage = 'Part of the ID is cut off. Show all 4 corners.';
+        }
+        else if (checks.hasOwnProperty('content_valid') && !checks['content_valid']) {
+            anyFail = true;
+            failMessage = 'Doesn\u2019t look like an ID. Show the full document and try again.';
+        }
+        else if (checks.hasOwnProperty('good_lighting') && !checks['good_lighting']) {
+            anyFail = true;
+            failMessage = 'Too dark or blurry. Try again in better light.';
+        }
+        else if (checks.hasOwnProperty('text_readable') && !checks['text_readable']) {
+            anyFail = true;
+            failMessage = 'Text is hard to read. Hold steady and try again.';
+        }
+        else if (checks.hasOwnProperty('glare_free') && !checks['glare_free']) {
+            anyFail = true;
+            failMessage = 'Glare on the ID. Tilt away from light and try again.';
+        }
+    }
+    return { anyFail, failMessage };
+}
+/**
+ * Evaluate selfie quality check results and produce a prioritised failure
+ * message.
+ */
+export function evaluateSelfieFailure(checks) {
+    let anyFail = false;
+    let failMessage = '';
+    if (checks.hasOwnProperty('face_visible') && !checks['face_visible']) {
+        anyFail = true;
+        failMessage = 'Can\u2019t see your face. Center it and try again.';
+    }
+    else if (checks.hasOwnProperty('good_lighting') && !checks['good_lighting']) {
+        anyFail = true;
+        failMessage = 'Too dark. Move to better light and try again.';
+    }
+    return { anyFail, failMessage };
+}
+/**
+ * Evaluate quality failures for a specific review mode using the same
+ * prioritization rules as the SDK review banner.
+ */
+export function evaluateReviewFailure(checks, options) {
+    if (options.reviewMode === 'selfie') {
+        return evaluateSelfieFailure(checks);
+    }
+    if (options.reviewMode === 'front-door') {
+        if (checks.hasOwnProperty('front_door_clear') && !checks['front_door_clear']) {
+            return {
+                anyFail: true,
+                failMessage: options.failMessage || 'Too dark or blurry. Retake the front of your house.',
+            };
+        }
+        return { anyFail: false, failMessage: '' };
+    }
+    if (options.reviewMode === 'address-document') {
+        return evaluateDocumentFailure(checks, true);
+    }
+    return evaluateDocumentFailure(checks, false);
+}
+/**
+ * Determine whether the "next" button should be disabled based on the
+ * current quality check state.
+ *
+ * @param checks         - Current quality check results
+ * @param isSelfie       - Whether this is a selfie review
+ * @param isAddressProof - Whether this is an address proof review
+ * @returns Disabled reason string (empty = should be enabled)
+ */
+export function getNextButtonDisabledReason(checks, isSelfieOrOptions, isAddressProof = false) {
+    const options = typeof isSelfieOrOptions === 'boolean'
+        ? {
+            reviewMode: isSelfieOrOptions ? 'selfie' : isAddressProof ? 'address-document' : 'document',
+        }
+        : isSelfieOrOptions;
+    if (options.reviewMode === 'selfie') {
+        if (!checks.hasOwnProperty('face_visible')) {
+            return 'Reviewing selfie...';
+        }
+        if (!checks['face_visible']) {
+            return 'Please retake this selfie to continue';
+        }
+        if (checks.hasOwnProperty('good_lighting') && !checks['good_lighting']) {
+            return 'Please retake this selfie to continue';
+        }
+        return '';
+    }
+    if (options.reviewMode === 'front-door') {
+        const pendingMessage = options.pendingMessage || 'Reviewing photo...';
+        const failMessage = options.failMessage || 'Please retake this photo to continue';
+        if (!checks.hasOwnProperty('front_door_clear')) {
+            return pendingMessage;
+        }
+        if (!checks['front_door_clear']) {
+            return failMessage;
+        }
+        return '';
+    }
+    if (options.reviewMode === 'address-document') {
+        const pendingMessage = options.pendingMessage || 'Reviewing photo...';
+        const failMessage = options.failMessage || 'Please retake this photo to continue';
+        if (!checks.hasOwnProperty('address_readable')) {
+            return pendingMessage;
+        }
+        if (!checks['address_readable']) {
+            return failMessage;
+        }
+        return '';
+    }
+    const requiredDocChecks = ['content_valid', 'text_readable', 'good_lighting'];
+    for (let ci = 0; ci < requiredDocChecks.length; ci++) {
+        if (!checks.hasOwnProperty(requiredDocChecks[ci])) {
+            return 'Reviewing photo...';
+        }
+    }
+    for (let ri = 0; ri < requiredDocChecks.length; ri++) {
+        if (!checks[requiredDocChecks[ri]]) {
+            return 'Please retake this photo to continue';
+        }
+    }
+    if (checks.hasOwnProperty('corners_visible') && !checks['corners_visible']) {
+        return 'Please retake this photo to continue';
+    }
+    return '';
+}
+/**
+ * Get the override button text for the submit-anyway flow.
+ */
+export function getOverrideButtonText(stepSig) {
+    const bucket = getQualityBucket(stepSig);
+    return bucket === 'selfie' ? 'Continue With This Selfie' : 'Continue With This Photo';
+}
+/**
+ * Get the override banner message based on failure count and bucket.
+ */
+export function getOverrideBannerMessage(stepSig, failCount, reviewMode) {
+    const bucket = getQualityBucket(stepSig, reviewMode);
+    if (failCount >= 5) {
+        return 'Having trouble? Continue and our team will check it.';
+    }
+    return bucket === 'selfie'
+        ? 'Selfie is unclear. You can continue, but a better photo speeds things up.'
+        : 'Photo is unclear. You can continue, but a better photo speeds things up.';
+}
+//# sourceMappingURL=quality-checks.js.map

package/dist/esm/quality-checks.js.map

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

package/dist/esm/sobel.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Sobel edge detection on raw pixel data.
+ *
+ * DOM-free: operates on Uint8Array greyscale buffers. No Canvas, no
+ * HTMLImageElement. The caller is responsible for rasterising / downscaling
+ * the image and converting to greyscale before calling these functions.
+ */
+import type { DocumentCropResult } from './types.js';
+/**
+ * Convert an RGBA pixel buffer to greyscale using fixed-point integer math.
+ * Uses ITU-R BT.601 approximate weights (77/150/29 out of 256).
+ *
+ * @param rgba  - RGBA pixel buffer (length = width * height * 4)
+ * @param pixelCount - Total number of pixels (width * height)
+ * @returns Uint8Array of greyscale values, one byte per pixel
+ */
+export declare function rgbaToGreyscale(rgba: Uint8ClampedArray | Uint8Array, pixelCount: number): Uint8Array;
+/**
+ * Convert an RGBA pixel buffer to greyscale using the pico.js weighting
+ * scheme (2/7/1 out of 10). Used for face-detection compatibility.
+ *
+ * @param rgba   - RGBA pixel buffer
+ * @param nrows  - Number of rows (height)
+ * @param ncols  - Number of columns (width)
+ * @returns Uint8Array of greyscale values
+ */
+export declare function rgbaToGreyscalePico(rgba: Uint8ClampedArray | Uint8Array, nrows: number, ncols: number): Uint8Array;
+/**
+ * Row and column Sobel edge energy profiles for a greyscale image.
+ */
+export interface EdgeEnergyProfile {
+    /** Per-row accumulated Sobel magnitude */
+    rowEnergy: Float32Array;
+    /** Per-column accumulated Sobel magnitude */
+    colEnergy: Float32Array;
+}
+/**
+ * Compute Sobel edge energy profiles (per-row and per-column) for a
+ * greyscale image buffer. Used for document boundary detection.
+ *
+ * @param grey - Greyscale pixel array (w * h, one byte per pixel)
+ * @param w    - Image width
+ * @param h    - Image height
+ */
+export declare function computeEdgeEnergyProfile(grey: Uint8Array, w: number, h: number): EdgeEnergyProfile;
+/**
+ * Detect the crop region of a document within a greyscale image using
+ * Sobel edge energy profiling. Returns the crop rectangle in the original
+ * (pre-scale) coordinate space.
+ *
+ * This is the DOM-free algorithmic core of `detectDocumentCrop()`. The caller
+ * must handle image loading, downscaling, and greyscale conversion.
+ *
+ * @param grey          - Greyscale pixels of the downscaled analysis image
+ * @param analysisW     - Width of the analysis image
+ * @param analysisH     - Height of the analysis image
+ * @param originalW     - Width of the original (full-resolution) image
+ * @param originalH     - Height of the original (full-resolution) image
+ */
+export declare function detectDocumentCropFromGrey(grey: Uint8Array, analysisW: number, analysisH: number, originalW: number, originalH: number): DocumentCropResult;
+//# sourceMappingURL=sobel.d.ts.map

package/dist/esm/sobel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sobel.d.ts","sourceRoot":"","sources":["../../src/sobel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAY,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI/D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAOpG;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,GAAG,UAAU,EACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,UAAU,CAUZ;AAID;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,SAAS,EAAE,YAAY,CAAC;IACxB,6CAA6C;IAC7C,SAAS,EAAE,YAAY,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,iBAAiB,CA2BnB;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAwFpB"}

package/dist/esm/sobel.js

@@ -0,0 +1,173 @@
+/**
+ * Sobel edge detection on raw pixel data.
+ *
+ * DOM-free: operates on Uint8Array greyscale buffers. No Canvas, no
+ * HTMLImageElement. The caller is responsible for rasterising / downscaling
+ * the image and converting to greyscale before calling these functions.
+ */
+/* -- Greyscale conversion helpers ----------------------------------------- */
+/**
+ * Convert an RGBA pixel buffer to greyscale using fixed-point integer math.
+ * Uses ITU-R BT.601 approximate weights (77/150/29 out of 256).
+ *
+ * @param rgba  - RGBA pixel buffer (length = width * height * 4)
+ * @param pixelCount - Total number of pixels (width * height)
+ * @returns Uint8Array of greyscale values, one byte per pixel
+ */
+export function rgbaToGreyscale(rgba, pixelCount) {
+    const grey = new Uint8Array(pixelCount);
+    for (let i = 0; i < pixelCount; i++) {
+        const p = i * 4;
+        grey[i] = (rgba[p] * 77 + rgba[p + 1] * 150 + rgba[p + 2] * 29) >> 8;
+    }
+    return grey;
+}
+/**
+ * Convert an RGBA pixel buffer to greyscale using the pico.js weighting
+ * scheme (2/7/1 out of 10). Used for face-detection compatibility.
+ *
+ * @param rgba   - RGBA pixel buffer
+ * @param nrows  - Number of rows (height)
+ * @param ncols  - Number of columns (width)
+ * @returns Uint8Array of greyscale values
+ */
+export function rgbaToGreyscalePico(rgba, nrows, ncols) {
+    const gray = new Uint8Array(nrows * ncols);
+    for (let r = 0; r < nrows; ++r)
+        for (let c = 0; c < ncols; ++c)
+            gray[r * ncols + c] =
+                (2 * rgba[r * 4 * ncols + 4 * c + 0] +
+                    7 * rgba[r * 4 * ncols + 4 * c + 1] +
+                    1 * rgba[r * 4 * ncols + 4 * c + 2]) /
+                    10;
+    return gray;
+}
+/**
+ * Compute Sobel edge energy profiles (per-row and per-column) for a
+ * greyscale image buffer. Used for document boundary detection.
+ *
+ * @param grey - Greyscale pixel array (w * h, one byte per pixel)
+ * @param w    - Image width
+ * @param h    - Image height
+ */
+export function computeEdgeEnergyProfile(grey, w, h) {
+    const rowEnergy = new Float32Array(h);
+    const colEnergy = new Float32Array(w);
+    for (let y = 1; y < h - 1; y++) {
+        for (let x = 1; x < w - 1; x++) {
+            const gx = -grey[(y - 1) * w + (x - 1)] +
+                grey[(y - 1) * w + (x + 1)] -
+                2 * grey[y * w + (x - 1)] +
+                2 * grey[y * w + (x + 1)] -
+                grey[(y + 1) * w + (x - 1)] +
+                grey[(y + 1) * w + (x + 1)];
+            const gy = -grey[(y - 1) * w + (x - 1)] -
+                2 * grey[(y - 1) * w + x] -
+                grey[(y - 1) * w + (x + 1)] +
+                grey[(y + 1) * w + (x - 1)] +
+                2 * grey[(y + 1) * w + x] +
+                grey[(y + 1) * w + (x + 1)];
+            const mag = Math.abs(gx) + Math.abs(gy);
+            rowEnergy[y] += mag;
+            colEnergy[x] += mag;
+        }
+    }
+    return { rowEnergy, colEnergy };
+}
+/* -- Document crop detection ---------------------------------------------- */
+/**
+ * Detect the crop region of a document within a greyscale image using
+ * Sobel edge energy profiling. Returns the crop rectangle in the original
+ * (pre-scale) coordinate space.
+ *
+ * This is the DOM-free algorithmic core of `detectDocumentCrop()`. The caller
+ * must handle image loading, downscaling, and greyscale conversion.
+ *
+ * @param grey          - Greyscale pixels of the downscaled analysis image
+ * @param analysisW     - Width of the analysis image
+ * @param analysisH     - Height of the analysis image
+ * @param originalW     - Width of the original (full-resolution) image
+ * @param originalH     - Height of the original (full-resolution) image
+ */
+export function detectDocumentCropFromGrey(grey, analysisW, analysisH, originalW, originalH) {
+    try {
+        if (analysisW <= 0 || analysisH <= 0)
+            return { crop: null, cornersOk: null };
+        const sc = Math.min(originalW / analysisW, originalH / analysisH);
+        const { rowEnergy, colEnergy } = computeEdgeEnergyProfile(grey, analysisW, analysisH);
+        // Find max energy for normalisation
+        let maxR = 0, maxC = 0;
+        for (let y2 = 0; y2 < analysisH; y2++) {
+            if (rowEnergy[y2] > maxR)
+                maxR = rowEnergy[y2];
+        }
+        for (let x2 = 0; x2 < analysisW; x2++) {
+            if (colEnergy[x2] > maxC)
+                maxC = colEnergy[x2];
+        }
+        if (maxR === 0 || maxC === 0)
+            return { crop: null, cornersOk: false };
+        // Scan inward from edges to find first row/col with >12% of max energy
+        const thr = 0.12;
+        const skip = 0.05;
+        let top = 0, bot = analysisH - 1, left = 0, right = analysisW - 1;
+        for (let yt = Math.round(analysisH * skip); yt < analysisH / 2; yt++) {
+            if (rowEnergy[yt] / maxR > thr) {
+                top = yt;
+                break;
+            }
+        }
+        for (let yb = Math.round(analysisH * (1 - skip)); yb > analysisH / 2; yb--) {
+            if (rowEnergy[yb] / maxR > thr) {
+                bot = yb;
+                break;
+            }
+        }
+        for (let xl = Math.round(analysisW * skip); xl < analysisW / 2; xl++) {
+            if (colEnergy[xl] / maxC > thr) {
+                left = xl;
+                break;
+            }
+        }
+        for (let xr = Math.round(analysisW * (1 - skip)); xr > analysisW / 2; xr--) {
+            if (colEnergy[xr] / maxC > thr) {
+                right = xr;
+                break;
+            }
+        }
+        const cw = right - left;
+        const ch = bot - top;
+        const edgeMargin = Math.round(Math.min(analysisW, analysisH) * 0.08);
+        if (cw < analysisW * 0.25 || ch < analysisH * 0.25)
+            return { crop: null, cornersOk: false };
+        if (cw > analysisW * 0.88 && ch > analysisH * 0.88)
+            return { crop: null, cornersOk: false };
+        const rawLeft = left;
+        const rawTop = top;
+        const rawRight = right;
+        const rawBot = bot;
+        // 3% padding
+        const pad = Math.round(Math.min(analysisW, analysisH) * 0.03);
+        left = Math.max(0, left - pad);
+        top = Math.max(0, top - pad);
+        right = Math.min(analysisW - 1, right + pad);
+        bot = Math.min(analysisH - 1, bot + pad);
+        const cornersConfident = rawLeft > edgeMargin &&
+            rawTop > edgeMargin &&
+            rawRight < analysisW - 1 - edgeMargin &&
+            rawBot < analysisH - 1 - edgeMargin;
+        return {
+            crop: {
+                x: Math.round(left * sc),
+                y: Math.round(top * sc),
+                w: Math.round((right - left) * sc),
+                h: Math.round((bot - top) * sc),
+            },
+            cornersOk: cornersConfident,
+        };
+    }
+    catch {
+        return { crop: null, cornersOk: null };
+    }
+}
+//# sourceMappingURL=sobel.js.map

package/dist/esm/sobel.js.map

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