@scanly/browser 2.0.0

package/dist/scanner/camera-platform.js

@@ -0,0 +1,145 @@
+import { sdkError } from "@scanly/core";
+const record = (value) => {
+    if (!value || typeof value !== "object")
+        return "unavailable";
+    return { ...value };
+};
+function safeCall(read) {
+    try {
+        return read?.();
+    }
+    catch {
+        return undefined;
+    }
+}
+export function cameraError(error, fallback = "Camera operation failed.") {
+    const existing = error;
+    if (existing?.code && existing.category && existing.message && typeof existing.retryable === "boolean")
+        return existing;
+    const value = error;
+    const name = value?.name ?? "";
+    const message = (value?.message || String(error || fallback)).slice(0, 2_048);
+    const code = name === "NotAllowedError" || name === "SecurityError" || /permission denied|not allowed/i.test(message)
+        ? "camera_permission_denied"
+        : name === "NotFoundError" || name === "DevicesNotFoundError" || /requested device not found|no camera/i.test(message)
+            ? "camera_not_found"
+            : name === "NotReadableError" || name === "TrackStartError" || /could not start video source|camera.*busy/i.test(message)
+                ? "camera_busy"
+                : name === "OverconstrainedError" || name === "ConstraintNotSatisfiedError" || /constraint/i.test(message)
+                    ? "camera_constraint_failed"
+                    : /track ended/i.test(message)
+                        ? "camera_track_ended"
+                        : "source_disconnected";
+    return sdkError(code, message || fallback, { browserErrorName: name || "unavailable" }, error);
+}
+function supportedMediaConstraints() {
+    if (typeof navigator === "undefined")
+        return undefined;
+    return safeCall(() => navigator.mediaDevices?.getSupportedConstraints?.());
+}
+function preferredConstraints(policy) {
+    const supported = supportedMediaConstraints();
+    const accepts = (key) => supported?.[key] !== false;
+    return {
+        ...(policy.deviceId && accepts("deviceId")
+            ? { deviceId: policy.exactDevice === false ? { ideal: policy.deviceId } : { exact: policy.deviceId } }
+            : {}),
+        ...(policy.facingMode && accepts("facingMode") ? { facingMode: { ideal: policy.facingMode } } : {}),
+        ...(policy.preferredWidth && accepts("width") ? { width: { ideal: policy.preferredWidth } } : {}),
+        ...(policy.preferredHeight && accepts("height") ? { height: { ideal: policy.preferredHeight } } : {}),
+        ...(policy.preferredFrameRate && accepts("frameRate") ? { frameRate: { ideal: policy.preferredFrameRate } } : {}),
+    };
+}
+function negotiationCandidates(policy) {
+    const preferred = preferredConstraints(policy);
+    const fixedDevice = policy.deviceId
+        ? { deviceId: policy.exactDevice === false ? { ideal: policy.deviceId } : { exact: policy.deviceId } }
+        : {};
+    const facing = policy.facingMode ? { facingMode: { ideal: policy.facingMode } } : {};
+    const candidates = [preferred];
+    candidates.push({ ...fixedDevice, ...facing });
+    candidates.push(Object.keys(fixedDevice).length > 0 ? fixedDevice : true);
+    const maximum = Math.max(1, Math.min(4, Math.floor(policy.maximumAttempts ?? 3)));
+    return candidates.filter((candidate, index, values) => index === values.findIndex((entry) => JSON.stringify(entry) === JSON.stringify(candidate))).slice(0, maximum);
+}
+export async function negotiateCameraStream(policy) {
+    if (typeof navigator === "undefined" || !navigator.mediaDevices?.getUserMedia) {
+        throw cameraError({ name: "NotSupportedError", message: "Camera capture is not supported by this browser." });
+    }
+    const attempts = [];
+    let finalError;
+    for (const [index, constraints] of negotiationCandidates(policy).entries()) {
+        try {
+            const stream = await navigator.mediaDevices.getUserMedia({ video: constraints, audio: false });
+            attempts.push({ index: index + 1, constraints, result: "negotiated" });
+            const track = stream.getVideoTracks()[0];
+            const supported = supportedMediaConstraints();
+            return {
+                stream,
+                diagnostics: {
+                    requestedConstraints: { ...policy },
+                    supportedConstraints: supported ? { ...supported } : "unavailable",
+                    attempts,
+                    negotiatedSettings: record(safeCall(() => track?.getSettings?.())),
+                    trackCapabilities: record(safeCall(() => track?.getCapabilities?.())),
+                    trackConstraints: record(safeCall(() => track?.getConstraints?.())),
+                },
+            };
+        }
+        catch (error) {
+            finalError = error;
+            const typed = cameraError(error);
+            attempts.push({ index: index + 1, constraints, result: "failed", errorCode: typed.code, errorMessage: typed.message });
+            if (typed.code !== "camera_constraint_failed")
+                break;
+        }
+    }
+    const typed = cameraError(finalError);
+    typed.details = { ...typed.details, negotiationAttempts: attempts.length };
+    throw typed;
+}
+export function diagnosticsForTrack(policy, track, attempts = []) {
+    const supported = supportedMediaConstraints();
+    return {
+        requestedConstraints: { ...policy },
+        supportedConstraints: supported ? { ...supported } : "unavailable",
+        attempts,
+        negotiatedSettings: record(safeCall(() => track?.getSettings?.())),
+        trackCapabilities: record(safeCall(() => track?.getCapabilities?.())),
+        trackConstraints: record(safeCall(() => track?.getConstraints?.())),
+    };
+}
+export class CameraRecoveryController {
+    attempts = 0;
+    restarts = 0;
+    failures = 0;
+    exhausted = false;
+    maximumRetries;
+    baseDelayMs;
+    maximumDelayMs;
+    waiter;
+    constructor(policy = {}) {
+        this.maximumRetries = Math.max(0, Math.min(10, Math.floor(policy.maximumRetries ?? 3)));
+        this.baseDelayMs = Math.max(0, Math.min(10_000, Math.floor(policy.baseDelayMs ?? 200)));
+        this.maximumDelayMs = Math.max(this.baseDelayMs, Math.min(30_000, Math.floor(policy.maximumDelayMs ?? 2_000)));
+        this.waiter = policy.wait ?? ((delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs)));
+    }
+    next(reason) {
+        if (this.attempts >= this.maximumRetries) {
+            this.exhausted = true;
+            return { retry: false, attempt: this.attempts, delayMs: 0, reason };
+        }
+        this.attempts += 1;
+        const delayMs = Math.min(this.maximumDelayMs, this.baseDelayMs * (2 ** (this.attempts - 1)));
+        return { retry: true, attempt: this.attempts, delayMs, reason };
+    }
+    async wait(decision) {
+        if (decision.retry && decision.delayMs > 0)
+            await this.waiter(decision.delayMs);
+    }
+    markRestarted() { this.restarts += 1; }
+    markFailed() { this.failures += 1; }
+    reset() { this.attempts = 0; this.restarts = 0; this.failures = 0; this.exhausted = false; }
+    getStatistics() { return { attempts: this.attempts, restarts: this.restarts, failures: this.failures, exhausted: this.exhausted }; }
+}
+//# sourceMappingURL=camera-platform.js.map

