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

package/dist/types/motion-liveness-detector.d.ts

@@ -1,203 +1,337 @@
 /**
- * 运动和活体检测 - 防止照片攻击
- * 检测微妙的面部运动和运动模式，以区分真实面孔和高质量照片
+ * 活体检测器 - 微妙运动检测版本 + 照片几何特征检测
+ *
+ * 双重检测策略：
+ * 1. 正向检测：检测生物特征（微妙眨眼、细微张嘴、面部肌肉微动）
+ * 2. 逆向检测：检测照片几何特征（平面约束、透视变换规律、交叉比率）
+ *
+ * ⚠️ 关键理解 ⚠️
+ * MediaPipe 返回的 Z 坐标（深度）是从2D图像【推断】出来的，不是真实的物理深度！
+ * - 对真实人脸：推断出正确的 3D 结构
+ * - 对照片人脸：也可能推断出"假"的 3D 结构（因为照片上的人脸看起来也像 3D 的）
+ *
+ * 因此，检测策略优先级：
+ * 1. 【最可靠】2D 几何约束检测（单应性、交叉比率、透视变换规律）——物理定律，无法欺骗
+ * 2. 【次可靠】生物特征时序检测（眨眼时间、对称性）——行为模式
+ * 3. 【辅助参考】Z 坐标分析——可能被欺骗，仅作辅助
  */
 import type { FaceResult } from '@vladmandic/human';
 import type { Box } from '@vladmandic/human';
 /**
- * 运动检测结果
+ * 活体检测结果
  */
 export declare class MotionDetectionResult {
-    motionScore: number;
-    opticalFlowMagnitude: number;
-    keypointVariance: number;
-    eyeMotionScore: number;
-    mouthMotionScore: number;
-    motionType: MotionType;
     isLively: boolean;
     details: {
         frameCount: number;
-        avgKeypointDistance: number;
-        maxKeypointDistance: number;
-        faceAreaVariance: number;
-        eyeAspectRatioVariance: number;
-        mouthAspectRatioVariance: number;
+        eyeAspectRatioStdDev: number;
+        mouthAspectRatioStdDev: number;
+        eyeFluctuation: number;
+        mouthFluctuation: number;
+        muscleVariation: number;
+        hasEyeMovement: boolean;
+        hasMouthMovement: boolean;
+        hasMuscleMovement: boolean;
+        isPhoto?: boolean;
+        photoConfidence?: number;
+        homographyScore?: number;
+        perspectiveScore?: number;
+        crossRatioScore?: number;
+        depthVariation?: number;
+        crossFramePattern?: number;
     };
-    constructor(motionScore: number, opticalFlowMagnitude: number, keypointVariance: number, eyeMotionScore: number, mouthMotionScore: number, motionType: MotionType, isLively: boolean, details: {
-        frameCount: number;
-        avgKeypointDistance: number;
-        maxKeypointDistance: number;
-        faceAreaVariance: number;
-        eyeAspectRatioVariance: number;
-        mouthAspectRatioVariance: number;
-    });
-    /**
-     * 获取活体检测结果信息
-     * 如果活跃，返回空字符串，否则返回非活体检测的原因
-     */
-    getMessage(minMotionScore: number, minKeypointVariance: number): string;
+    constructor(isLively: boolean, details: any);
+    getMessage(): string;
 }
