@mikashboks/capture-intelligence-core 0.1.0

package/dist/esm/document-classifier.js

@@ -0,0 +1,209 @@
+/**
+ * Document likelihood classifier -- 5-signal Bayesian heuristic.
+ *
+ * DOM-free: operates on raw greyscale (Uint8Array) and RGBA (Uint8ClampedArray)
+ * pixel data. No Canvas, no HTMLImageElement.
+ */
+/* -- Document type normaliser (mirrors host normalizeDocType) ------------- */
+function normalizeDocType(docType) {
+    if (!docType)
+        return null;
+    const raw = String(docType).trim().toLowerCase().replace(/[\s-]+/g, '_');
+    switch (raw) {
+        case 'national_id':
+        case 'sierraleone_national_id':
+            return 'id_card';
+        case 'sierraleone_voter_id':
+        case 'voter':
+            return 'voter_id';
+        case 'driver_license':
+        case 'driver_licence':
+        case 'drivers_licence':
+        case 'sierraleone_driver_license':
+        case 'sierraleone_drivers_license':
+            return 'drivers_license';
+        case 'sierraleone_passport':
+            return 'passport';
+        default:
+            return raw;
+    }
+}
+/* -- Per-document-type aspect ratio profiles ------------------------------ */
+export function getDocumentReviewProfile(documentType) {
+    const normalizedType = normalizeDocType(documentType);
+    // Passports -- biodata page is taller (~1.42:1 or portrait)
+    if (normalizedType === 'passport') {
+        return {
+            aspectTargets: [1.42],
+            threshold: 58,
+            expectedOrientation: 'portrait',
+        };
+    }
+    // ID card, voter ID, driver's licence -- standard card-shaped documents
+    if (normalizedType === 'id_card' ||
+        normalizedType === 'voter_id' ||
+        normalizedType === 'voter_card' ||
+        normalizedType === 'drivers_license' ||
+        normalizedType === 'driving_license' ||
+        normalizedType === 'driving_licence') {
+        return {
+            aspectTargets: [1.585],
+            threshold: 62,
+            expectedOrientation: 'landscape',
+        };
+    }
+    // Address proof / utility bills -- A4/letter shaped documents
+    if (normalizedType === 'address_proof' ||
+        normalizedType === 'utility_bill' ||
+        normalizedType === 'proof_of_address' ||
+        normalizedType === 'bank_statement') {
+        return {
+            aspectTargets: [1.414, 1.294],
+            threshold: 55,
+            expectedOrientation: 'either',
+        };
+    }
+    return {
+        aspectTargets: [1.585, 1.42],
+        threshold: 60,
+        expectedOrientation: 'either',
+    };
+}
+/* -- 5-signal document likelihood classifier ------------------------------ */
+/**
+ * Determine whether a greyscale + RGBA image looks like a document.
+ *
+ * @param grey      - Greyscale pixel array (w * h, one byte per pixel)
+ * @param imgData   - RGBA pixel array (w * h * 4 bytes)
+ * @param w         - Image width in pixels
+ * @param h         - Image height in pixels
+ * @param documentType - Optional document type hint for aspect-ratio matching
+ */
+export function checkDocumentLikelihood(grey, imgData, w, h, documentType) {
+    const reviewProfile = getDocumentReviewProfile(documentType);
+    let score = 0;
+    // Single-pass Sobel: build edge map AND track gradient direction for
+    // horizontal-edge-dominance (text signature) detection.
+    const totalPixels = (w - 2) * (h - 2);
+    const edgeMap = new Uint8Array(w * h);
+    let edgePixels = 0;
+    let hEdgeSum = 0;
+    let vEdgeSum = 0;
+    for (let ey = 1; ey < h - 1; ey++) {
+        for (let ex = 1; ex < w - 1; ex++) {
+            const gx = -grey[(ey - 1) * w + (ex - 1)] +
+                grey[(ey - 1) * w + (ex + 1)] -
+                2 * grey[ey * w + (ex - 1)] +
+                2 * grey[ey * w + (ex + 1)] -
+                grey[(ey + 1) * w + (ex - 1)] +
+                grey[(ey + 1) * w + (ex + 1)];
+            const gy = -grey[(ey - 1) * w + (ex - 1)] -
+                2 * grey[(ey - 1) * w + ex] -
+                grey[(ey - 1) * w + (ex + 1)] +
+                grey[(ey + 1) * w + (ex - 1)] +
+                2 * grey[(ey + 1) * w + ex] +
+                grey[(ey + 1) * w + (ex + 1)];
+            const mag = Math.sqrt(gx * gx + gy * gy);
+            if (mag > 30) {
+                edgeMap[ey * w + ex] = 1;
+                edgePixels++;
+            }
+            hEdgeSum += Math.abs(gy);
+            vEdgeSum += Math.abs(gx);
+        }
+    }
+    // 1. Edge density (widened for worn/faded Sierra Leone national IDs)
+    const edgeDensity = totalPixels > 0 ? edgePixels / totalPixels : 0;
+    if (edgeDensity >= 0.05 && edgeDensity <= 0.22)
+        score += 25;
+    else if (edgeDensity >= 0.03 && edgeDensity <= 0.28)
+        score += 10;
+    // E10: Widened penalty threshold -- textured SL surfaces inflate edge density
+    else if (edgeDensity > 0.3)
+        score -= 10;
+    // 2. Aspect ratio -- match against the nearest supported document profile
+    const aspect = w > h ? w / h : h / w;
+    let bestAspectDiff = Number.POSITIVE_INFINITY;
+    for (let aspectIdx = 0; aspectIdx < reviewProfile.aspectTargets.length; aspectIdx++) {
+        bestAspectDiff = Math.min(bestAspectDiff, Math.abs(aspect - reviewProfile.aspectTargets[aspectIdx]));
+    }
+    if (bestAspectDiff < 0.1)
+        score += 25;
+    else if (bestAspectDiff < 0.25)
+        score += 15;
+    else if (bestAspectDiff < 0.45)
+        score += 5;
+    // 3. Color channel variance
+    let rSum = 0, gSum = 0, bSum = 0;
+    let rSq = 0, gSq = 0, bSq = 0;
+    const px = imgData.length / 4;
+    for (let ci = 0; ci < imgData.length; ci += 4) {
+        rSum += imgData[ci];
+        gSum += imgData[ci + 1];
+        bSum += imgData[ci + 2];
+        rSq += imgData[ci] * imgData[ci];
+        gSq += imgData[ci + 1] * imgData[ci + 1];
+        bSq += imgData[ci + 2] * imgData[ci + 2];
+    }
+    const rVar = rSq / px - (rSum / px) * (rSum / px);
+    const gVar = gSq / px - (gSum / px) * (gSum / px);
+    const bVar = bSq / px - (bSum / px) * (bSum / px);
+    const avgVar = (rVar + gVar + bVar) / 3;
+    if (avgVar >= 400 && avgVar <= 4000)
+        score += 20;
+    else if (avgVar >= 200 && avgVar <= 5500)
+        score += 10;
+    // E11: Removed penalty for low color variance -- faded/BW SL documents are legitimate
+    // 4. Rectangular structure -- center 3x3 grid edge density + glare detection
+    const gridW = Math.floor(w / 3);
+    const gridH = Math.floor(h / 3);
+    let centerEdges = 0, centerTotal = 0;
+    let maxBrightness = 0;
+    for (let ry = 1; ry < h - 1; ry++) {
+        const rowZone = ry < gridH ? 0 : ry >= gridH * 2 ? 2 : 1;
+        if (rowZone !== 1)
+            continue;
+        for (let rx = 1; rx < w - 1; rx++) {
+            const colZone = rx < gridW ? 0 : rx >= gridW * 2 ? 2 : 1;
+            if (colZone !== 1)
+                continue;
+            centerEdges += edgeMap[ry * w + rx];
+            centerTotal++;
+            // Track max brightness in center region for glare detection
+            const pixBrightness = grey[ry * w + rx];
+            if (pixBrightness > maxBrightness)
+                maxBrightness = pixBrightness;
+        }
+    }
+    const centerDensity = centerTotal > 0 ? centerEdges / centerTotal : 0;
+    const hasGlare = maxBrightness > 245;
+    if (centerDensity >= 0.06 && centerDensity <= 0.2)
+        score += 15;
+    else if (centerDensity >= 0.03 && centerDensity <= 0.18)
+        score += 5;
+    else if (centerDensity > 0.2)
+        score -= 10;
+    // 5. Horizontal-edge dominance (text signature)
+    const edgeTotal = hEdgeSum + vEdgeSum;
+    if (edgeTotal > 0) {
+        const hRatio = hEdgeSum / edgeTotal;
+        if (hRatio >= 0.56)
+            score += 15;
+        else if (hRatio >= 0.52)
+            score += 5;
+        else if (hRatio < 0.46)
+            score -= 10;
+    }
+    // Rescue path: if aspect ratio matches strongly and some edges exist,
+    // set a minimum score -- handles clearly card-shaped objects that are too
+    // faded to score well on texture (worn Sierra Leone national IDs).
+    if (bestAspectDiff < 0.1 && edgeDensity > 0.03 && score < 15) {
+        score = 15;
+    }
+    return {
+        isLikelyDoc: score >= reviewProfile.threshold,
+        confidence: score,
+        glareDetected: hasGlare,
+    };
+}
+//# sourceMappingURL=document-classifier.js.map