package/dist/scanner/camera-platform.js.map

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

package/dist/scanner/decode-escalation.d.ts

@@ -0,0 +1,20 @@
+import type { DecodeProfile, FrameQuality } from "./types.js";
+export interface BoundedDecodeEscalationOptions {
+    balancedEveryMisses?: number;
+    robustAfterMisses?: number;
+    robustCooldownFrames?: number;
+}
+/** Deterministic Fast-first escalation; Robust is always separated by a cooldown. */
+export declare class BoundedDecodeEscalation {
+    private readonly options;
+    private misses;
+    private frame;
+    private lastRobustFrame;
+    private lastSuccessAt;
+    constructor(options?: BoundedDecodeEscalationOptions);
+    select(quality: FrameQuality, hasStableRoi: boolean, now?: number): DecodeProfile;
+    observe(success: boolean, now?: number): void;
+    reset(): void;
+    get consecutiveMisses(): number;
+}
+//# sourceMappingURL=decode-escalation.d.ts.map

package/dist/scanner/decode-escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-escalation.d.ts","sourceRoot":"","sources":["../../src/scanner/decode-escalation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,8BAA8B;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qFAAqF;AACrF,qBAAa,uBAAuB;IAMtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,aAAa,CAAK;gBAEG,OAAO,GAAE,8BAAmC;IAEzE,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,aAAa;IAerF,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,IAAI;IAKjD,KAAK,IAAI,IAAI;IACb,IAAI,iBAAiB,IAAI,MAAM,CAAwB;CACxD"}

