@sssxyd/face-liveness-detector 0.4.0-alpha.9 → 0.4.1-beta.1

package/dist/types/browser_utils.d.ts

@@ -2,10 +2,10 @@
  * 将绘制图片的canvas转换为mat
  * @param {any} cv OpenCV实例
  * @param {HTMLCanvasElement} canvas canvas元素
- * @param {boolean} gray 是否转换为灰度图像
- * @returns {any | null} - 转换后的Mat对象，如果转换失败则返回null
+ * @param {any} dstMat 目标Mat对象，将canvas数据写入此Mat
+ * @returns {any | null} - 返回传入的Mat对象，如果转换失败则返回null
  */
-export declare function drawCanvasToMat(cv: any, canvas: HTMLCanvasElement, gray: boolean): any | null;
+export declare function drawCanvasToMat(cv: any, canvas: HTMLCanvasElement, dstMat: any): any | null;
 export declare function matToGray(cv: any, mat: any): any | null;
 /**
  * Convert OpenCV Mat to Base64 JPEG image

package/dist/types/browser_utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser_utils.d.ts","sourceRoot":"","sources":["../../src/browser_utils.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,GAAG,GAAG,GAAG,IAAI,CAiB7F;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAWvD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,GAAG,IAAI,CA6BvF"}
+{"version":3,"file":"browser_utils.d.ts","sourceRoot":"","sources":["../../src/browser_utils.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAsB3F;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAWvD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAE,MAAY,GAAG,MAAM,GAAG,IAAI,CA6BvF"}

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AA8EhF;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC/C,qBAAqB,CAwBvB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAiDhF;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC/C,qBAAqB,CAwBvB"}

package/dist/types/dlp-color-wheel-detector.d.ts

@@ -0,0 +1,76 @@
+/**
+ * DLP色轮检测器 - 检测DLP投影仪的特有伪影
+ *
+ * 核心原理：
+ * - DLP投影仪使用单色DMD芯片 + RGB色轮
+ * - 色轮以高频率（120-144Hz）轮换RGB颜色
+ * - 摄像头如果不同步捕捉，会看到RGB分离现象
+ *
+ * 特征：
+ * 1. 高对比度边界处出现"彩虹纹"（R左/B右分离）
+ * 2. 快速移动物体边缘有明显的RGB分离
+ * 3. 静止物体通常正常（因为色轮平均后是白色）
+ *
+ * 检测方法：
+ * 1. 找高对比度边界区域
+ * 2. 分析边界处R、G、B通道的位置差异
+ * 3. 如果R领先，B延后 → DLP特征
+ */
+import { VideoFrameCollector } from "./video-frame-collector";
+export interface DLPColorWheelDetectorConfig {
+    bufferSize: number;
+    edgeThreshold: number;
+    minChannelSeparationPixels: number;
+    separationConfidenceThreshold: number;
+    samplingStride: number;
+}
+export interface DLPColorWheelDetectionResult {
+    isScreenCapture: boolean;
+    confidence: number;
+    hasColorSeparation: boolean;
+    colorSeparationPixels: number;
+    redLeadPixels?: number;
+    blueDelayPixels?: number;
+    sampledEdgePixelCount: number;
+    estimatedColorWheelFrequency?: number;
+    details?: {
+        edgeLocations: number[];
+        separationDistances: number[];
+    };
+}
+export declare class DLPColorWheelDetector {
+    private config;
+    private frameCollector;
+    constructor(frameCollector: VideoFrameCollector, config: DLPColorWheelDetectorConfig);
+    /**
+     * 获取当前缓冲区中的帧数
+     */
+    getBufferedFrameCount(): number;
+    /**
+     * 执行DLP色轮检测分析
+     */
+    analyze(): DLPColorWheelDetectionResult;
+    /**
+     * 重置检测器
+     * 注意：帧缓冲由 FrameCollector 管理
+     */
+    reset(): void;
+    /**
+     * 检测高对比度边界
+     * 返回边界的x坐标位置
+     */
+    private detectHighContrastEdges;
+    /**
+     * 分析单条边界的RGB分离
+     *
+     * DLP特征：
+     * - R通道的边界比G靠前（向左）
+     * - B通道的边界比G靠后（向右）
+     */
+    private analyzeRGBSeparation;
+    /**
+     * 找导数数组中的峰值位置
+     */
+    private findPeakPosition;
+}
+//# sourceMappingURL=dlp-color-wheel-detector.d.ts.map

