@visutry/tryon-core 0.2.0

package/dist/face/feature-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-extractor.js","sourceRoot":"","sources":["../../src/face/feature-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,OAAO,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,mBAAmB;IACnB,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,mBAAmB;IACnB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;CACT,CAAC;AAEX,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC,MAAM,CAAC;AAE/D,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,uCAAuC;AACvC,MAAM,UAAU,cAAc,CAAC,QAAiC;IAC9D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC;QACb;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IAE7C,OAAO;QACL,6BAA6B;QAC7B,OAAO,CAAC,iBAAiB;QACzB,+CAA+C;QAC/C,OAAO,CAAC,aAAa;QACrB,yDAAyD;QACzD,OAAO,CAAC,kBAAkB,IAAI,CAAC;QAC/B,iDAAiD;QACjD,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,QAAQ;QAClC,yDAAyD;QACzD,QAAQ,GAAG,KAAK;QAChB,mDAAmD;QACnD,OAAO,CAAC,eAAe,IAAI,CAAC;QAC5B,kBAAkB;QAClB,OAAO,CAAC,YAAY,IAAI,CAAC;QACzB,uBAAuB;QACvB,OAAO,CAAC,iBAAiB,IAAI,CAAC;QAC9B,oBAAoB;QACpB,OAAO,CAAC,cAAc,IAAI,CAAC;QAC3B,oBAAoB;QACpB,OAAO,CAAC,cAAc,IAAI,CAAC;QAC3B,sBAAsB;QACtB,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/face/logreg-classifier.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Logistic-regression classifier — pure TypeScript inference (spec §9.3).
+ *
+ * The model is trained offline in Python (scikit-learn) and exported as a
+ * compact JSON file (< 5 KB target). The browser loads this JSON and runs
+ * inference without any ML runtime (no ONNX, no TensorFlow.js).
+ *
+ * The forward pass is: standardize → linear logits → softmax → calibration.
+ *
+ * **Calibration**: softmax outputs are NOT inherently calibrated probabilities.
+ * The model JSON declares which calibration was applied on an independent
+ * calibration set (temperature / Platt / isotonic / none). Until ECE/Brier
+ * validation passes (spec §9.4), `calibrated` stays `false` and the output
+ * is treated as relative `matchStrength`, not probability.
+ */
+import type { FaceMetrics, FaceShape, FaceShapeCandidate } from "../types/index.js";
+/** Shape class labels in canonical order — matches `weights` rows. */
+export declare const LOGREG_CLASS_NAMES: FaceShape[];
+/** Number of classes — convenience constant. */
+export declare const LOGREG_NUM_CLASSES: number;
+/** Calibration strategy applied on an independent calibration set. */
+export type CalibrationType = "none" | "temperature" | "platt" | "isotonic";
+/** Isotonic regression calibration map (ascending input → calibrated output). */
+export interface IsotonicMap {
+    /** Sorted ascending input thresholds. */
+    inputs: number[];
+    /** Calibrated outputs aligned with `inputs`. */
+    outputs: number[];
+}
+export interface CalibrationParams {
+    type: CalibrationType;
+    /** Temperature scaling divisor for logits (temperature scaling only). */
+    temperature?: number;
+    /** Platt scaling: `a * logit + b` then sigmoid (Platt only). */
+    plattA?: number;
+    plattB?: number;
+    /** Per-class isotonic maps (isotonic only). Length = numClasses. */
+    isotonic?: IsotonicMap[];
+}
+export interface TrainingMeta {
+    trainSamples: number;
+    valSamples: number;
+    calibrationSamples: number;
+    regularization: "l1" | "l2" | "elasticnet" | "none";
+    C: number;
+    classWeight: "balanced" | "none";
+    trainedAt: string;
+    sdkVersion: string;
+}
+/**
+ * Model JSON format exported by the Python training script.
+ * This is the on-the-wire contract between Python training and TS inference.
+ */
+export interface LogRegModel {
+    modelVersion: string;
+    featureSchemaVersion: string;
+    classNames: FaceShape[];
+    featureNames: string[];
+    numClasses: number;
+    numFeatures: number;
+    /** Shape: [numClasses][numFeatures]. */
+    weights: number[][];
+    /** Length: numClasses. */
+    bias: number[];
+    /** Length: numFeatures. Feature means from training set. */
+    mean: number[];
+    /** Length: numFeatures. Feature std-devs from training set. */
+    std: number[];
+    /** How missing optionals were handled during training. */
+    missingValueStrategy: "zero";
+    calibration: CalibrationParams;
+    trainingMeta: TrainingMeta;
+}
+export declare class ModelValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate a parsed JSON object against the `LogRegModel` contract.
+ * Throws `ModelValidationError` on any mismatch.
+ */
+export declare function validateModel(model: unknown): asserts model is LogRegModel;
+/**
+ * Parse and validate a model JSON string. Returns a ready-to-use `LogRegModel`.
+ */
+export declare function loadModel(json: string): LogRegModel;
+/**
+ * Logistic-regression face shape classifier (spec §9.3).
+ *
+ * Loads a trained model JSON and produces `FaceShapeCandidate[]` with
+ * `matchStrength` values. The `matchStrength` is the (optionally calibrated)
+ * softmax probability — but it is NOT advertised as a probability until
+ * `calibrated` is `true` and ECE/Brier validation passes.
+ */
+export declare class LogRegClassifier {
+    private readonly model;
+    readonly modelVersion: string;
+    readonly featureSchemaVersion: string;
+    readonly calibrated: boolean;
+    constructor(model: LogRegModel);
+    /**
+     * Classify face metrics into shape candidates.
+     *
+     * Returns candidates sorted by `matchStrength` (descending). The
+     * `matchStrength` values sum to 1.0 (softmax normalization).
+     */
+    classify(metrics: FaceMetrics): FaceShapeCandidate[];
+    /**
+     * Metadata for the `FaceShapeResult.model` field.
+     */
+    modelMeta(): {
+        engine: "logreg";
+        version: string;
+        featureSchemaVersion: string;
+        calibrated: boolean;
+    };
+}
+//# sourceMappingURL=logreg-classifier.d.ts.map