package/dist/scanner/decode-escalation.js

@@ -0,0 +1,40 @@
+/** Deterministic Fast-first escalation; Robust is always separated by a cooldown. */
+export class BoundedDecodeEscalation {
+    options;
+    misses = 0;
+    frame = 0;
+    lastRobustFrame = Number.NEGATIVE_INFINITY;
+    lastSuccessAt = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    select(quality, hasStableRoi, now = Date.now()) {
+        this.frame += 1;
+        const balancedEvery = Math.max(2, this.options.balancedEveryMisses ?? 4);
+        const robustAfter = Math.max(balancedEvery + 1, this.options.robustAfterMisses ?? 8);
+        const cooldown = Math.max(2, this.options.robustCooldownFrames ?? 12);
+        // A stable ROI is preferred, but a bounded full-frame Robust probe is still
+        // necessary when the first code has not been found yet. This avoids a
+        // policy deadlock where Robust could never run because ROI only appears
+        // after a successful decode.
+        const robustEligible = quality.usable && (hasStableRoi || this.misses >= robustAfter + balancedEvery) && this.misses >= robustAfter && this.frame - this.lastRobustFrame >= cooldown && now - this.lastSuccessAt > 500;
+        if (robustEligible) {
+            this.lastRobustFrame = this.frame;
+            return "robust";
+        }
+        if (quality.usable && this.misses > 0 && this.misses % balancedEvery === 0)
+            return "balanced";
+        return "fast";
+    }
+    observe(success, now = Date.now()) {
+        if (success) {
+            this.misses = 0;
+            this.lastSuccessAt = now;
+        }
+        else
+            this.misses = Math.min(10_000, this.misses + 1);
+    }
+    reset() { this.misses = 0; this.frame = 0; this.lastRobustFrame = Number.NEGATIVE_INFINITY; this.lastSuccessAt = 0; }
+    get consecutiveMisses() { return this.misses; }
+}
+//# sourceMappingURL=decode-escalation.js.map

package/dist/scanner/decode-escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-escalation.js","sourceRoot":"","sources":["../../src/scanner/decode-escalation.ts"],"names":[],"mappings":"AAQA,qFAAqF;AACrF,MAAM,OAAO,uBAAuB;IAML;IALrB,MAAM,GAAG,CAAC,CAAC;IACX,KAAK,GAAG,CAAC,CAAC;IACV,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC3C,aAAa,GAAG,CAAC,CAAC;IAE1B,YAA6B,UAA0C,EAAE;QAA5C,YAAO,GAAP,OAAO,CAAqC;IAAG,CAAC;IAE7E,MAAM,CAAC,OAAqB,EAAE,YAAqB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACnE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAChB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,CAAC;QACzE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QACtE,4EAA4E;QAC5E,sEAAsE;QACtE,wEAAwE;QACxE,6BAA6B;QAC7B,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,GAAG,aAAa,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,IAAI,QAAQ,IAAI,GAAG,GAAG,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QACvN,IAAI,cAAc,EAAE,CAAC;YAAC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC;YAAC,OAAO,QAAQ,CAAC;QAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,aAAa,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;QAC9F,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,OAAgB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;QACxC,IAAI,OAAO,EAAE,CAAC;YAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAAC,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QAAC,CAAC;;YACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,KAAW,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3H,IAAI,iBAAiB,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;CACxD"}

package/dist/scanner/frame-quality.d.ts

@@ -0,0 +1,24 @@
+import { type BarcodeDifficultyDiagnosis, type NormalizedFrame } from "@scanly/core";
+import type { FrameQuality } from "./types.js";
+export interface FrameQualityAnalyzerOptions {
+    sampleTarget?: number;
+    underexposedThreshold?: number;
+    overexposedThreshold?: number;
+    blurThreshold?: number;
+    contrastThreshold?: number;
+    glareThreshold?: number;
+}
+/** Low-cost luminance/gradient quality analysis; no ML model or retained frame buffer. */
+export declare class FrameQualityAnalyzer {
+    private readonly options;
+    private previous;
+    private previousShape;
+    private readonly difficultyAnalyzer;
+    constructor(options?: FrameQualityAnalyzerOptions);
+    analyze(frame: NormalizedFrame): FrameQuality;
+    reset(): void;
+    /** Separate Beta 3 routing evidence; this does not turn quality heuristics into Ground Truth. */
+    diagnose(frame: NormalizedFrame, quality?: FrameQuality): BarcodeDifficultyDiagnosis;
+    private luminance;
+}
+//# sourceMappingURL=frame-quality.d.ts.map