-export type MotionType = 'none' | 'rotation' | 'translation' | 'breathing' | 'micro_expression';
-/**
- * 运动活体检测选项
- */
 export interface MotionLivenessDetectorOptions {
-    minMotionThreshold?: number;
-    minKeypointVariance?: number;
     frameBufferSize?: number;
-    eyeAspectRatioThreshold?: number;
-    motionConsistencyThreshold?: number;
-    minOpticalFlowThreshold?: number;
-    strictPhotoDetection?: boolean;
+    eyeMinFluctuation?: number;
+    mouthMinFluctuation?: number;
+    muscleMinVariation?: number;
+    activityThreshold?: number;
 }
 /**
- * 运动活体检测器
- * 使用光流、关键点跟踪和面部特征分析
+ * 活体检测器 - 超敏感微动作版本 + 照片几何特征检测
+ *
+ * 双重策略：
+ * 1. 检测生物微动（正向）
+ * 2. 检测照片几何约束（逆向）- 更可靠
  */
 export declare class MotionLivenessDetector {
-    private readonly minMotionThreshold;
-    private readonly minKeypointVariance;
-    private readonly frameBufferSize;
-    private readonly eyeAspectRatioThreshold;
-    private readonly motionConsistencyThreshold;
-    private readonly minOpticalFlowThreshold;
-    private readonly strictPhotoDetection;
-    private frameBuffer;
-    private keypointHistory;
-    private faceAreaHistory;
+    private config;
     private eyeAspectRatioHistory;
     private mouthAspectRatioHistory;
-    private opticalFlowHistory;
-    private pupilSizeHistory;
-    private cv;
-    constructor(options?: Partial<MotionLivenessDetectorOptions>);
-    setCVInstance(cvInstance: any): void;
+    private faceLandmarksHistory;
+    private normalizedLandmarksHistory;
+    private leftEyeEARHistory;
+    private rightEyeEARHistory;
+    private frameTimestamps;
+    private rigidMotionHistory;
+    private homographyErrors;
+    private depthConsistencyScores;
+    private planarityScores;
+    constructor();
+    getOptions(): Required<MotionLivenessDetectorOptions>;
     isReady(): boolean;
+    reset(): void;
+    analyzeMotion(faceResult: FaceResult, faceBox: Box): MotionDetectionResult;
     /**
-     * 重置运动检测状态
+     * 检测眼睛的微妙波动（任何变化）
+     * 防护：排除透视畸变、噪声，确保是真实的连续或周期性波动
      */
-    reset(): void;
+    private detectEyeFluctuation;
     /**
-     * 从当前帧和历史记录分析运动和活体性
+     * 检测嘴巴的微妙波动（任何变化）
+     * 防护：排除噪声，确保是真实的张嘴/闭嘴动作
      */
-    analyzeMotion(grayMat: any, faceResult: FaceResult, faceBox: Box): MotionDetectionResult;
+    private detectMouthFluctuation;
     /**
-     * 将帧添加到循环缓冲区
+     * 【关键】检测真实的嘴巴张嘴→闭嘴动作
+     *
+     * 原理类似眨眼，需要检测下降和上升的连续段
      */
-    private addFrameToBuffer;
+    private detectRealMouthMovement;
     /**
-     * 验证运动一致性 - 防止照片微动攻击
-     * 真实面部运动：光流和关键点方差应该都有意义（都不为零）
-     * 照片微动：通常表现为只有光流或只有噪声，或两者都非常低
+     * 检测面部肌肉的微动（关键点位置微妙变化）
+     * 关键：允许刚性运动+生物特征（真人摇头），拒绝纯刚性运动（照片旋转）
      *
-     * 修复：允许不同类型运动的不同比例关系
-     * - 大幅度头部运动（旋转/平移）: 高keypoint variance, 中等optical flow
-     * - 微妙表情运动: 中等optical flow, 低keypoint variance
-     * - 照片微动: 两者都很低，或严重不匹配（一个近零一个不近零）
+     * 【重要修复】使用归一化坐标进行比较，消除人脸在画面中移动的影响
      */
-    private validateMotionConsistency;
+    private detectMuscleMovement;
     /**
-     * 检测瞳孔反应 - 活体的关键特征
-     * 照片的瞳孔无法反应光线变化
+     * 【防护机制】检测照片透视畸变（倾角拍摄）
+     *
+     * 原理：
+     * - 照片是平面：所有关键点Z坐标（深度）应该相同且恒定
+     * - 当从倾角看平面照片时，虽然会产生2D投影变形，但深度仍然固定在一个平面
+     * - 真实活体：脸部有Z坐标深度，不同区域有深度差异（鼻子、下巴等突出）
+     *
+     * 返回值：照片平面性得分（0-1，越接近1越可能是平面照片）
      */
-    private detectPupilResponse;
+    private detectPhotoPlanarity;
     /**
-     * 计算眼睛大小（用于瞳孔反应检测）
+     * 【防护机制】检测刚性运动（照片被拿着旋转/平移）
+     *
+     * 原理：
+     * - 照片所有关键点运动是【刚性的】→ 所有点以相同方向、相似幅度移动
+     * - 活体肌肉运动是【非刚性的】→ 不同部位独立运动（眼睛、嘴、脸颊等）
+     *
+     * 【重要修复】使用归一化坐标进行比较
+     *
+     * 返回值 0-1：值越接近1说明是刚性运动（照片运动）
      */
-    private calculateEyeSize;
+    private detectRigidMotion;
     /**
-     * 从 Human.js 面部检测结果中提取面部关键点
-     * 使用网格标志点（来自 MediaPipe Face Mesh 模型的 468 个点）
+     * 计算角度的平均值（考虑循环性）
      */
-    private extractKeypoints;
+    private calculateMeanAngle;
     /**
-     * 计算光流幅度（需要 OpenCV）
-     * 检测帧之间的像素运动
+     * 检测序列是否呈现【往复波动】而不是【单向变化】
+     *
+     * 原理：
+     * - 真实眨眼/表情：值会【往复波动】 如 0.4 → 0.3 → 0.4 → 0.5
+     * - 照片透视变形：值会【单向变化】 如 0.4 → 0.3 → 0.25 → 0.2
+     *
+     * 返回值：true = 检测到往复波动（活体特征）
      */
-    private analyzeOpticalFlow;
+    private detectOscillation;
     /**
-     * 将 canvas 转换为 OpenCV Mat，支持可选的灰度转换
+     * 【关键】检测真实眨眼（连续的闭眼→睁眼周期）
+     *
+     * 原理：
+     * - 真实眨眼：快速下降（EAR↓ 1-2帧）→ 保持低值（EAR低 2-3帧）→ 快速上升（EAR↑ 1-2帧）
+     * - 噪声或光线变化：孤立的异常值，前后没有连续的变化模式
+     *
+     * 返回值：true = 检测到完整或部分眨眼周期
+     */
+    private detectRealBlink;
+    /**
+     * 【新增防护】检测左右眼对称性
+     *
+     * 原理：
+     * - 真实眨眼：左右眼几乎同时闭合和睁开，EAR变化高度同步
+     * - 照片透视畸变：根据偏转方向，一只眼睛可能比另一只变化更大
+     *
+     * 返回值 0-1：越接近1说明左右眼越对称（越像真实眨眼）
      */
-    private canvasToMat;
+    private detectEyeSymmetry;
     /**
-     * 计算光流的平均幅度
+     * 【新增防护】检测眨眼时间模式
+     *
+     * 原理：
+     * - 真实眨眼非常快：完整周期 100-400ms（3-12帧@30fps）
+     * - 手动摆动照片：周期通常 500ms-2000ms（15-60帧@30fps）
+     *
+     * 返回值：true = 检测到符合真实眨眼的快速时间模式
      */
-    private calculateFlowMagnitude;
+    private detectBlinkTiming;
     /**
-     * 计算关键点位置在帧间的方差
-     * 高方差 = 自然运动（活跃）
-     * 低方差 = 静止如照片
+     * 【新增防护】检测运动-形变相关性
+     *
+     * 原理：
+     * - 照片偏转攻击：刚性运动越大 → EAR/MAR形变越大（高度相关）
+     * - 真实活体：眨眼/张嘴与头部运动无关（低相关或无相关）
+     *
+     * 返回值 0-1：越接近1说明运动和形变越相关（越像照片攻击）
      */
-    private calculateKeypointVariance;
+    private detectMotionDeformCorrelation;
     /**
-     * 计算两帧中对应标志点之间的平均距离
+     * 【关键】检测最近几帧是否有运动
+     *
+     * 防护：某人在检测开始时眨眼，之后就完全静止
+     * 这种情况应该判定为照片，因为照片可以有偶然的反光
+     * 活体应该有【持续的或周期性的】动作
+     *
+     * 返回值：true = 最近3-5帧内有明显变化
      */
-    private calculateLandmarkDistance;
+    private detectRecentMovement;
     /**
-     * 计算所有帧中的平均关键点距离
+     * 【核心】照片几何特征检测（逆向检测）
+     *
+     * 重要说明：
+     * - MediaPipe的Z坐标是从2D图像【推断】的，不是真实深度
+     * - 对照片也可能推断出"假"的3D结构
+     * - 因此【2D几何约束】比【Z坐标分析】更可靠
+     *
+     * 可靠的检测（基于2D几何，物理定律）：
+     * 1. 单应性变换约束 - 平面必须满足
+     * 2. 特征点相对位置变化 - 照片偏转时遵循透视规律
+     *
+     * 参考性检测（基于推断的Z坐标，可能被欺骗）：
+     * 1. 深度一致性 - 辅助参考
+     * 2. 跨帧深度模式 - 辅助参考
      */
-    private calculateAvgKeypointDistance;
+    private detectPhotoGeometry;
     /**
-     * 计算帧间的最大关键点距离
+     * 【新增核心检测】交叉比率不变性检测
+     *
+     * 原理（射影几何的基本定理）：
+     * - 平面上共线4点的【交叉比率】在透视变换下保持不变
+     * - 真实3D人脸旋转时，面部各点不共面，交叉比率会变化
+     * - 照片无论怎么偏转，共线点的交叉比率保持不变
+     *
+     * 这是纯2D几何检测，非常可靠！
      */
-    private calculateMaxKeypointDistance;
     /**
-     * 计算眼睛宽高比 (EAR)
-     * 用于检测眨眼和眼睛开度变化
+     * 【交叉比率不变性检测】
+     *
+     * 原理（射影几何的基本定理）：
+     * - 平面上共线4点的【交叉比率】在透视变换下保持不变
+     * - 真实3D人脸旋转时，面部各点不共面，交叉比率会变化
+     * - 照片无论怎么偏转，共线点的交叉比率保持不变
+     *
+     * 【注意】交叉比率本身是比率，不依赖绝对坐标
+     * 使用归一化坐标只是为了一致性
      */
-    private calculateEyeAspectRatio;
+    private detectCrossRatioInvariance;
     /**
-     * 计算嘴巴宽高比 (MAR)
-     * 用于检测嘴巴张开的变化
+     * 【关键】检测单应性变换约束
+     *
+     * 原理：
+     * - 平面物体（照片）在不同视角下的投影满足 H * p1 = p2（H是3x3单应性矩阵）
+     * - 3D物体不满足这个约束，会有残差误差
+     *
+     * 方法：用4对点计算H，然后检验其他点是否符合H变换
      */
-    private calculateMouthAspectRatio;
     /**
-     * 计算两个点之间的距离
+     * 【单应性约束检测】判断多帧特征点是否满足平面约束
+     *
+     * 【重要修复】使用归一化坐标进行比较
+     * 这是纯 2D 几何检测，最可靠！
      */
-    private pointDistance;
+    private detectHomographyConstraint;
     /**
-     * 基于眼睛宽高比变化计算眼睛运动评分
+     * 估计仿射变换矩阵 (简化的单应性)
+     * 输入：源点和目标点对
+     * 输出：[a, b, c, d, e, f] 表示变换 x' = ax + by + c, y' = dx + ey + f
      */
-    private calculateEyeMotionScore;
+    private estimateAffineTransform;
     /**
-     * 基于嘴巴宽高比变化计算嘴巴运动评分
+     * 应用仿射变换
      */
-    private calculateMouthMotionScore;
+    private applyAffineTransform;
     /**
-     * 计算人脸区域方差
+     * 【关键】检测深度一致性
+     *
+     * 原理：
+     * - 真实人脸：鼻子Z坐标明显大于眼睛和脸颊（凸出）
+     * - 照片：所有点Z坐标接近相同（平面）
      */
-    private calculateFaceAreaVariance;
+    private detectDepthConsistency;
     /**
-     * 计算数字数组的方差
+     * 【关键】检测跨帧深度模式
+     *
+     * 原理：
+     * - 照片旋转时：所有点的深度变化遵循平面投影规律（线性关系）
+     * - 真实人脸旋转时：不同部位的深度变化不成线性关系
      */
-    private calculateVariance;
+    private detectCrossFrameDepthPattern;
     /**
-     * 基于分析检测运动类型
+     * 【关键】检测透视变换模式
+     *
+     * 原理：
+     * - 照片偏转时，特征点位置变化遵循严格的透视变换规律
+     * - 检测左右脸的相对变化是否符合透视投影
      */
-    private detectMotionType;
     /**
-     * 从多个来源计算总体运动评分
-     * 针对照片攻击进行优化：提高光流和关键点方差的权重
+     * 【透视变换模式检测】
+     *
+     * 【重要修复】使用归一化坐标进行比较
+     *
+     * 原理：照片左右偏转时，左右脸宽度比例会平滑变化
      */
-    private calculateOverallMotionScore;
+    private detectPerspectiveTransformPattern;
     /**
-     * 根据运动分析确定面部是否活跃
-     * 修复：改进对真实面部运动的识别，减少误判
+     * 综合判定 - 结合正向检测（生物特征）和逆向检测（照片几何）
+     *
+     * 双重策略：
+     * 1. 正向：检测生物微动特征（有 → 活体）
+     * 2. 逆向：检测照片几何约束（满足 → 照片）
+     *
+     * 逆向检测优先级更高，因为照片几何约束是物理定律，无法伪造
      */
-    private determineLiveness;
+    private makeLivenessDecision;
     /**
-     * 分析失败时创建空结果
+     * 【防护机制】检查脸部形状稳定性
+     *
+     * 原理：
+     * - 真实脸部：眨眼、张嘴等会改变脸部几何形状（EAR/MAR 变化）
+     * - 照片：脸部形状完全固定，不会有任何变化
+     * - 倾角照片：虽然会产生透视变形，但仍然是平面的，Z坐标无深度
+     *
+     * 返回值 0-1：值越接近1说明脸部形状越稳定（越可能是照片）
      */
-    private createEmptyResult;
     /**
-     * 验证运动的物理约束
-     * 照片微动的运动往往会违反物理约束（如速度跳跃）
-     * 真实面部运动应该表现出光滑的加速度和速度变化
+     * 检查脸部形状稳定性
+     *
+     * 【重要修复】使用归一化坐标进行比较
+     * 这样即使人脸在画面中移动或缩放，比较仍然有效
      */
-    private validatePhysicalConstraints;
+    private checkFaceShapeStability;
+    private extractKeypoints;
+    private calculateEyeAspectRatio;
+    private calculateMouthAspectRatio;
+    private pointDist;
+    private calculateStdDev;
     /**
-     * 获取运动检测结果（用于调试）
+     * 【关键方法】将关键点坐标归一化到人脸局部坐标系
+     *
+     * 问题：
+     * - MediaPipe 返回的 x,y 坐标是相对于【图像左上角】的像素坐标
+     * - 如果人脸在画面中移动，同一个关键点的绝对坐标会完全不同
+     * - 多帧之间直接比较绝对坐标是错误的！
+     *
+     * 解决：
+     * - 将坐标转换为相对于人脸边界框的归一化坐标
+     * - 归一化坐标 = (点坐标 - 人脸左上角) / 人脸尺寸
+     * - 这样无论人脸在画面中的位置，归一化坐标都一致
+     *
+     * @param landmarks 原始关键点数组
+     * @param faceBox 人脸边界框 [x, y, width, height]
+     * @returns 归一化后的关键点数组
      */
+    private normalizeLandmarks;
+    private createEmptyResult;
     getStatistics(): any;
 }
 //# sourceMappingURL=motion-liveness-detector.d.ts.map