package/dist/face/logreg-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logreg-classifier.d.ts","sourceRoot":"","sources":["../../src/face/logreg-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAapF,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAQzC,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,QAA4B,CAAC;AAE5D,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5E,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,IAAI,GAAG,IAAI,GAAG,YAAY,GAAG,MAAM,CAAC;IACpD,CAAC,EAAE,MAAM,CAAC;IACV,WAAW,EAAE,UAAU,GAAG,MAAM,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4DAA4D;IAC5D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+DAA+D;IAC/D,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,0DAA0D;IAC1D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAMD,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAsF1E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAInD;AA4HD;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;gBAEjB,KAAK,EAAE,WAAW;IAQ9B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,kBAAkB,EAAE;IA0BpD;;OAEG;IACH,SAAS,IAAI;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE;CAQtG"}

package/dist/face/logreg-classifier.js

@@ -0,0 +1,304 @@
+/**
+ * Logistic-regression classifier — pure TypeScript inference (spec §9.3).
+ *
+ * The model is trained offline in Python (scikit-learn) and exported as a
+ * compact JSON file (< 5 KB target). The browser loads this JSON and runs
+ * inference without any ML runtime (no ONNX, no TensorFlow.js).
+ *
+ * The forward pass is: standardize → linear logits → softmax → calibration.
+ *
+ * **Calibration**: softmax outputs are NOT inherently calibrated probabilities.
+ * The model JSON declares which calibration was applied on an independent
+ * calibration set (temperature / Platt / isotonic / none). Until ECE/Brier
+ * validation passes (spec §9.4), `calibrated` stays `false` and the output
+ * is treated as relative `matchStrength`, not probability.
+ */
+import { softmax, clamp01 } from "../utils/math.js";
+import { extractFeatures, LOGREG_FEATURE_SCHEMA_VERSION, LOGREG_NUM_FEATURES, LOGREG_FEATURE_NAMES, } from "./feature-extractor.js";
+// ---------------------------------------------------------------------------
+// Model JSON schema
+// ---------------------------------------------------------------------------
+/** Shape class labels in canonical order — matches `weights` rows. */
+export const LOGREG_CLASS_NAMES = [
+    "oval",
+    "round",
+    "square",
+    "heart",
+    "diamond",
+    "oblong",
+    "triangle",
+];
+/** Number of classes — convenience constant. */
+export const LOGREG_NUM_CLASSES = LOGREG_CLASS_NAMES.length;
+// ---------------------------------------------------------------------------
+// Model loading & validation
+// ---------------------------------------------------------------------------
+export class ModelValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ModelValidationError";
+    }
+}
+/**
+ * Validate a parsed JSON object against the `LogRegModel` contract.
+ * Throws `ModelValidationError` on any mismatch.
+ */
+export function validateModel(model) {
+    const m = model;
+    if (!m || typeof m !== "object") {
+        throw new ModelValidationError("Model must be an object");
+    }
+    const required = [
+        "modelVersion", "featureSchemaVersion", "classNames", "featureNames",
+        "numClasses", "numFeatures", "weights", "bias", "mean", "std",
+        "missingValueStrategy", "calibration", "trainingMeta",
+    ];
+    for (const key of required) {
+        if (!(key in m)) {
+            throw new ModelValidationError(`Missing required field: ${key}`);
+        }
+    }
+    if (m.featureSchemaVersion !== LOGREG_FEATURE_SCHEMA_VERSION) {
+        throw new ModelValidationError(`Feature schema version mismatch: model has "${m.featureSchemaVersion}", ` +
+            `expected "${LOGREG_FEATURE_SCHEMA_VERSION}"`);
+    }
+    const numClasses = m.numClasses;
+    const numFeatures = m.numFeatures;
+    if (numClasses !== LOGREG_NUM_CLASSES) {
+        throw new ModelValidationError(`numClasses mismatch: ${numClasses} vs expected ${LOGREG_NUM_CLASSES}`);
+    }
+    if (numFeatures !== LOGREG_NUM_FEATURES) {
+        throw new ModelValidationError(`numFeatures mismatch: ${numFeatures} vs expected ${LOGREG_NUM_FEATURES}`);
+    }
+    const weights = m.weights;
+    if (!Array.isArray(weights) || weights.length !== numClasses) {
+        throw new ModelValidationError(`weights must have ${numClasses} rows`);
+    }
+    for (let i = 0; i < weights.length; i++) {
+        if (!Array.isArray(weights[i]) || weights[i].length !== numFeatures) {
+            throw new ModelValidationError(`weights[${i}] must have ${numFeatures} columns`);
+        }
+    }
+    const bias = m.bias;
+    if (!Array.isArray(bias) || bias.length !== numClasses) {
+        throw new ModelValidationError(`bias must have length ${numClasses}`);
+    }
+    const mean = m.mean;
+    if (!Array.isArray(mean) || mean.length !== numFeatures) {
+        throw new ModelValidationError(`mean must have length ${numFeatures}`);
+    }
+    const std = m.std;
+    if (!Array.isArray(std) || std.length !== numFeatures) {
+        throw new ModelValidationError(`std must have length ${numFeatures}`);
+    }
+    const featureNames = m.featureNames;
+    if (!Array.isArray(featureNames) || featureNames.length !== numFeatures) {
+        throw new ModelValidationError(`featureNames must have length ${numFeatures}`);
+    }
+    for (let i = 0; i < featureNames.length; i++) {
+        if (featureNames[i] !== LOGREG_FEATURE_NAMES[i]) {
+            throw new ModelValidationError(`featureNames[${i}] mismatch: "${featureNames[i]}" vs expected "${LOGREG_FEATURE_NAMES[i]}"`);
+        }
+    }
+    const classNames = m.classNames;
+    if (!Array.isArray(classNames) || classNames.length !== numClasses) {
+        throw new ModelValidationError(`classNames must have length ${numClasses}`);
+    }
+    for (let i = 0; i < classNames.length; i++) {
+        if (classNames[i] !== LOGREG_CLASS_NAMES[i]) {
+            throw new ModelValidationError(`classNames[${i}] mismatch: "${classNames[i]}" vs expected "${LOGREG_CLASS_NAMES[i]}"`);
+        }
+    }
+}
+/**
+ * Parse and validate a model JSON string. Returns a ready-to-use `LogRegModel`.
+ */
+export function loadModel(json) {
+    const parsed = JSON.parse(json);
+    validateModel(parsed);
+    return parsed;
+}
+// ---------------------------------------------------------------------------
+// Inference
+// ---------------------------------------------------------------------------
+/** Round to 3 decimal places for stable, readable output. */
+function round3(n) {
+    return Math.round(n * 1000) / 1000;
+}
+/**
+ * Apply isotonic regression calibration to a single value.
+ * Uses linear interpolation between stored breakpoints.
+ */
+function applyIsotonic(value, map) {
+    const { inputs, outputs } = map;
+    if (inputs.length === 0)
+        return value;
+    // Below the first breakpoint
+    if (value <= inputs[0])
+        return outputs[0];
+    // Above the last breakpoint
+    if (value >= inputs[inputs.length - 1])
+        return outputs[outputs.length - 1];
+    // Binary search for the interval
+    let lo = 0;
+    let hi = inputs.length - 1;
+    while (hi - lo > 1) {
+        const mid = (lo + hi) >> 1;
+        if (inputs[mid] <= value)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    // Linear interpolation
+    const x0 = inputs[lo];
+    const x1 = inputs[hi];
+    const y0 = outputs[lo];
+    const y1 = outputs[hi];
+    const t = x1 > x0 ? (value - x0) / (x1 - x0) : 0;
+    return y0 + t * (y1 - y0);
+}
+/**
+ * Standardize a feature vector: (x - mean) / std.
+ * Features with std == 0 (constant in training) are centered but not scaled.
+ */
+function standardize(features, mean, std) {
+    return features.map((x, i) => {
+        const s = std[i];
+        return s > 1e-9 ? (x - mean[i]) / s : x - mean[i];
+    });
+}
+/**
+ * Compute raw logits: z = W·x + b.
+ * `weights` is [numClasses][numFeatures], `bias` is [numClasses].
+ */
+function computeLogits(features, weights, bias) {
+    return weights.map((row, c) => {
+        let z = bias[c];
+        for (let i = 0; i < features.length; i++) {
+            z += row[i] * features[i];
+        }
+        return z;
+    });
+}
+/**
+ * Apply calibration to raw softmax probabilities.
+ *
+ * - `none`: return raw softmax (relative match, NOT a probability).
+ * - `temperature`: re-softmax with `logits / temperature`.
+ * - `platt`: apply per-class sigmoid `sigmoid(a * logit + b)`, then renormalize.
+ * - `isotonic`: apply per-class isotonic regression on the softmax output.
+ *
+ * Note: Platt and isotonic calibration are validated on an independent
+ * calibration set. Until ECE ≤ 0.10 (spec §9.4), `calibrated` stays `false`.
+ */
+function applyCalibration(logits, softmaxProbs, calibration) {
+    switch (calibration.type) {
+        case "none":
+            return softmaxProbs;
+        case "temperature": {
+            const T = calibration.temperature ?? 1;
+            return softmax(logits, T);
+        }
+        case "platt": {
+            const a = calibration.plattA ?? 1;
+            const b = calibration.plattB ?? 0;
+            const calibrated = logits.map((z) => {
+                const w = a * z + b;
+                return 1 / (1 + Math.exp(-w));
+            });
+            const sum = calibrated.reduce((s, v) => s + v, 0);
+            return sum > 1e-9 ? calibrated.map((v) => v / sum) : calibrated;
+        }
+        case "isotonic": {
+            const maps = calibration.isotonic;
+            if (!maps || maps.length !== logits.length)
+                return softmaxProbs;
+            const calibrated = softmaxProbs.map((p, i) => applyIsotonic(p, maps[i]));
+            const sum = calibrated.reduce((s, v) => s + v, 0);
+            return sum > 1e-9 ? calibrated.map((v) => v / sum) : calibrated;
+        }
+        default:
+            return softmaxProbs;
+    }
+}
+// ---------------------------------------------------------------------------
+// Classifier
+// ---------------------------------------------------------------------------
+/**
+ * Logistic-regression face shape classifier (spec §9.3).
+ *
+ * Loads a trained model JSON and produces `FaceShapeCandidate[]` with
+ * `matchStrength` values. The `matchStrength` is the (optionally calibrated)
+ * softmax probability — but it is NOT advertised as a probability until
+ * `calibrated` is `true` and ECE/Brier validation passes.
+ */
+export class LogRegClassifier {
+    constructor(model) {
+        Object.defineProperty(this, "model", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "modelVersion", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "featureSchemaVersion", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "calibrated", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        validateModel(model);
+        this.model = model;
+        this.modelVersion = model.modelVersion;
+        this.featureSchemaVersion = model.featureSchemaVersion;
+        this.calibrated = model.calibration.type !== "none";
+    }
+    /**
+     * Classify face metrics into shape candidates.
+     *
+     * Returns candidates sorted by `matchStrength` (descending). The
+     * `matchStrength` values sum to 1.0 (softmax normalization).
+     */
+    classify(metrics) {
+        // 1. Extract features in canonical order
+        const features = extractFeatures(metrics);
+        // 2. Standardize using training-set mean/std
+        const standardized = standardize(features, this.model.mean, this.model.std);
+        // 3. Compute raw logits
+        const logits = computeLogits(standardized, this.model.weights, this.model.bias);
+        // 4. Softmax → raw probabilities (relative match strength)
+        const rawProbs = softmax(logits);
+        // 5. Apply calibration (if any)
+        const calibrated = applyCalibration(logits, rawProbs, this.model.calibration);
+        // 6. Build candidates sorted by match strength
+        const candidates = this.model.classNames.map((shape, i) => ({
+            shape,
+            matchStrength: round3(clamp01(calibrated[i])),
+        }));
+        candidates.sort((a, b) => b.matchStrength - a.matchStrength);
+        return candidates;
+    }
+    /**
+     * Metadata for the `FaceShapeResult.model` field.
+     */
+    modelMeta() {
+        return {
+            engine: "logreg",
+            version: this.modelVersion,
+            featureSchemaVersion: this.featureSchemaVersion,
+            calibrated: this.calibrated,
+        };
+    }
+}
+//# sourceMappingURL=logreg-classifier.js.map

package/dist/face/logreg-classifier.js.map

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

package/dist/feature-flag.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Feature flag support for gradual rollout and rollback (spec §12, §14.1).
+ *
+ * The SDK is the single production classification core. A feature flag
+ * controls whether the SDK path is active for a given request and which
+ * engine (rules / logreg) runs. Rollback = disable the flag or pin a
+ * previous SDK package version — no parallel classifier is kept.
+ */
+/**
+ * Feature-flag configuration. Passed into the SDK factory or evaluated
+ * independently by the host application.
+ */
+export interface FeatureFlagConfig {
+    /** Master switch. When `false`, the host must fall back to its previous
+     *  behaviour (e.g. hide the free detector). Default `false`. */
+    enabled: boolean;
+    /** 0–100. Percentage of users (bucketed by `stableId`) that get the SDK
+     *  path. `100` = everyone. Ignored when `enabled` is `false`. Default `100`. */
+    rolloutPercentage?: number;
+    /** Override the classification engine. Defaults to the SDK's built-in
+     *  rule scorer (`"rules"`). Set to `"logreg"` once PR 6 ships. */
+    engine?: "rules" | "logreg";
+    /** Optional SDK version pin for audit / rollback tracking. */
+    sdkVersion?: string;
+}
+/**
+ * Determine whether the SDK face-shape path should be active for a given
+ * request.
+ *
+ * - `enabled: false` → always `false`.
+ * - `rolloutPercentage >= 100` (or unset) → `true`.
+ * - Otherwise, hash `stableId` to a 0–99 bucket and compare.
+ *
+ * When no `stableId` is provided, the flag is all-or-nothing: `enabled`
+ * alone decides.
+ */
+export declare function evaluateFeatureFlag(config: FeatureFlagConfig, stableId?: string): boolean;
+/**
+ * Resolve the effective engine, honouring the flag override.
+ * Falls back to `"rules"` when the flag is disabled or no override is set.
+ */
+export declare function resolveEngine(config: FeatureFlagConfig | undefined): "rules" | "logreg";
+//# sourceMappingURL=feature-flag.d.ts.map

package/dist/feature-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.d.ts","sourceRoot":"","sources":["../src/feature-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;oEACgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB;oFACgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;sEACkE;IAClE,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAWT;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,GAAG,SAAS,GACpC,OAAO,GAAG,QAAQ,CAGpB"}

package/dist/feature-flag.js

@@ -0,0 +1,58 @@
+/**
+ * Feature flag support for gradual rollout and rollback (spec §12, §14.1).
+ *
+ * The SDK is the single production classification core. A feature flag
+ * controls whether the SDK path is active for a given request and which
+ * engine (rules / logreg) runs. Rollback = disable the flag or pin a
+ * previous SDK package version — no parallel classifier is kept.
+ */
+// ---------------------------------------------------------------------------
+// Evaluation
+// ---------------------------------------------------------------------------
+/**
+ * FNV-1a 32-bit hash — deterministic, fast, no dependencies.
+ * Used for stable percentage bucketing.
+ */
+function fnv1aHash(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    // Force unsigned 32-bit
+    return hash >>> 0;
+}
+/**
+ * Determine whether the SDK face-shape path should be active for a given
+ * request.
+ *
+ * - `enabled: false` → always `false`.
+ * - `rolloutPercentage >= 100` (or unset) → `true`.
+ * - Otherwise, hash `stableId` to a 0–99 bucket and compare.
+ *
+ * When no `stableId` is provided, the flag is all-or-nothing: `enabled`
+ * alone decides.
+ */
+export function evaluateFeatureFlag(config, stableId) {
+    if (!config.enabled)
+        return false;
+    const pct = config.rolloutPercentage;
+    if (pct == null || pct >= 100)
+        return true;
+    if (pct <= 0)
+        return false;
+    if (!stableId)
+        return true; // no bucketing key → treat as enabled
+    const bucket = fnv1aHash(stableId) % 100;
+    return bucket < pct;
+}
+/**
+ * Resolve the effective engine, honouring the flag override.
+ * Falls back to `"rules"` when the flag is disabled or no override is set.
+ */
+export function resolveEngine(config) {
+    if (!config?.enabled)
+        return "rules";
+    return config.engine ?? "rules";
+}
+//# sourceMappingURL=feature-flag.js.map

package/dist/feature-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag.js","sourceRoot":"","sources":["../src/feature-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwBH,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,wBAAwB;IACxB,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAyB,EACzB,QAAiB;IAEjB,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAElC,MAAM,GAAG,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACrC,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,sCAAsC;IAElE,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;IACzC,OAAO,MAAM,GAAG,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAqC;IAErC,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC;AAClC,CAAC"}

package/dist/i18n/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * VisuTry SDK — lightweight i18n for user-facing error messages.
+ *
+ * The SDK keeps all hard-coded user-facing strings behind the `t()` lookup so
+ * that platform adapters (web / wechat) and host applications can localise the
+ * error messages surfaced to end users. The message catalogue is intentionally
+ * small: it only covers the canonical SDK error strings emitted via
+ * `createSDKError`. Callers can switch the active locale at runtime with
+ * `setLocale()`; unknown keys fall back to English, then to the key itself.
+ */
+export type Locale = "en" | "zh-CN" | "ja" | "ko";
+export declare function setLocale(locale: Locale): void;
+export declare function getLocale(): Locale;
+export declare function t(key: string): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;AA2ElD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErC"}