package/dist/types/dlp-color-wheel-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlp-color-wheel-detector.d.ts","sourceRoot":"","sources":["../../src/dlp-color-wheel-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAE7D,MAAM,WAAW,2BAA2B;IAE1C,UAAU,EAAE,MAAM,CAAA;IAGlB,aAAa,EAAE,MAAM,CAAA;IAGrB,0BAA0B,EAAE,MAAM,CAAA;IAGlC,6BAA6B,EAAE,MAAM,CAAA;IAGrC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,OAAO,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAGlB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IAGxB,qBAAqB,EAAE,MAAM,CAAA;IAG7B,4BAA4B,CAAC,EAAE,MAAM,CAAA;IAErC,OAAO,CAAC,EAAE;QACR,aAAa,EAAE,MAAM,EAAE,CAAA;QACvB,mBAAmB,EAAE,MAAM,EAAE,CAAA;KAC9B,CAAA;CACF;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,cAAc,CAAqB;gBAE/B,cAAc,EAAE,mBAAmB,EAAE,MAAM,EAAE,2BAA2B;IAKpF;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,OAAO,IAAI,4BAA4B;IA8HvC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAyC/B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAgE5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/types/face-detection-engine.d.ts

@@ -14,15 +14,20 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     private cv;
     private human;
     private engineState;
+    private videoFPS;
+    private lastDebugLogTime;
+    private debugLogLevelPriority;
     private videoElement;
     private stream;
     private frameCanvasElement;
     private frameCanvasContext;
-    private faceCanvasElement;
-    private faceCanvasContext;
-    private detectionFrameId;
+    private animationFrameId;
     private actualVideoWidth;
     private actualVideoHeight;
+    private preallocatedBgrFrame;
+    private preallocatedGrayFrame;
+    private isDetectingFrameActive;
+    private frameIndex;
     private detectionState;
     /**
      * Constructor
@@ -41,6 +46,37 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     private getStackTrace;
     updateOptions(options?: Partial<FaceDetectionEngineOptions>): void;
     getEngineState(): EngineState;
+    /**
+     * Atomically transition engine state with validation
+     * Ensures state transitions follow the valid state machine
+     * @param newState - Target engine state
+     * @param context - Debug context for logging
+     * @returns true if transition succeeded, false otherwise
+     */
+    private transitionEngineState;
+    /**
+     * Check if state transition is valid according to state machine rules
+     * Valid transitions:
+     * - IDLE -> INITIALIZING, INITIALIZING -> READY, READY -> DETECTING, DETECTING -> READY
+     * - Any -> IDLE (error recovery)
+     */
+    private isValidStateTransition;
+    /**
+     * Transition detection period state
+     * @param newPeriod - Target detection period
+     * @returns true if transition succeeded
+     */
+    private transitionDetectionPeriod;
+    /**
+     * Partially reset detection state (keeps engine initialized)
+     * Used when detection fails but engine should remain ready
+     */
+    private partialResetDetectionState;
+    /**
+     * Fully reset detection state and resources
+     * Used when stopping detection or reinitializing
+     */
+    private fullResetDetectionState;
     /**
      * Initialize the detection engine
      * Loads Human.js and OpenCV.js libraries
@@ -60,6 +96,7 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     startDetection(videoElement: HTMLVideoElement): Promise<void>;
     /**
      * Stop face detection
+     * Performs comprehensive cleanup to prevent memory leaks and UI freezing
      * @param success - Whether to display the best collected image
      */
     stopDetection(success: boolean): void;
