@visutry/tryon-core 0.2.0

package/dist/analytics.js

@@ -0,0 +1,49 @@
+/**
+ * Analytics event types for face-shape analysis (spec §12).
+ *
+ * The host application wires these events into its analytics pipeline
+ * (e.g. GA4). Events carry algorithm metadata and outcome signals only —
+ * NEVER photos, base64, landmarks, or any reversible biometric data.
+ */
+/**
+ * Create a no-op reporter (default when analytics is disabled).
+ * Useful as a safe default in tests and when `privacy.allowAnalytics` is false.
+ */
+export function noopReporter() {
+    return () => {
+        /* no-op */
+    };
+}
+/**
+ * Create a reporter that buffers events and flushes them via the provided
+ * sink. Useful for batching in production.
+ */
+export function createBufferedReporter(sink, flushIntervalMs = 5000) {
+    let buffer = [];
+    let timer = null;
+    if (flushIntervalMs > 0) {
+        timer = setInterval(() => {
+            if (buffer.length > 0) {
+                sink(buffer);
+                buffer = [];
+            }
+        }, flushIntervalMs);
+    }
+    return {
+        reporter: (event) => {
+            buffer.push(event);
+        },
+        flush: () => {
+            if (buffer.length > 0) {
+                sink(buffer);
+                buffer = [];
+            }
+        },
+        destroy: () => {
+            if (timer)
+                clearInterval(timer);
+            timer = null;
+        },
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgGH;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,GAAG,EAAE;QACV,WAAW;IACb,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAoD,EACpD,eAAe,GAAG,IAAI;IAEtB,IAAI,MAAM,GAAiC,EAAE,CAAC;IAC9C,IAAI,KAAK,GAA0C,IAAI,CAAC;IAExD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YACvB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,CAAC;gBACb,MAAM,GAAG,EAAE,CAAC;YACd,CAAC;QACH,CAAC,EAAE,eAAe,CAAC,CAAC;IACtB,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,CAAC,CAAC;gBACb,MAAM,GAAG,EAAE,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,KAAK;gBAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YAChC,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/coordinate/CoordinateSystem.d.ts

@@ -0,0 +1,46 @@
+import type { CoordinateSystemType, Point2D, Point3D } from "../types/index.js";
+/**
+ * Coordinate system conversions for VisuTry SDK.
+ *
+ * Four coordinate systems are used throughout the SDK:
+ *
+ *  - `pixel-image`      origin top-left, x right, y down.   Raw video / image frames.
+ *  - `normalized-image` origin top-left, x∈[0,1] right, y∈[0,1] down.  SDK-internal face results.
+ *  - `render-world`     origin scene-center, x right, y up.  Glasses model rendering.
+ *  - `glasses-local`    origin model origin, x right, y up, z temple.  Single glasses model.
+ *
+ * Adapters always emit `NormalizedFaceResult`. The core operates exclusively in
+ * normalized-image space. The renderer only ever receives `GlassesPose`, never raw
+ * landmarks.
+ */
+export declare class CoordinateSystem {
+    /** Convert a pixel-space point to normalized image space. */
+    static pixelToNormalized(point: Point2D | Point3D, width: number, height: number): Point3D;
+    /** Convert a batch of pixel points to normalized image space. */
+    static pixelToNormalizedBatch(points: Point3D[], width: number, height: number): Point3D[];
+    /** Convert a normalized image point back to pixel space. */
+    static normalizedToPixel(point: Point3D, width: number, height: number): Point3D;
+    /**
+     * Convert a normalized image point (y down) into render-world space (y up),
+     * centering the origin at the image center. This is used when the renderer
+     * needs to place auxiliary geometry; the primary glasses pose is produced by
+     * `GlassesPoseSolver` which handles its own mapping.
+     *
+     * The mapping is:  x_w = (x_n - 0.5) * aspectScale,  y_w = (0.5 - y_n),  z kept.
+     */
+    static normalizedToRenderWorld(point: Point3D, aspectRatio?: number): Point3D;
+    /**
+     * Convert render-world (y up) back to normalized image (y down).
+     */
+    static renderWorldToNormalized(point: Point3D, aspectRatio?: number): Point3D;
+    /**
+     * Validate that a value lies within the normalized unit square.
+     * Returns the clamped value and whether clamping was needed.
+     */
+    static clampNormalized(value: number): {
+        value: number;
+        clamped: boolean;
+    };
+    static describe(type: CoordinateSystemType): string;
+}
+//# sourceMappingURL=CoordinateSystem.d.ts.map

package/dist/coordinate/CoordinateSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoordinateSystem.d.ts","sourceRoot":"","sources":["../../src/coordinate/CoordinateSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB;IAC3B,6DAA6D;IAC7D,MAAM,CAAC,iBAAiB,CACtB,KAAK,EAAE,OAAO,GAAG,OAAO,EACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO;IAUV,iEAAiE;IACjE,MAAM,CAAC,sBAAsB,CAC3B,MAAM,EAAE,OAAO,EAAE,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,EAAE;IAIZ,4DAA4D;IAC5D,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAQhF;;;;;;;OAOG;IACH,MAAM,CAAC,uBAAuB,CAC5B,KAAK,EAAE,OAAO,EACd,WAAW,SAAI,GACd,OAAO;IAQV;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,SAAI,GAAG,OAAO;IASxE;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAM1E,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM;CAYpD"}

package/dist/coordinate/CoordinateSystem.js

@@ -0,0 +1,88 @@
+/**
+ * Coordinate system conversions for VisuTry SDK.
+ *
+ * Four coordinate systems are used throughout the SDK:
+ *
+ *  - `pixel-image`      origin top-left, x right, y down.   Raw video / image frames.
+ *  - `normalized-image` origin top-left, x∈[0,1] right, y∈[0,1] down.  SDK-internal face results.
+ *  - `render-world`     origin scene-center, x right, y up.  Glasses model rendering.
+ *  - `glasses-local`    origin model origin, x right, y up, z temple.  Single glasses model.
+ *
+ * Adapters always emit `NormalizedFaceResult`. The core operates exclusively in
+ * normalized-image space. The renderer only ever receives `GlassesPose`, never raw
+ * landmarks.
+ */
+export class CoordinateSystem {
+    /** Convert a pixel-space point to normalized image space. */
+    static pixelToNormalized(point, width, height) {
+        const w = width || 1;
+        const h = height || 1;
+        return {
+            x: point.x / w,
+            y: point.y / h,
+            z: "z" in point && point.z !== undefined ? point.z / Math.max(w, h) : 0,
+        };
+    }
+    /** Convert a batch of pixel points to normalized image space. */
+    static pixelToNormalizedBatch(points, width, height) {
+        return points.map((p) => this.pixelToNormalized(p, width, height));
+    }
+    /** Convert a normalized image point back to pixel space. */
+    static normalizedToPixel(point, width, height) {
+        return {
+            x: point.x * width,
+            y: point.y * height,
+            z: point.z * Math.max(width, height),
+        };
+    }
+    /**
+     * Convert a normalized image point (y down) into render-world space (y up),
+     * centering the origin at the image center. This is used when the renderer
+     * needs to place auxiliary geometry; the primary glasses pose is produced by
+     * `GlassesPoseSolver` which handles its own mapping.
+     *
+     * The mapping is:  x_w = (x_n - 0.5) * aspectScale,  y_w = (0.5 - y_n),  z kept.
+     */
+    static normalizedToRenderWorld(point, aspectRatio = 1) {
+        return {
+            x: (point.x - 0.5) * aspectRatio,
+            y: 0.5 - point.y,
+            z: point.z,
+        };
+    }
+    /**
+     * Convert render-world (y up) back to normalized image (y down).
+     */
+    static renderWorldToNormalized(point, aspectRatio = 1) {
+        const sx = aspectRatio || 1;
+        return {
+            x: point.x / sx + 0.5,
+            y: 0.5 - point.y,
+            z: point.z,
+        };
+    }
+    /**
+     * Validate that a value lies within the normalized unit square.
+     * Returns the clamped value and whether clamping was needed.
+     */
+    static clampNormalized(value) {
+        if (value < 0)
+            return { value: 0, clamped: true };
+        if (value > 1)
+            return { value: 1, clamped: true };
+        return { value, clamped: false };
+    }
+    static describe(type) {
+        switch (type) {
+            case "pixel-image":
+                return "Pixel Image — origin top-left, x right, y down. Raw frames.";
+            case "normalized-image":
+                return "Normalized Image — origin top-left, x∈[0,1] right, y∈[0,1] down. SDK internal.";
+            case "render-world":
+                return "Render World — origin scene-center, x right, y up. Glasses rendering.";
+            case "glasses-local":
+                return "Glasses Local — origin model origin, x right, y up, z temple. Single model.";
+        }
+    }
+}
+//# sourceMappingURL=CoordinateSystem.js.map

package/dist/coordinate/CoordinateSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoordinateSystem.js","sourceRoot":"","sources":["../../src/coordinate/CoordinateSystem.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gBAAgB;IAC3B,6DAA6D;IAC7D,MAAM,CAAC,iBAAiB,CACtB,KAAwB,EACxB,KAAa,EACb,MAAc;QAEd,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;QACtB,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC;YACd,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC;YACd,CAAC,EAAE,GAAG,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACxE,CAAC;IACJ,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,sBAAsB,CAC3B,MAAiB,EACjB,KAAa,EACb,MAAc;QAEd,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,4DAA4D;IAC5D,MAAM,CAAC,iBAAiB,CAAC,KAAc,EAAE,KAAa,EAAE,MAAc;QACpE,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK;YAClB,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM;YACnB,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;SACrC,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,uBAAuB,CAC5B,KAAc,EACd,WAAW,GAAG,CAAC;QAEf,OAAO;YACL,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,WAAW;YAChC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;YAChB,CAAC,EAAE,KAAK,CAAC,CAAC;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,KAAc,EAAE,WAAW,GAAG,CAAC;QAC5D,MAAM,EAAE,GAAG,WAAW,IAAI,CAAC,CAAC;QAC5B,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG;YACrB,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;YAChB,CAAC,EAAE,KAAK,CAAC,CAAC;SACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,KAAa;QAClC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAClD,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAClD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAA0B;QACxC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,aAAa;gBAChB,OAAO,6DAA6D,CAAC;YACvE,KAAK,kBAAkB;gBACrB,OAAO,gFAAgF,CAAC;YAC1F,KAAK,cAAc;gBACjB,OAAO,uEAAuE,CAAC;YACjF,KAAK,eAAe;gBAClB,OAAO,6EAA6E,CAAC;QACzF,CAAC;IACH,CAAC;CACF"}

package/dist/face/FaceMetricsCalculator.d.ts

@@ -0,0 +1,52 @@
+import type { FaceMetrics, FaceSemanticPoints, NormalizedFaceResult } from "../types/index.js";
+/**
+ * Computes geometric `FaceMetrics` from `FaceSemanticPoints`.
+ *
+ * Design rules (spec §12.2):
+ *  - All distances use normalized coordinates.
+ *  - Missing points are tolerated — a metric is simply left undefined / the
+ *    measurement quality degrades. The calculator never throws on missing data.
+ *  - Every result carries a `measurementQuality` in [0,1].
+ *  - Multi-frame analysis aggregates via median (distances) / trimmed mean (ratios).
+ */
+export declare class FaceMetricsCalculator {
+    /**
+     * Compute metrics for a single normalized face result.
+     */
+    compute(face: NormalizedFaceResult): FaceMetrics;
+    /**
+     * Compute metrics directly from semantic points. This is the core entry
+     * point — `NormalizedFaceResult` is only a thin wrapper around it.
+     */
+    computeFromSemantic(s: FaceSemanticPoints): FaceMetrics;
+    /**
+     * Aggregate metrics across multiple frames (spec §12.3). Distances use the
+     * median; ratios are recomputed from medians to stay internally consistent;
+     * `measurementQuality` blends per-frame quality with cross-frame stability.
+     */
+    aggregate(frames: NormalizedFaceResult[]): FaceMetrics;
+    private safeDistance;
+    /**
+     * 2D distance (x, y only — no z). Used for visutry-compatible ratios.
+     */
+    private safeDistance2D;
+    /**
+     * Compute visutry-compatible ratios using 2D distances.
+     * This mirrors visutry's analyzeFaceLandmarks() exactly:
+     *   - faceAspectRatio = faceHeight / faceWidth (H/W, 2D)
+     *   - cheekToFaceWidth = cheekWidth / faceWidth
+     *   - jawToCheekWidth = jawWidth / cheekWidth
+     *   - foreheadToCheekWidth = foreheadWidth / cheekWidth
+     *   - eyeLineTiltDeg = atan2(dy, dx) * 180/PI
+     *   - symmetryOffset = |noseBridge.x - faceCenterX| / faceWidth
+     *   - noseBridgeToFaceWidth = noseBridgeWidth / faceWidth
+     */
+    private computeVisutryRatios;
+    private countKeyPoints;
+    private computeQuality;
+    private classifyChin;
+    private stabilityFactor;
+    private majorityVote;
+    private emptyMetrics;
+}
+//# sourceMappingURL=FaceMetricsCalculator.d.ts.map

package/dist/face/FaceMetricsCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FaceMetricsCalculator.d.ts","sourceRoot":"","sources":["../../src/face/FaceMetricsCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG/F;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,WAAW;IAIhD;;;OAGG;IACH,mBAAmB,CAAC,CAAC,EAAE,kBAAkB,GAAG,WAAW;IAqHvD;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,GAAG,WAAW;IAkGtD,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,oBAAoB;IAwC5B,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/face/FaceMetricsCalculator.js

@@ -0,0 +1,375 @@
+import { distance2D, distance3D, median, trimmedMean, clamp01 } from "../utils/math.js";
+/**
+ * Computes geometric `FaceMetrics` from `FaceSemanticPoints`.
+ *
+ * Design rules (spec §12.2):
+ *  - All distances use normalized coordinates.
+ *  - Missing points are tolerated — a metric is simply left undefined / the
+ *    measurement quality degrades. The calculator never throws on missing data.
+ *  - Every result carries a `measurementQuality` in [0,1].
+ *  - Multi-frame analysis aggregates via median (distances) / trimmed mean (ratios).
+ */
+export class FaceMetricsCalculator {
+    /**
+     * Compute metrics for a single normalized face result.
+     */
+    compute(face) {
+        return this.computeFromSemantic(face.landmarks.semantic);
+    }
+    /**
+     * Compute metrics directly from semantic points. This is the core entry
+     * point — `NormalizedFaceResult` is only a thin wrapper around it.
+     */
+    computeFromSemantic(s) {
+        const present = this.countKeyPoints(s);
+        // --- Horizontal widths -------------------------------------------------
+        const cheekboneWidth = this.safeDistance(s.leftCheek, s.rightCheek);
+        const jawWidth = this.safeDistance(s.leftJaw, s.rightJaw);
+        const eyeOuterDistance = this.safeDistance(s.leftEyeOuter, s.rightEyeOuter);
+        const eyeInnerDistance = this.safeDistance(s.leftEyeInner, s.rightEyeInner);
+        const eyeCenterDistance = this.safeDistance(s.leftEyeCenter, s.rightEyeCenter);
+        // visutry additions: face outline width, forehead width, nose bridge width
+        const faceOutlineWidth = this.safeDistance(s.leftFace, s.rightFace);
+        const foreheadWidth = this.safeDistance(s.leftForehead, s.rightForehead);
+        const noseBridgeWidth = this.safeDistance(s.noseLeft, s.noseRight);
+        // faceWidth: prefer face outline width (widest part, visutry convention);
+        // fall back to cheekbone width, then eye outer distance.
+        const faceWidth = faceOutlineWidth ?? cheekboneWidth ?? eyeOuterDistance ?? 0;
+        // --- Vertical height ---------------------------------------------------
+        let faceHeight;
+        if (s.foreheadCenter && s.chin) {
+            faceHeight = distance3D(s.foreheadCenter, s.chin);
+        }
+        else if (s.eyesCenter && s.chin) {
+            faceHeight = distance3D(s.eyesCenter, s.chin) / 0.55;
+        }
+        // --- Nose bridge to eye line ------------------------------------------
+        let noseBridgeToEyeLine = 0;
+        if (s.noseBridge && s.eyesCenter) {
+            noseBridgeToEyeLine = Math.abs(s.noseBridge.y - s.eyesCenter.y);
+        }
+        // --- Ratios ------------------------------------------------------------
+        const widthHeightRatio = faceHeight && faceHeight > 1e-6 ? faceWidth / faceHeight : 0;
+        const jawCheekRatio = jawWidth !== undefined && cheekboneWidth && cheekboneWidth > 1e-6
+            ? jawWidth / cheekboneWidth
+            : 0;
+        const foreheadCheekRatio = foreheadWidth !== undefined && cheekboneWidth && cheekboneWidth > 1e-6
+            ? foreheadWidth / cheekboneWidth
+            : undefined;
+        // --- Eye line tilt (degrees) ------------------------------------------
+        // Angle of the line connecting left/right eye outer corners relative to
+        // horizontal. Positive = right side higher. Used for photo quality check.
+        let eyeLineTiltDeg;
+        if (s.leftEyeOuter && s.rightEyeOuter) {
+            const dx = s.rightEyeOuter.x - s.leftEyeOuter.x;
+            const dy = s.rightEyeOuter.y - s.leftEyeOuter.y;
+            if (Math.abs(dx) > 1e-6) {
+                eyeLineTiltDeg = Math.atan2(dy, dx) * (180 / Math.PI);
+            }
+        }
+        // --- Symmetry offset ---------------------------------------------------
+        // Nose bridge deviation from face center (midpoint of leftFace/rightFace).
+        // 0 = perfectly symmetric, larger = more offset.
+        let symmetryOffset;
+        if (s.noseBridge && s.leftFace && s.rightFace && faceWidth > 1e-6) {
+            const faceCenterX = (s.leftFace.x + s.rightFace.x) / 2;
+            symmetryOffset = Math.abs(s.noseBridge.x - faceCenterX) / faceWidth;
+        }
+        // --- Face span (bounding box max dimension) ----------------------------
+        let faceSpan;
+        if (s.leftFace && s.rightFace && s.foreheadCenter && s.chin) {
+            const w = Math.abs(s.rightFace.x - s.leftFace.x);
+            const h = Math.abs(s.chin.y - s.foreheadCenter.y);
+            faceSpan = Math.max(w, h);
+        }
+        // --- Chin type classification (geometric heuristic, width/height aware) -
+        const chinType = this.classifyChin(jawCheekRatio, widthHeightRatio, jawWidth, cheekboneWidth, s.chin, s.leftJaw, s.rightJaw);
+        // --- Measurement quality ----------------------------------------------
+        const measurementQuality = this.computeQuality(present, s);
+        // --- visutry-compatible 2D ratios -------------------------------------
+        // visutry uses 2D distances (Math.hypot(dx, dy) with no z-component).
+        // We compute these separately to ensure exact numerical equivalence.
+        const visutry = this.computeVisutryRatios(s);
+        return {
+            faceWidth,
+            faceHeight: faceHeight ?? 0,
+            cheekboneWidth: cheekboneWidth ?? 0,
+            jawWidth: jawWidth ?? 0,
+            foreheadWidth,
+            faceOutlineWidth,
+            eyeOuterDistance: eyeOuterDistance ?? 0,
+            eyeInnerDistance: eyeInnerDistance ?? 0,
+            eyeCenterDistance: eyeCenterDistance ?? 0,
+            noseBridgeToEyeLine,
+            noseBridgeWidth,
+            widthHeightRatio,
+            jawCheekRatio,
+            foreheadCheekRatio,
+            eyeLineTiltDeg,
+            symmetryOffset,
+            faceSpan,
+            chinType,
+            measurementQuality,
+            visutry,
+        };
+    }
+    /**
+     * Aggregate metrics across multiple frames (spec §12.3). Distances use the
+     * median; ratios are recomputed from medians to stay internally consistent;
+     * `measurementQuality` blends per-frame quality with cross-frame stability.
+     */
+    aggregate(frames) {
+        if (frames.length === 0) {
+            return this.emptyMetrics();
+        }
+        if (frames.length === 1) {
+            return this.compute(frames[0]);
+        }
+        const perFrame = frames.map((f) => this.compute(f));
+        const pick = (key) => perFrame.map((m) => m[key]).filter((v) => typeof v === "number" && !Number.isNaN(v));
+        const faceWidth = median(pick("faceWidth"));
+        const faceHeight = median(pick("faceHeight"));
+        const cheekboneWidth = median(pick("cheekboneWidth"));
+        const jawWidth = median(pick("jawWidth"));
+        const eyeOuterDistance = median(pick("eyeOuterDistance"));
+        const eyeInnerDistance = median(pick("eyeInnerDistance"));
+        const eyeCenterDistance = median(pick("eyeCenterDistance"));
+        const noseBridgeToEyeLine = median(pick("noseBridgeToEyeLine"));
+        // visutry additions — aggregate optional metrics when available
+        const foreheadWidthArr = perFrame.map((m) => m.foreheadWidth).filter((v) => typeof v === "number" && !Number.isNaN(v));
+        const faceOutlineWidthArr = perFrame.map((m) => m.faceOutlineWidth).filter((v) => typeof v === "number" && !Number.isNaN(v));
+        const noseBridgeWidthArr = perFrame.map((m) => m.noseBridgeWidth).filter((v) => typeof v === "number" && !Number.isNaN(v));
+        const eyeLineTiltArr = perFrame.map((m) => m.eyeLineTiltDeg).filter((v) => typeof v === "number" && !Number.isNaN(v));
+        const symmetryOffsetArr = perFrame.map((m) => m.symmetryOffset).filter((v) => typeof v === "number" && !Number.isNaN(v));
+        const faceSpanArr = perFrame.map((m) => m.faceSpan).filter((v) => typeof v === "number" && !Number.isNaN(v));
+        const foreheadWidth = foreheadWidthArr.length > 0 ? median(foreheadWidthArr) : undefined;
+        const faceOutlineWidth = faceOutlineWidthArr.length > 0 ? median(faceOutlineWidthArr) : undefined;
+        const noseBridgeWidth = noseBridgeWidthArr.length > 0 ? median(noseBridgeWidthArr) : undefined;
+        const eyeLineTiltDeg = eyeLineTiltArr.length > 0 ? median(eyeLineTiltArr) : undefined;
+        const symmetryOffset = symmetryOffsetArr.length > 0 ? median(symmetryOffsetArr) : undefined;
+        const faceSpan = faceSpanArr.length > 0 ? median(faceSpanArr) : undefined;
+        const widthHeightRatio = faceHeight > 1e-6 ? faceWidth / faceHeight : 0;
+        const jawCheekRatio = cheekboneWidth > 1e-6 ? jawWidth / cheekboneWidth : 0;
+        const foreheadCheekRatio = foreheadWidth !== undefined && cheekboneWidth > 1e-6
+            ? foreheadWidth / cheekboneWidth
+            : undefined;
+        const qualities = pick("measurementQuality");
+        const avgQuality = trimmedMean(qualities, 0.2);
+        // Stability bonus: low variance across frames increases confidence.
+        const wds = pick("faceWidth");
+        const stability = this.stabilityFactor(wds);
+        const measurementQuality = clamp01(avgQuality * 0.6 + stability * 0.4);
+        // Chin type: majority vote across frames.
+        const chinVotes = perFrame.map((m) => m.chinType);
+        const chinType = this.majorityVote(chinVotes);
+        // Aggregate visutry-compatible ratios (median of per-frame values)
+        const visutryArr = perFrame.map((m) => m.visutry).filter((v) => v !== undefined);
+        const visutry = visutryArr.length > 0
+            ? {
+                faceAspectRatio: median(visutryArr.map((v) => v.faceAspectRatio)),
+                cheekToFaceWidth: median(visutryArr.map((v) => v.cheekToFaceWidth)),
+                jawToCheekWidth: median(visutryArr.map((v) => v.jawToCheekWidth)),
+                foreheadToCheekWidth: median(visutryArr.map((v) => v.foreheadToCheekWidth)),
+                eyeLineTiltDeg: median(visutryArr.map((v) => v.eyeLineTiltDeg)),
+                symmetryOffset: median(visutryArr.map((v) => v.symmetryOffset)),
+                noseBridgeToFaceWidth: median(visutryArr.map((v) => v.noseBridgeToFaceWidth)),
+            }
+            : undefined;
+        return {
+            faceWidth,
+            faceHeight,
+            cheekboneWidth,
+            jawWidth,
+            foreheadWidth,
+            faceOutlineWidth,
+            eyeOuterDistance,
+            eyeInnerDistance,
+            eyeCenterDistance,
+            noseBridgeToEyeLine,
+            noseBridgeWidth,
+            widthHeightRatio,
+            jawCheekRatio,
+            foreheadCheekRatio,
+            eyeLineTiltDeg,
+            symmetryOffset,
+            faceSpan,
+            chinType,
+            measurementQuality,
+            visutry,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    safeDistance(a, b) {
+        if (!a || !b)
+            return undefined;
+        return distance3D({ x: a.x, y: a.y, z: a.z ?? 0 }, { x: b.x, y: b.y, z: b.z ?? 0 });
+    }
+    /**
+     * 2D distance (x, y only — no z). Used for visutry-compatible ratios.
+     */
+    safeDistance2D(a, b) {
+        if (!a || !b)
+            return undefined;
+        return distance2D({ x: a.x, y: a.y }, { x: b.x, y: b.y });
+    }
+    /**
+     * Compute visutry-compatible ratios using 2D distances.
+     * This mirrors visutry's analyzeFaceLandmarks() exactly:
+     *   - faceAspectRatio = faceHeight / faceWidth (H/W, 2D)
+     *   - cheekToFaceWidth = cheekWidth / faceWidth
+     *   - jawToCheekWidth = jawWidth / cheekWidth
+     *   - foreheadToCheekWidth = foreheadWidth / cheekWidth
+     *   - eyeLineTiltDeg = atan2(dy, dx) * 180/PI
+     *   - symmetryOffset = |noseBridge.x - faceCenterX| / faceWidth
+     *   - noseBridgeToFaceWidth = noseBridgeWidth / faceWidth
+     */
+    computeVisutryRatios(s) {
+        const required = [s.foreheadCenter, s.chin, s.leftFace, s.rightFace,
+            s.leftCheek, s.rightCheek, s.leftJaw, s.rightJaw,
+            s.leftForehead, s.rightForehead, s.leftEyeOuter, s.rightEyeOuter,
+            s.noseLeft, s.noseRight, s.noseBridge];
+        if (required.some((p) => !p))
+            return undefined;
+        // 2D distances — visutry multiplies by imageWidth/imageHeight but since
+        // these are ratios, the scaling cancels out. We compute with normalized
+        // coordinates directly.
+        const faceHeight = this.safeDistance2D(s.foreheadCenter, s.chin);
+        const faceWidth = this.safeDistance2D(s.leftFace, s.rightFace);
+        const cheekWidth = this.safeDistance2D(s.leftCheek, s.rightCheek);
+        const jawWidth = this.safeDistance2D(s.leftJaw, s.rightJaw);
+        const foreheadWidth = this.safeDistance2D(s.leftForehead, s.rightForehead);
+        const noseBridgeWidth = this.safeDistance2D(s.noseLeft, s.noseRight);
+        if (faceHeight <= 0 || faceWidth <= 0 || cheekWidth <= 0)
+            return undefined;
+        // Eye line tilt — visutry uses atan2(dy*H, dx*W). With normalized coords
+        // (W=H=1), this is atan2(dy, dx).
+        const dx = s.rightEyeOuter.x - s.leftEyeOuter.x;
+        const dy = s.rightEyeOuter.y - s.leftEyeOuter.y;
+        const eyeLineTiltDeg = Math.atan2(dy, dx) * (180 / Math.PI);
+        // Symmetry offset
+        const faceCenterX = (s.leftFace.x + s.rightFace.x) / 2;
+        const symmetryOffset = Math.abs(s.noseBridge.x - faceCenterX) / faceWidth;
+        return {
+            faceAspectRatio: faceHeight / faceWidth,
+            cheekToFaceWidth: cheekWidth / faceWidth,
+            jawToCheekWidth: jawWidth / cheekWidth,
+            foreheadToCheekWidth: foreheadWidth / cheekWidth,
+            eyeLineTiltDeg,
+            symmetryOffset,
+            noseBridgeToFaceWidth: noseBridgeWidth / faceWidth,
+        };
+    }
+    countKeyPoints(s) {
+        const keys = [
+            "leftEyeOuter",
+            "leftEyeInner",
+            "rightEyeInner",
+            "rightEyeOuter",
+            "leftEyeCenter",
+            "rightEyeCenter",
+            "eyesCenter",
+            "noseBridge",
+            "noseTip",
+            "chin",
+            "leftCheek",
+            "rightCheek",
+            "leftJaw",
+            "rightJaw",
+            "leftBrowCenter",
+            "rightBrowCenter",
+            "foreheadCenter",
+            // visutry additions
+            "leftFace",
+            "rightFace",
+            "leftForehead",
+            "rightForehead",
+            "noseLeft",
+            "noseRight",
+        ];
+        let count = 0;
+        for (const k of keys)
+            if (s[k])
+                count++;
+        return count;
+    }
+    computeQuality(present, s) {
+        // Base quality from coverage of 23 key points.
+        const coverage = clamp01(present / 23);
+        // Critical points weight: eyes, noseBridge, chin, cheeks, jaw are essential.
+        const critical = [
+            "leftEyeCenter",
+            "rightEyeCenter",
+            "eyesCenter",
+            "noseBridge",
+            "chin",
+            "leftCheek",
+            "rightCheek",
+            "leftJaw",
+            "rightJaw",
+        ];
+        const criticalPresent = critical.filter((k) => s[k]).length;
+        const criticalRatio = criticalPresent / critical.length;
+        // Blend: critical points matter more than peripheral coverage.
+        return clamp01(coverage * 0.35 + criticalRatio * 0.65);
+    }
+    classifyChin(jawCheekRatio, widthHeightRatio, jawWidth, cheekboneWidth, chin, leftJaw, rightJaw) {
+        if (jawWidth === undefined || cheekboneWidth === undefined || !chin || !leftJaw || !rightJaw) {
+            return "unknown";
+        }
+        // A pointed chin tapers strongly: jaw much narrower than cheekbone.
+        if (jawCheekRatio < 0.72) {
+            return "pointed";
+        }
+        // A broad jaw (jaw ≈ cheekbone) is square when proportions are medium and
+        // rounded when the face is nearly as wide as it is tall (a round face).
+        if (jawCheekRatio >= 0.86) {
+            return widthHeightRatio >= 0.9 ? "rounded" : "square";
+        }
+        // Intermediate taper => rounded.
+        return "rounded";
+    }
+    stabilityFactor(values) {
+        if (values.length < 2)
+            return 1;
+        const m = values.reduce((a, b) => a + b, 0) / values.length;
+        if (m < 1e-6)
+            return 0.5;
+        const variance = values.reduce((a, b) => a + (b - m) * (b - m), 0) / values.length;
+        const cv = Math.sqrt(variance) / m; // coefficient of variation
+        // cv near 0 => stable (1); cv >= 0.15 => unstable (0).
+        return clamp01(1 - cv / 0.15);
+    }
+    majorityVote(values) {
+        const counts = new Map();
+        for (const v of values)
+            counts.set(v, (counts.get(v) ?? 0) + 1);
+        let best = "unknown";
+        let bestCount = 0;
+        for (const [k, c] of counts) {
+            if (c > bestCount) {
+                best = k;
+                bestCount = c;
+            }
+        }
+        return best;
+    }
+    emptyMetrics() {
+        return {
+            faceWidth: 0,
+            faceHeight: 0,
+            cheekboneWidth: 0,
+            jawWidth: 0,
+            eyeOuterDistance: 0,
+            eyeInnerDistance: 0,
+            eyeCenterDistance: 0,
+            noseBridgeToEyeLine: 0,
+            widthHeightRatio: 0,
+            jawCheekRatio: 0,
+            chinType: "unknown",
+            measurementQuality: 0,
+        };
+    }
+}
+//# sourceMappingURL=FaceMetricsCalculator.js.map

package/dist/face/FaceMetricsCalculator.js.map

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