package/dist/esm/document-classifier.js.map

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

package/dist/esm/flow-routing.d.ts

@@ -0,0 +1,7 @@
+export interface FlowStepDefinition {
+    id: string;
+    type?: string | null;
+}
+export declare function getNextFlowStepId(steps: FlowStepDefinition[], currentStepId: string, skipType?: string): string | undefined;
+export declare function getPreviousFlowStepId(steps: FlowStepDefinition[], currentStepId: string, skipType?: string): string | undefined;
+//# sourceMappingURL=flow-routing.d.ts.map

package/dist/esm/flow-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-routing.d.ts","sourceRoot":"","sources":["../../src/flow-routing.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAoCD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EAAE,EAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAcpB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EAAE,EAC3B,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAcpB"}

package/dist/esm/flow-routing.js

@@ -0,0 +1,41 @@
+function filterFlowStepsByType(steps, skipType) {
+    if (!skipType) {
+        return steps;
+    }
+    return steps.filter(step => step.type !== skipType);
+}
+function findCompatibleStepId(steps, fromIndex, direction, skipType) {
+    for (let stepIndex = fromIndex + direction; stepIndex >= 0 && stepIndex < steps.length; stepIndex += direction) {
+        const step = steps[stepIndex];
+        if (!step || (skipType && step.type === skipType)) {
+            continue;
+        }
+        return step.id;
+    }
+    return undefined;
+}
+export function getNextFlowStepId(steps, currentStepId, skipType) {
+    const filteredSteps = filterFlowStepsByType(steps, skipType);
+    const filteredIndex = filteredSteps.findIndex(step => step.id === currentStepId);
+    if (filteredIndex === -1 && skipType) {
+        const sourceIndex = steps.findIndex(step => step.id === currentStepId);
+        return sourceIndex === -1 ? undefined : findCompatibleStepId(steps, sourceIndex, 1, skipType);
+    }
+    if (filteredIndex === -1) {
+        return undefined;
+    }
+    return filteredSteps[filteredIndex + 1]?.id;
+}
+export function getPreviousFlowStepId(steps, currentStepId, skipType) {
+    const filteredSteps = filterFlowStepsByType(steps, skipType);
+    const filteredIndex = filteredSteps.findIndex(step => step.id === currentStepId);
+    if (filteredIndex === -1 && skipType) {
+        const sourceIndex = steps.findIndex(step => step.id === currentStepId);
+        return sourceIndex === -1 ? undefined : findCompatibleStepId(steps, sourceIndex, -1, skipType);
+    }
+    if (filteredIndex <= 0) {
+        return undefined;
+    }
+    return filteredSteps[filteredIndex - 1]?.id;
+}
+//# sourceMappingURL=flow-routing.js.map