package/dist/types/motion-liveness-detector.d.ts.map

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

package/dist/types/optical-distortion-detector.d.ts

@@ -0,0 +1,116 @@
+/**
+ * 光学畸变检测器 - 检测投影仪和其他光学系统的特有伪影
+ *
+ * 核心原理：
+ * - 投影仪通过光学透镜将图像投射到屏幕上
+ * - 光学系统导致多种失真：梯形失真、桶形/枕形失真、模糊
+ * - 真实人脸直接摄像，无这些光学失真
+ *
+ * 检测特征：
+ * 1. 梯形失真（Keystone）- 图像上下边宽度不同
+ * 2. 桶形/枕形失真 - 直线边缘弯曲
+ * 3. 光学模糊 - 边界清晰度在视场中不均匀
+ * 4. 色差（Chromatic Aberration）- RGB通道空间分离
+ * 5. 暗角（Vignetting）- 四角暗化
+ */
+import { VideoFrameCollector } from "./video-frame-collector";
+export interface OpticalDistortionDetectorConfig {
+    bufferSize: number;
+    keystoneThreshold: number;
+    barrelDistortionThreshold: number;
+    chromaticAberrationThreshold: number;
+    vignetteThreshold: number;
+    samplingStride: number;
+    featureWeights: {
+        keystone: number;
+        barrelDistortion: number;
+        chromaticAberration: number;
+        vignette: number;
+    };
+}
+export interface OpticalDistortionDetectionResult {
+    isScreenCapture: boolean;
+    confidence: number;
+    distortionFeatures: {
+        keystoneDetected: boolean;
+        keystoneLevel: number;
+        barrelDistortionDetected: boolean;
+        barrelDistortionLevel: number;
+        chromaticAberrationDetected: boolean;
+        chromaticAberrationLevel: number;
+        vignetteDetected: boolean;
+        vignetteLevel: number;
+    };
+    overallOpticalDistortionScore: number;
+    estimatedProjectorType?: 'dlp' | 'lcd' | 'lcos' | 'unknown';
+    details?: any;
+}
+export declare class OpticalDistortionDetector {
+    private config;
+    private frameCollector;
+    constructor(frameCollector: VideoFrameCollector, config: OpticalDistortionDetectorConfig);
+    /**
+     * 获取当前缓冲区中的帧数
+     */
+    getBufferedFrameCount(): number;
+    /**
+     * 执行光学畸变检测分析
+     */
+    analyze(): OpticalDistortionDetectionResult;
+    /**
+     * 注意：重置由 FrameCollector 管理
+     * 此检测器不持有任何帧缓冲
+     */
+    reset(): void;
+    /**
+     * 检测梯形失真（Keystone）
+     *
+     * 原理：
+     * - 梯形失真导致图像上下边宽度不同
+     * - 计算上下边的宽度比
+     */
+    private detectKeystone;
+    /**
+     * 检测桶形/枕形失真
+     *
+     * 原理：
+     * - 提取图像边界
+     * - 拟合边界为曲线，计算曲率
+     * - 高曲率表示失真
+     */
+    private detectBarrelDistortion;
+    /**
+     * 检测色差（RGB通道分离）
+     */
+    private detectChromaticAberration;
+    /**
+     * 检测暗角（四角暗化）
+     *
+     * 原理：
+     * - 计算四个角区域的平均亮度
+     * - 与中心区域对比
+     * - 大幅下降表示暗角
+     */
+    private detectVignette;
+    /**
+     * 找水平边界的宽度
+     */
+    private findHorizontalEdgeWidth;
+    /**
+     * 测量边界的垂直直线度（曲率）
+     */
+    private measureBoundaryDeviation;
+    /**
+     * 找在特定y处的垂直边界
+     */
+    private findVerticalEdgeAtY;
+    /**
+     * 计算矩形区域的平均亮度
+     */
+    private getAverageBrightness;
+    /**
+     * 推断投影仪类型
+     */
+    private inferProjectorType;
+}
+//# sourceMappingURL=optical-distortion-detector.d.ts.map