@@ -68,22 +105,26 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
      * @returns Current configuration
      */
     getOptions(): FaceDetectionEngineOptions;
-    /**
-     * Reset detection state
-     */
-    private resetDetectionState;
-    /**
-     * Schedule next detection frame
-     */
-    private scheduleNextDetection;
+    private updateVideoFPS;
     /**
      * Cancel pending detection frame
      */
     private cancelPendingDetection;
     /**
      * Main detection loop
+     * Called every frame via requestAnimationFrame
+     * Orchestrates the detection pipeline with clear separation of concerns
      */
     private detect;
+    /**
+     * Capture video frame and convert to BGR and Grayscale Mat objects
+     * @returns {Object | null} Object with bgrFrame and grayFrame, or null if failed
+     */
+    private captureAndPrepareFrames;
+    /**
+     * Perform main face detection and handle results
+     */
+    private performFaceDetection;
     private getPerformActionCount;
     /**
      * Handle single face detection
@@ -121,22 +162,20 @@ export declare class FaceDetectionEngine extends SimpleEventEmitter {
     private emitDebug;
     /**
      * Draw video frame to canvas (internal use, not converted to Base64)
+     * Handles potential runtime resolution changes from camera stream
      * @returns {HTMLCanvasElement | null} Canvas after drawing, returns null if failed
      */
     private drawVideoToCanvas;
     private clearFrameCanvas;
-    private clearFaceCanvas;
     /**
-     * 将 canvas 转换为 Base64 JPEG 图片数据
-     * @param {HTMLCanvasElement} canvas - 输入的 canvas
-     * @returns {string | null} Base64 格式的 JPEG 图片数据
+     * Ensure preallocated Mat objects exist with correct dimensions
+     * Creates both BGR and Gray Mat for reuse
      */
-    private canvasToBase64;
+    private ensurePreallocatedMats;
     /**
-     * Capture current video frame (returns Base64)
-     * @param {Box} box - Face box
-     * @returns {string | null} Base64 encoded JPEG image data
+     * Clear preallocated Mat objects
+     * Called when resolution changes or detection stops
      */
-    private captureFrame;
+    private clearPreallocatedMats;
 }
 //# sourceMappingURL=face-detection-engine.d.ts.map