package/dist/esm/flow-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-routing.js","sourceRoot":"","sources":["../../src/flow-routing.ts"],"names":[],"mappings":"AAKA,SAAS,qBAAqB,CAC5B,KAA2B,EAC3B,QAAiB;IAEjB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA2B,EAC3B,SAAiB,EACjB,SAAiB,EACjB,QAAiB;IAEjB,KACE,IAAI,SAAS,GAAG,SAAS,GAAG,SAAS,EACrC,SAAS,IAAI,CAAC,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,EAC1C,SAAS,IAAI,SAAS,EACtB,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QAE9B,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YAClD,SAAS;QACX,CAAC;QAED,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAA2B,EAC3B,aAAqB,EACrB,QAAiB;IAEjB,MAAM,aAAa,GAAG,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;IAEjF,IAAI,aAAa,KAAK,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;QACvE,OAAO,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAChG,CAAC;IAED,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,aAAa,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAA2B,EAC3B,aAAqB,EACrB,QAAiB;IAEjB,MAAM,aAAa,GAAG,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;IAEjF,IAAI,aAAa,KAAK,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC;QACvE,OAAO,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,aAAa,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;AAC9C,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @mikashboks/capture-intelligence-core
+ *
+ * DOM-free algorithmic core for capture intelligence: document classification,
+ * Sobel edge detection, frame metrics computation, and quality checks.
+ *
+ * All exports operate on raw data (Uint8Array pixel arrays, FrameMetrics
+ * objects, numeric values). Zero browser dependencies.
+ */
+export type { CamStateValue, FrameMetrics, DocumentReviewProfile, DocumentLikelihoodResult, CropRect, DocumentCropResult, OverlayRegion, OverlayVariant, QualityCheckResults, FaceBoundingBox, DetectedFace, MetadataReviewIssue, MetadataReviewResult, ReviewOrientation, ReviewMode, QualityBucket, ReviewDecisionOptions, } from './types.js';
+export { CamState, CAM_ANALYSIS_W, CAM_ANALYSIS_H, CAM_BRIGHTNESS_MIN, CAM_BRIGHTNESS_MAX, CAM_BLUR_THRESHOLD, CAM_EDGE_THRESHOLD, CAM_STABLE_FRAMES_NEEDED, CAM_FRAME_DIFF_THRESHOLD, CAM_EDGE_PIXEL_THRESHOLD, CAM_EDGE_COVERAGE_THRESHOLD, CAM_DOC_CENTER_OFFSET_MAX, DOC_GALLERY_FAILURE_THRESHOLD, DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD, SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD, ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD, PICO_ANALYSIS_W, PICO_ANALYSIS_H, } from './types.js';
+export type { AddressMethod, AddressProofMode, AddressCoordinatesLike, AddressStepState, AddressMethodStartBehavior, } from './address-proof.js';
+export { ADDRESS_METHOD_ORDER, isAddressMethod, sanitizeAllowedAddressMethods, getRecommendedAddressMethod, getAddressMethodStartBehavior, getEffectiveAddressMethod, hasAddressProofCoordinates, hasStructuredAddress, isAddressStepComplete, } from './address-proof.js';
+export type { FlowStepDefinition } from './flow-routing.js';
+export { getNextFlowStepId, getPreviousFlowStepId } from './flow-routing.js';
+export { getDocumentReviewProfile, checkDocumentLikelihood, } from './document-classifier.js';
+export type { MetadataReviewInput } from './metadata-review.js';
+export { analyzeImageMetadata } from './metadata-review.js';
+export type { EdgeEnergyProfile } from './sobel.js';
+export { rgbaToGreyscale, rgbaToGreyscalePico, computeEdgeEnergyProfile, detectDocumentCropFromGrey, } from './sobel.js';
+export type { EdgeAnalysisResult } from './metrics.js';
+export { rgbaToGreyInPlace, computeBrightness, computeLaplacianVariance, computeLaplacianVarianceFloat, computeEdgeEnergy, detectDocumentRect, computeFrameDiff, analyzeFrame, looksLikeDocument, } from './metrics.js';
+export type { QualityFailureState, DocumentQualityInput, DocumentQualityResult, SelfieQualityInput, } from './quality-checks.js';
+export { getQualityBucket, getSubmitAnywayThreshold, createQualityFailureState, countFailedReview, shouldShowSubmitAnyway, runDocumentQualityChecks, runSelfieQualityChecks, checkFaceInImage, isFaceCentered, evaluateDocumentFailure, evaluateSelfieFailure, evaluateReviewFailure, getNextButtonDisabledReason, getOverrideButtonText, getOverrideBannerMessage, } from './quality-checks.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,wBAAwB,EACxB,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACnC,sCAAsC,EACtC,uCAAuC,EACvC,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,19 @@
+/**
+ * @mikashboks/capture-intelligence-core
+ *
+ * DOM-free algorithmic core for capture intelligence: document classification,
+ * Sobel edge detection, frame metrics computation, and quality checks.
+ *
+ * All exports operate on raw data (Uint8Array pixel arrays, FrameMetrics
+ * objects, numeric values). Zero browser dependencies.
+ */
+export { CamState, CAM_ANALYSIS_W, CAM_ANALYSIS_H, CAM_BRIGHTNESS_MIN, CAM_BRIGHTNESS_MAX, CAM_BLUR_THRESHOLD, CAM_EDGE_THRESHOLD, CAM_STABLE_FRAMES_NEEDED, CAM_FRAME_DIFF_THRESHOLD, CAM_EDGE_PIXEL_THRESHOLD, CAM_EDGE_COVERAGE_THRESHOLD, CAM_DOC_CENTER_OFFSET_MAX, DOC_GALLERY_FAILURE_THRESHOLD, DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD, SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD, ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD, PICO_ANALYSIS_W, PICO_ANALYSIS_H, } from './types.js';
+export { ADDRESS_METHOD_ORDER, isAddressMethod, sanitizeAllowedAddressMethods, getRecommendedAddressMethod, getAddressMethodStartBehavior, getEffectiveAddressMethod, hasAddressProofCoordinates, hasStructuredAddress, isAddressStepComplete, } from './address-proof.js';
+export { getNextFlowStepId, getPreviousFlowStepId } from './flow-routing.js';
+/* -- Document classifier -------------------------------------------------- */
+export { getDocumentReviewProfile, checkDocumentLikelihood, } from './document-classifier.js';
+export { analyzeImageMetadata } from './metadata-review.js';
+export { rgbaToGreyscale, rgbaToGreyscalePico, computeEdgeEnergyProfile, detectDocumentCropFromGrey, } from './sobel.js';
+export { rgbaToGreyInPlace, computeBrightness, computeLaplacianVariance, computeLaplacianVarianceFloat, computeEdgeEnergy, detectDocumentRect, computeFrameDiff, analyzeFrame, looksLikeDocument, } from './metrics.js';
+export { getQualityBucket, getSubmitAnywayThreshold, createQualityFailureState, countFailedReview, shouldShowSubmitAnyway, runDocumentQualityChecks, runSelfieQualityChecks, checkFaceInImage, isFaceCentered, evaluateDocumentFailure, evaluateSelfieFailure, evaluateReviewFailure, getNextButtonDisabledReason, getOverrideButtonText, getOverrideBannerMessage, } from './quality-checks.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH,OAAO,EACL,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACnC,sCAAsC,EACtC,uCAAuC,EACvC,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAUpB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,+EAA+E;AAC/E,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAI5D,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAStB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC"}