package/dist/types/optical-distortion-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optical-distortion-detector.d.ts","sourceRoot":"","sources":["../../src/optical-distortion-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAE7D,MAAM,WAAW,+BAA+B;IAE9C,UAAU,EAAE,MAAM,CAAA;IAGlB,iBAAiB,EAAE,MAAM,CAAA;IAGzB,yBAAyB,EAAE,MAAM,CAAA;IAGjC,4BAA4B,EAAE,MAAM,CAAA;IAGpC,iBAAiB,EAAE,MAAM,CAAA;IAGzB,cAAc,EAAE,MAAM,CAAA;IAGtB,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,EAAE,MAAM,CAAA;QACxB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,OAAO,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAGlB,kBAAkB,EAAE;QAClB,gBAAgB,EAAE,OAAO,CAAA;QACzB,aAAa,EAAE,MAAM,CAAA;QAErB,wBAAwB,EAAE,OAAO,CAAA;QACjC,qBAAqB,EAAE,MAAM,CAAA;QAE7B,2BAA2B,EAAE,OAAO,CAAA;QACpC,wBAAwB,EAAE,MAAM,CAAA;QAEhC,gBAAgB,EAAE,OAAO,CAAA;QACzB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;IAGD,6BAA6B,EAAE,MAAM,CAAA;IAGrC,sBAAsB,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;IAE3D,OAAO,CAAC,EAAE,GAAG,CAAA;CACd;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,cAAc,CAAqB;gBAE/B,cAAc,EAAE,mBAAmB,EAAE,MAAM,EAAE,+BAA+B;IAUxF;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,OAAO,IAAI,gCAAgC;IA6F3C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IA8BtB;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAajC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAgC3B"}