package/dist/scanner/frame-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-quality.d.ts","sourceRoot":"","sources":["../../src/scanner/frame-quality.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,0BAA0B,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,2BAA2B;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,0FAA0F;AAC1F,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA4B;gBAElC,OAAO,GAAE,2BAAgC;IAItE,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY;IAiE7C,KAAK,IAAI,IAAI;IAEb,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,eAAsB,GAAG,0BAA0B;IAI3F,OAAO,CAAC,SAAS;CAOlB"}

package/dist/scanner/frame-quality.js

@@ -0,0 +1,90 @@
+import { BarcodeDifficultyAnalyzer } from "@scanly/core";
+function clamp01(value) { return Math.max(0, Math.min(1, value)); }
+/** Low-cost luminance/gradient quality analysis; no ML model or retained frame buffer. */
+export class FrameQualityAnalyzer {
+    options;
+    previous = null;
+    previousShape = "";
+    difficultyAnalyzer;
+    constructor(options = {}) {
+        this.options = options;
+        this.difficultyAnalyzer = new BarcodeDifficultyAnalyzer({ sampleTarget: options.sampleTarget });
+    }
+    analyze(frame) {
+        const target = Math.max(64, Math.min(4_096, this.options.sampleTarget ?? 1_024));
+        const stride = Math.max(1, Math.floor(Math.sqrt((frame.width * frame.height) / target)));
+        const values = [];
+        let sum = 0;
+        let sumSquares = 0;
+        let glare = 0;
+        let edgeSum = 0;
+        let edgeSquares = 0;
+        let edgeCount = 0;
+        let previousRow = null;
+        for (let y = 0; y < frame.height; y += stride) {
+            const row = [];
+            for (let x = 0; x < frame.width; x += stride) {
+                const luminance = this.luminance(frame, x, y);
+                values.push(luminance);
+                row.push(luminance);
+                sum += luminance;
+                sumSquares += luminance * luminance;
+                if (luminance >= 250)
+                    glare += 1;
+                const left = row.length > 1 ? row[row.length - 2] : luminance;
+                const above = previousRow?.[row.length - 1] ?? luminance;
+                const gradient = Math.abs(luminance - left) + Math.abs(luminance - above);
+                edgeSum += gradient;
+                edgeSquares += gradient * gradient;
+                edgeCount += 1;
+            }
+            previousRow = row;
+        }
+        const count = Math.max(1, values.length);
+        const mean = sum / count;
+        const variance = Math.max(0, sumSquares / count - mean * mean);
+        const gradientMean = edgeSum / Math.max(1, edgeCount);
+        const gradientVariance = Math.max(0, edgeSquares / Math.max(1, edgeCount) - gradientMean * gradientMean);
+        const brightness = clamp01(mean / 255);
+        const contrast = clamp01(Math.sqrt(variance) / 96);
+        const edgeDensity = clamp01(gradientMean / 64);
+        const blurScore = clamp01((gradientVariance + gradientMean * gradientMean) / 2_500);
+        const glareRatio = glare / count;
+        const current = Float32Array.from(values, (value) => value / 255);
+        const shape = `${frame.width}x${frame.height}:${stride}:${current.length}`;
+        let motionEstimate;
+        if (this.previous && this.previousShape === shape && this.previous.length === current.length) {
+            let delta = 0;
+            for (let index = 0; index < current.length; index += 1)
+                delta += Math.abs(current[index] - this.previous[index]);
+            motionEstimate = clamp01(delta / current.length);
+        }
+        this.previous = current;
+        this.previousShape = shape;
+        const underexposed = brightness < (this.options.underexposedThreshold ?? 0.12);
+        const overexposed = brightness > (this.options.overexposedThreshold ?? 0.92);
+        const blurred = blurScore < (this.options.blurThreshold ?? 0.08);
+        const glareDominated = glareRatio > (this.options.glareThreshold ?? 0.22);
+        const lowContrast = contrast < (this.options.contrastThreshold ?? 0.08);
+        return {
+            blurScore, brightness, contrast, glareRatio, edgeDensity,
+            ...(motionEstimate === undefined ? {} : { motionEstimate }),
+            underexposed, overexposed, blurred, glareDominated,
+            usable: !(underexposed || overexposed || blurred || glareDominated || lowContrast),
+        };
+    }
+    reset() { this.previous = null; this.previousShape = ""; }
+    /** Separate Beta 3 routing evidence; this does not turn quality heuristics into Ground Truth. */
+    diagnose(frame, quality = this.analyze(frame)) {
+        return this.difficultyAnalyzer.analyze(frame, quality);
+    }
+    luminance(frame, x, y) {
+        const row = y * frame.rowStride;
+        if (frame.pixelFormat === "gray8" || frame.pixelFormat === "yuv420")
+            return frame.data[row + x] ?? 0;
+        const channels = frame.pixelFormat === "rgba8888" ? 4 : 3;
+        const offset = row + x * channels;
+        return (frame.data[offset] ?? 0) * 0.2126 + (frame.data[offset + 1] ?? 0) * 0.7152 + (frame.data[offset + 2] ?? 0) * 0.0722;
+    }
+}
+//# sourceMappingURL=frame-quality.js.map