package/dist/esm/metadata-review.d.ts

@@ -0,0 +1,10 @@
+import type { MetadataReviewResult } from './types.js';
+export interface MetadataReviewInput {
+    type: 'document' | 'selfie';
+    width: number;
+    height: number;
+    fileSize?: number | null;
+    documentType?: string | null;
+}
+export declare function analyzeImageMetadata(input: MetadataReviewInput): MetadataReviewResult;
+//# sourceMappingURL=metadata-review.d.ts.map

package/dist/esm/metadata-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-review.d.ts","sourceRoot":"","sources":["../../src/metadata-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AA4BD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,oBAAoB,CAoFrF"}

package/dist/esm/metadata-review.js

@@ -0,0 +1,90 @@
+import { getDocumentReviewProfile } from './document-classifier.js';
+const MIN_WIDTH = 200;
+const MIN_HEIGHT = 150;
+const COMPRESSION_WARNING_MIN_PIXELS = 640 * 480;
+const LOW_DETAIL_BYTES_PER_PIXEL = 0.04;
+function getOrientation(width, height) {
+    const ratio = width / Math.max(1, height);
+    if (ratio > 1.08)
+        return 'landscape';
+    if (ratio < 0.92)
+        return 'portrait';
+    return 'square';
+}
+function buildResult(type, orientation, issues, isDocument = type === 'document') {
+    return {
+        passed: issues.every(issue => issue.severity !== 'error'),
+        issues,
+        orientation,
+        isDocument,
+    };
+}
+export function analyzeImageMetadata(input) {
+    const orientation = getOrientation(input.width, input.height);
+    const issues = [];
+    if (input.width < MIN_WIDTH || input.height < MIN_HEIGHT) {
+        issues.push({
+            key: 'too_small',
+            message: 'Image is too small. Please take a new photo.',
+            severity: 'error',
+        });
+        return buildResult(input.type, orientation, issues, false);
+    }
+    if (input.type === 'document') {
+        const reviewProfile = getDocumentReviewProfile(input.documentType);
+        const normalizedAspect = input.width > input.height
+            ? input.width / input.height
+            : input.height / input.width;
+        const bestAspectDiff = Math.min(...reviewProfile.aspectTargets.map(target => Math.abs(normalizedAspect - target)));
+        if (bestAspectDiff > 0.33) {
+            issues.push({
+                key: 'bad_aspect',
+                message: "This doesn't match the selected document shape. Retake with the full document visible.",
+                severity: 'error',
+            });
+        }
+        else if (bestAspectDiff > 0.2) {
+            issues.push({
+                key: 'document_shape_warning',
+                message: 'Make sure the full document is visible and not tilted too much.',
+                severity: 'warning',
+            });
+        }
+        if (reviewProfile.expectedOrientation === 'landscape' &&
+            orientation === 'portrait') {
+            issues.push({
+                key: 'document_rotated',
+                message: 'Rotate the document so it is wider than it is tall.',
+                severity: 'warning',
+            });
+        }
+        if (reviewProfile.expectedOrientation === 'portrait' &&
+            orientation === 'landscape') {
+            issues.push({
+                key: 'document_rotated',
+                message: 'Rotate the document so the page is upright before retaking.',
+                severity: 'warning',
+            });
+        }
+    }
+    else if (orientation === 'landscape') {
+        issues.push({
+            key: 'selfie_landscape',
+            message: 'Use portrait orientation so the full face and shoulders fit in frame.',
+            severity: 'warning',
+        });
+    }
+    if (input.fileSize &&
+        input.width * input.height >= COMPRESSION_WARNING_MIN_PIXELS &&
+        input.fileSize / (input.width * input.height) < LOW_DETAIL_BYTES_PER_PIXEL) {
+        issues.push({
+            key: 'low_detail',
+            message: 'Photo looks heavily compressed. Retake it without zooming or screenshots.',
+            severity: 'warning',
+        });
+    }
+    const isDocument = input.type === 'document' &&
+        !issues.some(issue => issue.key === 'bad_aspect');
+    return buildResult(input.type, orientation, issues, isDocument);
+}
+//# sourceMappingURL=metadata-review.js.map