package/dist/types/face-detection-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"face-detection-engine.d.ts","sourceRoot":"","sources":["../../src/face-detection-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAQ3B,MAAM,SAAS,CAAA;AAChB,OAAO,EAAmF,WAAW,EAAE,MAAM,SAAS,CAAA;AAEtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAwBpD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,OAAO,CAAC,OAAO,CAAuB;IAEtC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,KAAK,CAAqB;IAElC,OAAO,CAAC,WAAW,CAAgC;IAGnD,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,kBAAkB,CAAwC;IAClE,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,iBAAiB,CAAwC;IAEjE,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,iBAAiB,CAAY;IAErC,OAAO,CAAC,cAAc,CAAgB;IAEtC;;;OAGG;gBACS,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAMzD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;IASlE,cAAc,IAAI,WAAW;IAI7B;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkLjC;;;;;;;OAOG;IACG,cAAc,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoJnE;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IA8BrC;;;OAGG;IACH,UAAU,IAAI,0BAA0B;IAMxC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;YACW,MAAM;IA6DpB,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqPxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuCpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAgBjB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAwDzB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,eAAe;IAWvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CA+BrB"}
+{"version":3,"file":"face-detection-engine.d.ts","sourceRoot":"","sources":["../../src/face-detection-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,0BAA0B,EAQ3B,MAAM,SAAS,CAAA;AAChB,OAAO,EAAmF,WAAW,EAAE,MAAM,SAAS,CAAA;AAEtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAwBpD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,OAAO,CAAC,OAAO,CAAuB;IAEtC,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,KAAK,CAAqB;IAElC,OAAO,CAAC,WAAW,CAAgC;IAEnD,OAAO,CAAC,QAAQ,CAAa;IAG7B,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,qBAAqB,CAAyD;IAGtF,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,kBAAkB,CAAwC;IAElE,OAAO,CAAC,gBAAgB,CAAsB;IAE9C,OAAO,CAAC,gBAAgB,CAAY;IACpC,OAAO,CAAC,iBAAiB,CAAY;IAIrC,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,qBAAqB,CAAY;IAGzC,OAAO,CAAC,sBAAsB,CAAiB;IAG/C,OAAO,CAAC,UAAU,CAAY;IAI9B,OAAO,CAAC,cAAc,CAAgB;IAEtC;;;OAGG;gBACS,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAMzD;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;IAalE,cAAc,IAAI,WAAW;IAM7B;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAkB9B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAWlC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkKjC;;;;;;;OAOG;IACG,cAAc,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqKnE;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IA2FrC;;;OAGG;IACH,UAAU,IAAI,0BAA0B;IAMxC,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;OAIG;YACW,MAAM;IAoEpB;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAsD/B;;OAEG;YACW,oBAAoB;IAmClC,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyIxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+CzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,uBAAuB;IAoC/B,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuCpB;;OAEG;IACH,OAAO,CAAC,SAAS;IA4CjB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAsEzB,OAAO,CAAC,gBAAgB;IAqBxB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAuC9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CA2B9B"}

package/dist/types/face-detection-state.d.ts

@@ -1,7 +1,5 @@
 import { DetectionPeriod, LivenessAction } from "./enums";
 import { MotionLivenessDetector } from "./motion-liveness-detector";
-import { ScreenCaptureDetector } from './screen-capture-detector';
-import { ResolvedEngineOptions } from "./types";
 /**
  * Internal detection state interface
  */
@@ -19,18 +17,16 @@ export declare class DetectionState {
     lastFrontalScore: number;
     motionDetector: MotionLivenessDetector | null;
     liveness: boolean;
-    screenDetector: ScreenCaptureDetector | null;
     constructor(options: Partial<DetectionState>);
     reset(): void;
     needFrontalFace(): boolean;
     isReadyToVerify(minCollectCount: number): boolean;
     onActionStarted(nextAction: LivenessAction, timeoutMills: number, timeoutCallback: () => void): void;
     onActionCompleted(): void;
-    setCVInstance(cvInstance: any): void;
     /**
      * Clear action verify timeout
      */
     private clearActionVerifyTimeout;
 }
-export declare function createDetectionState(options: ResolvedEngineOptions): DetectionState;
+export declare function createDetectionState(): DetectionState;
 //# sourceMappingURL=face-detection-state.d.ts.map

package/dist/types/face-detection-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"face-detection-state.d.ts","sourceRoot":"","sources":["../../src/face-detection-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAwB,MAAM,SAAS,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAA6B,MAAM,2BAA2B,CAAA;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAE/C;;GAEG;AACH,qBAAa,cAAc;IACvB,MAAM,EAAE,eAAe,CAAyB;IAChD,SAAS,EAAE,MAAM,CAAoB;IACrC,YAAY,EAAE,MAAM,CAAI;IACxB,oBAAoB,EAAE,MAAM,CAAI;IAChC,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAO;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAO;IACnC,gBAAgB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAY;IACjD,aAAa,EAAE,cAAc,GAAG,IAAI,CAAO;IAC3C,mBAAmB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAO;IAChE,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAO;IACpD,QAAQ,EAAE,OAAO,CAAQ;IACzB,cAAc,EAAE,qBAAqB,GAAG,IAAI,CAAO;gBAEvC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC;IAI5C,KAAK,IAAI,IAAI;IAeb,eAAe,IAAI,OAAO;IAK1B,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAUjD,eAAe,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,IAAI,GAAG,IAAI;IASpG,iBAAiB,IAAI,IAAI;IASzB,aAAa,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAKpC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAMnC;AAID,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA4BnF"}
+{"version":3,"file":"face-detection-state.d.ts","sourceRoot":"","sources":["../../src/face-detection-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AAEnE;;GAEG;AACH,qBAAa,cAAc;IACvB,MAAM,EAAE,eAAe,CAAyB;IAChD,SAAS,EAAE,MAAM,CAAoB;IACrC,YAAY,EAAE,MAAM,CAAI;IACxB,oBAAoB,EAAE,MAAM,CAAI;IAChC,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAO;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAO;IACnC,gBAAgB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAY;IACjD,aAAa,EAAE,cAAc,GAAG,IAAI,CAAO;IAC3C,mBAAmB,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAO;IAChE,gBAAgB,EAAE,MAAM,CAAI;IAC5B,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAO;IACpD,QAAQ,EAAE,OAAO,CAAQ;gBAEb,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC;IAI5C,KAAK,IAAI,IAAI;IAab,eAAe,IAAI,OAAO;IAK1B,eAAe,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAUjD,eAAe,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,IAAI,GAAG,IAAI;IASpG,iBAAiB,IAAI,IAAI;IASzB;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAMnC;AAID,wBAAgB,oBAAoB,IAAI,cAAc,CAIrD"}

package/dist/types/face-frontal-calculator.d.ts

@@ -32,7 +32,7 @@ export interface AngleAnalysisResult {
  * @param {any} cv - OpenCV 实例（用于轮廓对称性检测）
  * @param {FaceResult} face - 人脸检测结果（包含 rotation 和 annotations 信息）
  * @param {Array<GestureResult>} gestures - 检测到的手势/表情数组（可选）
- * @param {any} matImage - OpenCV Mat 对象（图像数据，用于轮廓检测）
+ * @param {any} grayFrame - OpenCV Mat 对象（图像数据，用于轮廓检测）
  * @param {FaceFrontalFeatures} config - 正对度配置参数（包含角度阈值）
  * @returns {number} 正对度评分 (0-1)，1 表示完全正对
  *
@@ -42,9 +42,9 @@ export interface AngleAnalysisResult {
  * if (score > 0.9) {
  *   console.log('人脸足够正对')
  * }
- * mat.delete()
+ * grayFrame.delete()
  */
-export declare function calcFaceFrontal(cv: any, face: FaceResult, gestures: Array<GestureResult>, matImage: any, config: FaceFrontalFeatures): number;
+export declare function calcFaceFrontal(cv: any, face: FaceResult, gestures: Array<GestureResult>, grayFrame: any, config: FaceFrontalFeatures): number;
 /**
  * 使用手势识别方法检查人脸正对度
  *

package/dist/types/face-frontal-calculator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"face-frontal-calculator.d.ts","sourceRoot":"","sources":["../../src/face-frontal-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAG7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,EAC9B,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAgCR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,OAAO,CAUpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA8BhG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAUvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiD1G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAwChG"}
+{"version":3,"file":"face-frontal-calculator.d.ts","sourceRoot":"","sources":["../../src/face-frontal-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAG7C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,EAC9B,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAgCR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,OAAO,CAUpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CA8BhG;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,mBAAmB,CAUvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAiD1G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAwChG"}

package/dist/types/image-quality-calculator.d.ts

@@ -1,14 +1,7 @@
 /**
- * 人脸图像质量检测模块 (统一版)
+ * 图像质量检测模块
  *
- * 综合检测人脸图像的：
- * 1. 完整度检测 - 人脸是否完整在框内
- * 2. 模糊度检测 - 图像是否清晰
- * 3. 轮廓清晰度 - 轮廓的连通性和完整度
- *
- * 使用混合检测策略，结合 Human.js 和 OpenCV.js 优势
  */
-import { FaceResult } from '@vladmandic/human';
 import { ImageQualityFeatures } from './types';
 /**
  * 单个检测指标的结果
@@ -37,30 +30,24 @@ export interface ImageQualityResult {
     suggestions?: string[];
 }
 /**
- * 计算图像质量（完整度 + 清晰度）
+ * 计算图像清晰度评分
  *
- * 综合检测：
- * - 人脸完整度（Human.js边界 + OpenCV轮廓）
- * - 图像清晰度（拉普拉斯方差 + Sobel梯度）
+ * 综合检测图像的清晰度，使用两个指标：
+ * - 拉普拉斯方差 (60%)：检测边缘清晰程度
+ * - Sobel 梯度清晰度 (40%)：检测纹理梯度强度
  *
  * @param cv - OpenCV.js 对象，用于执行图像处理操作
- * @param matImage - OpenCV Mat 对象，包含灰度图像数据
- * @param face - 人脸检测结果，包含人脸框位置和其他检测信息
- * @param imageWidth - 图片宽度（像素），用于边界检查和完整度计算
- * @param imageHeight - 图片高度（像素），用于边界检查和完整度计算
+ * @param grayFrame - OpenCV Mat 对象，包含灰度图像数据（已ROI裁剪）
  * @param config - 检测配置对象，包含：
- *   - require_full_face_in_bounds: 是否要求人脸完全在边界内
- *   - use_opencv_enhancement: 是否使用 OpenCV 增强检测
- *   - min_laplacian_variance: 拉普拉斯方差最小阈值
- *   - min_gradient_sharpness: 梯度清晰度最小阈值
+ *   - min_laplacian_variance: 拉普拉斯方差最小阈值（默认 40）
+ *   - min_gradient_sharpness: 梯度清晰度最小阈值（默认 0.15）
  * @param threshold - 综合质量评分阈值 (0-1)，大于等于此值判定为通过
  * @returns 综合质量检测结果，包含：
  *   - passed: 是否通过质量检测
  *   - score: 综合质量评分 (0-1)
- *   - completenessReasons: 完整度不通过原因列表
+ *   - metrics: 各维度详细指标（拉普拉斯方差、梯度清晰度、综合质量）
  *   - blurReasons: 清晰度不通过原因列表
- *   - metrics: 各维度详细指标（完整度、拉普拉斯方差、梯度清晰度、综合质量）
  *   - suggestions: 改进建议列表
  */
-export declare function calcImageQuality(cv: any, matImage: any, face: FaceResult, imageWidth: number, imageHeight: number, config: ImageQualityFeatures, threshold: number): ImageQualityResult;
+export declare function calcImageQuality(cv: any, grayFrame: any, config: ImageQualityFeatures, threshold: number): ImageQualityResult;
 //# sourceMappingURL=image-quality-calculator.d.ts.map

package/dist/types/image-quality-calculator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-quality-calculator.d.ts","sourceRoot":"","sources":["../../src/image-quality-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAI9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,MAAM,EAAE,OAAO,CAAA;IAEf,KAAK,EAAE,MAAM,CAAA;IAEb,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAA;IAErB,OAAO,EAAE;QACP,YAAY,EAAE,mBAAmB,CAAA;QACjC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,cAAc,EAAE,mBAAmB,CAAA;KACpC,CAAA;IAED,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,GAAG,EACP,QAAQ,EAAE,GAAG,EACb,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAoEpB"}
+{"version":3,"file":"image-quality-calculator.d.ts","sourceRoot":"","sources":["../../src/image-quality-calculator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAoC9C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAEjC,MAAM,EAAE,OAAO,CAAA;IAEf,KAAK,EAAE,MAAM,CAAA;IAEb,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAA;IAErB,OAAO,EAAE;QACP,YAAY,EAAE,mBAAmB,CAAA;QACjC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,iBAAiB,EAAE,mBAAmB,CAAA;QACtC,cAAc,EAAE,mBAAmB,CAAA;KACpC,CAAA;IAED,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,GAAG,EACP,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,oBAAoB,EAC5B,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAkFpB"}