package/dist/scanner/frame-quality.js.map

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

package/dist/scanner/frame-scheduler.d.ts

@@ -0,0 +1,59 @@
+import type { NormalizedFrame } from "@scanly/core";
+import type { FrameQuality } from "./types.js";
+export interface FrameSchedulerOptions {
+    initialDecodeFps?: number;
+    minimumDecodeFps?: number;
+    maximumDecodeFps?: number;
+    now?: () => number;
+    onAdmitted?: () => void;
+    onDropped?: () => void;
+    onState?: (state: {
+        active: number;
+        pending: number;
+        peakPending: number;
+        effectiveDecodeFps: number;
+    }) => void;
+}
+export interface FrameProcessFeedback {
+    decodeMs?: number;
+    success?: boolean;
+    quality?: FrameQuality;
+}
+/** One-active-decode scheduler with latest-frame replacement and adaptive sampling cadence. */
+export declare class FrameScheduler {
+    private readonly process;
+    private readonly options;
+    private running;
+    private paused;
+    private active;
+    private pending;
+    private timer;
+    private activePromise;
+    private idleWaiters;
+    private targetFps;
+    private peakPending;
+    private completed;
+    private startedAt;
+    constructor(process: (frame: NormalizedFrame) => Promise<FrameProcessFeedback | void>, options?: FrameSchedulerOptions);
+    start(): void;
+    pause(): void;
+    resume(): void;
+    submit(frame: NormalizedFrame): "admitted" | "queued-latest" | "dropped";
+    waitForIdle(): Promise<void>;
+    stop(): Promise<void>;
+    reset(): void;
+    getStatistics(): {
+        active: number;
+        pending: number;
+        peakPending: number;
+        effectiveDecodeFps: number;
+        targetDecodeFps: number;
+    };
+    private drain;
+    private adapt;
+    private boundFps;
+    private release;
+    private resolveIdle;
+    private notify;
+}
+//# sourceMappingURL=frame-scheduler.d.ts.map

package/dist/scanner/frame-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-scheduler.d.ts","sourceRoot":"","sources":["../../src/scanner/frame-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACjH;AAED,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE;AAEtG,+FAA+F;AAC/F,qBAAa,cAAc;IAcvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAd1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;gBAGH,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,EACzE,OAAO,GAAE,qBAA0B;IAKtD,KAAK,IAAI,IAAI;IAOb,KAAK,IAAI,IAAI;IAYb,MAAM,IAAI,IAAI;IAEd,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS;IAmBlE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,KAAK,IAAI,IAAI;IAOb,aAAa,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IAK9H,OAAO,CAAC,KAAK;IA0Bb,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,MAAM;CAIf"}

package/dist/scanner/frame-scheduler.js