package/dist/esm/metadata-review.js.map

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

package/dist/esm/metrics.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Frame metrics computation on raw pixel arrays.
+ *
+ * DOM-free: all functions accept Uint8Array / numeric data. No
+ * HTMLVideoElement, HTMLCanvasElement, or any browser API.
+ *
+ * The caller is responsible for capturing pixel data from the video/camera
+ * source and providing the overlay region. This module computes brightness,
+ * blur (Laplacian variance), edge energy, frame-to-frame stability, and
+ * document rectangle detection.
+ */
+import type { FrameMetrics, OverlayRegion, OverlayVariant } from './types.js';
+/**
+ * Convert an RGBA pixel buffer to greyscale in-place into a pre-allocated
+ * output array. Uses fixed-point ITU-R BT.601 weights.
+ *
+ * @param rgba       - RGBA pixel buffer (length = pixelCount * 4)
+ * @param out        - Pre-allocated Uint8Array to write greyscale values into
+ * @param pixelCount - Total pixel count (width * height)
+ */
+export declare function rgbaToGreyInPlace(rgba: Uint8ClampedArray | Uint8Array, out: Uint8Array, pixelCount: number): void;
+/**
+ * Compute average brightness within a rectangular sub-region of a greyscale
+ * image. The region is defined as fractional overlay coordinates [0..1].
+ *
+ * @param grey    - Greyscale pixel array
+ * @param w       - Image width
+ * @param h       - Image height
+ * @param region  - Overlay region in fractional coordinates
+ */
+export declare function computeBrightness(grey: Uint8Array, w: number, h: number, region: OverlayRegion): number;
+/**
+ * Compute Laplacian variance for sharpness detection.
+ * Higher values indicate sharper images.
+ *
+ * @param grey - Greyscale pixel array
+ * @param w    - Image width
+ * @param h    - Image height
+ */
+export declare function computeLaplacianVariance(grey: Uint8Array, w: number, h: number): number;
+/**
+ * Compute Laplacian variance using floating-point greyscale values.
+ * Used for static image quality checks where Float32Array precision is
+ * preferred.
+ *
+ * @param grey - Floating-point greyscale pixel array
+ * @param w    - Image width
+ * @param h    - Image height
+ */
+export declare function computeLaplacianVarianceFloat(grey: Float32Array, w: number, h: number): number;
+/**
+ * Result of edge energy analysis in a sub-region.
+ */
+export interface EdgeAnalysisResult {
+    /** Average edge magnitude in the region */
+    avgEdge: number;
+    /** Fraction of pixels with edge magnitude above CAM_EDGE_PIXEL_THRESHOLD */
+    edgeCoverage: number;
+    /** Per-row accumulated Sobel magnitude (relative to region) */
+    rowEnergy: Float32Array;
+    /** Per-column accumulated Sobel magnitude (relative to region) */
+    colEnergy: Float32Array;
+    /** Width of the analysis region */
+    regionW: number;
+    /** Height of the analysis region */
+    regionH: number;
+}
+/**
+ * Compute Sobel edge energy within an overlay sub-region of a greyscale image.
+ *
+ * @param grey    - Greyscale pixel array
+ * @param w       - Full image width
+ * @param h       - Full image height
+ * @param region  - Overlay region in fractional coordinates
+ */
+export declare function computeEdgeEnergy(grey: Uint8Array, w: number, h: number, region: OverlayRegion): EdgeAnalysisResult;
+/**
+ * Detect a document rectangle within edge energy profiles.
+ *
+ * @returns Area ratio, aspect ratio, and center offset of the detected region.
+ */
+export declare function detectDocumentRect(rowEnergy: Float32Array, colEnergy: Float32Array, regionW: number, regionH: number): {
+    docAreaRatio: number;
+    docAspectRatio: number;
+    docCenterOffset: number;
+};
+/**
+ * Compute mean absolute difference between two greyscale frames.
+ * Returns 999 if no previous frame is available.
+ *
+ * @param current  - Current greyscale frame
+ * @param previous - Previous greyscale frame (or null if first frame)
+ */
+export declare function computeFrameDiff(current: Uint8Array, previous: Uint8Array | null): number;
+/**
+ * Compute all frame metrics from a greyscale image and an overlay region.
+ * This is the DOM-free equivalent of `camAnalyzeFrame()`.
+ *
+ * @param grey            - Greyscale pixel array (w * h bytes)
+ * @param w               - Image width
+ * @param h               - Image height
+ * @param region          - Overlay region in fractional coordinates
+ * @param prevGreyData    - Previous frame's greyscale data (for stability), or null
+ * @returns FrameMetrics for the frame
+ */
+export declare function analyzeFrame(grey: Uint8Array, w: number, h: number, region: OverlayRegion, prevGreyData: Uint8Array | null): FrameMetrics;
+/**
+ * Check whether frame metrics indicate a document-like shape for the given
+ * overlay variant. DOM-free: the overlay variant is passed as a value.
+ *
+ * @param metrics  - Computed frame metrics
+ * @param variant  - Overlay variant ('card', 'passport', or 'a4')
+ */
+export declare function looksLikeDocument(metrics: FrameMetrics, variant: OverlayVariant): boolean;
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAS9E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,GAAG,UAAU,EACpC,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,MAAM,GACjB,IAAI,CAKN;AAID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,aAAa,GACpB,MAAM,CAcR;AAID;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB9F;AAID;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,SAAS,EAAE,YAAY,CAAC;IACxB,kEAAkE;IAClE,SAAS,EAAE,YAAY,CAAC;IACxB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,aAAa,GACpB,kBAAkB,CAiDpB;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CA0D3E;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAOzF;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,UAAU,GAAG,IAAI,GAC9B,YAAY,CA+Bd;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAoBzF"}