@@ -0,0 +1,148 @@
+/** One-active-decode scheduler with latest-frame replacement and adaptive sampling cadence. */
+export class FrameScheduler {
+    process;
+    options;
+    running = false;
+    paused = false;
+    active = false;
+    pending = null;
+    timer = null;
+    activePromise = null;
+    idleWaiters = new Set();
+    targetFps;
+    peakPending = 0;
+    completed = 0;
+    startedAt = 0;
+    constructor(process, options = {}) {
+        this.process = process;
+        this.options = options;
+        this.targetFps = this.boundFps(options.initialDecodeFps ?? 10);
+    }
+    start() {
+        this.running = true;
+        this.paused = false;
+        this.startedAt = this.options.now?.() ?? Date.now();
+        this.drain();
+    }
+    pause() {
+        this.paused = true;
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+        if (this.pending) {
+            this.release(this.pending);
+            this.pending = null;
+            this.options.onDropped?.();
+        }
+        this.resolveIdle();
+        this.notify();
+    }
+    resume() { if (!this.running)
+        return; this.paused = false; this.drain(); }
+    submit(frame) {
+        if (!this.running || this.paused) {
+            this.release(frame);
+            this.options.onDropped?.();
+            this.notify();
+            return "dropped";
+        }
+        if (this.active || this.timer) {
+            if (this.pending) {
+                this.release(this.pending);
+                this.options.onDropped?.();
+            }
+            this.pending = frame;
+            this.peakPending = Math.max(this.peakPending, 1);
+            this.notify();
+            return "queued-latest";
+        }
+        this.pending = frame;
+        this.drain();
+        return "admitted";
+    }
+    async waitForIdle() {
+        if (!this.active && !this.pending && !this.timer)
+            return;
+        await new Promise((resolve) => this.idleWaiters.add(resolve));
+    }
+    async stop() {
+        this.running = false;
+        this.paused = false;
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+        if (this.pending)
+            this.release(this.pending);
+        this.pending = null;
+        await this.activePromise;
+        this.resolveIdle();
+        this.notify();
+    }
+    reset() {
+        this.targetFps = this.boundFps(this.options.initialDecodeFps ?? 10);
+        this.peakPending = 0;
+        this.completed = 0;
+        this.startedAt = this.options.now?.() ?? Date.now();
+    }
+    getStatistics() {
+        const elapsed = Math.max(1, (this.options.now?.() ?? Date.now()) - this.startedAt);
+        return { active: this.active ? 1 : 0, pending: this.pending ? 1 : 0, peakPending: this.peakPending, effectiveDecodeFps: this.completed * 1_000 / elapsed, targetDecodeFps: this.targetFps };
+    }
+    drain() {
+        if (!this.running || this.paused || this.active || this.timer || !this.pending) {
+            this.resolveIdle();
+            return;
+        }
+        const frame = this.pending;
+        this.pending = null;
+        this.active = true;
+        this.options.onAdmitted?.();
+        const started = this.options.now?.() ?? Date.now();
+        this.notify();
+        this.activePromise = (async () => {
+            try {
+                const feedback = await this.process(frame);
+                this.completed += 1;
+                const elapsed = feedback?.decodeMs ?? Math.max(0, (this.options.now?.() ?? Date.now()) - started);
+                this.adapt(elapsed, feedback?.quality, feedback?.success);
+            }
+            finally {
+                this.active = false;
+                this.activePromise = null;
+                const delay = Math.max(0, Math.round(1_000 / this.targetFps));
+                if (this.running && !this.paused && this.pending && delay > 0) {
+                    this.timer = setTimeout(() => { this.timer = null; this.drain(); }, delay);
+                }
+                else
+                    this.drain();
+                this.notify();
+            }
+        })();
+    }
+    adapt(decodeMs, quality, success) {
+        const maximum = this.options.maximumDecodeFps ?? 15;
+        const minimum = this.options.minimumDecodeFps ?? 5;
+        const latencyBound = decodeMs >= 180 ? minimum : decodeMs >= 85 ? Math.min(10, maximum) : maximum;
+        const qualityBound = quality && !quality.usable ? minimum : success === false ? Math.min(10, maximum) : maximum;
+        this.targetFps = this.boundFps(Math.min(latencyBound, qualityBound));
+    }
+    boundFps(value) {
+        const minimum = Math.max(0.1, this.options.minimumDecodeFps ?? 5);
+        const maximum = Math.max(minimum, this.options.maximumDecodeFps ?? 15);
+        return Math.max(minimum, Math.min(maximum, value));
+    }
+    release(frame) { if (frame.ownership !== "borrowed")
+        frame.dispose?.(); }
+    resolveIdle() {
+        if (this.active || this.pending || this.timer)
+            return;
+        for (const resolve of this.idleWaiters)
+            resolve();
+        this.idleWaiters.clear();
+    }
+    notify() {
+        const stats = this.getStatistics();
+        this.options.onState?.({ active: stats.active, pending: stats.pending, peakPending: stats.peakPending, effectiveDecodeFps: stats.effectiveDecodeFps });
+    }
+}
+//# sourceMappingURL=frame-scheduler.js.map

package/dist/scanner/frame-scheduler.js.map

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