@scanly/browser 2.0.0

package/dist/tracking/barcode-tracker.js

@@ -0,0 +1,279 @@
+import { associateTracks, DEFAULT_ASSOCIATION_THRESHOLD } from "./track-association.js";
+import { cloneGeometry, geometryCenter, isFiniteGeometry } from "./geometry.js";
+const DEFAULT_MAX_TRACKS = 32;
+const DEFAULT_MAX_OBSERVATIONS = 32;
+const DEFAULT_CONFIRMATION_OBSERVATIONS = 2;
+const DEFAULT_MAX_MISSED_FRAMES = 4;
+const DEFAULT_VELOCITY_SMOOTHING = 0.65;
+/** Deterministic, bounded multi-barcode physical-instance tracker. */
+export class BarcodeTracker {
+    options;
+    tracks = new Map();
+    associationLatencies = [];
+    sequence = 0;
+    lastProcessedFrameId;
+    pendingObservationCount = 0;
+    statistics = {
+        processedFrames: 0,
+        receivedObservations: 0,
+        consideredObservations: 0,
+        ignoredObservations: 0,
+        matchedObservationCount: 0,
+        createdTrackCount: 0,
+        confirmedTrackCount: 0,
+        lostTransitionCount: 0,
+        restoredTrackCount: 0,
+        retiredTrackCount: 0,
+        peakTrackCount: 0,
+    };
+    constructor(options = {}) {
+        this.options = {
+            maxTracks: positiveInteger(options.maxTracks ?? options.maxTrackedBarcodes, DEFAULT_MAX_TRACKS),
+            maxObservations: positiveInteger(options.maxObservations, DEFAULT_MAX_OBSERVATIONS),
+            associationThreshold: nonNegative(options.associationThreshold, DEFAULT_ASSOCIATION_THRESHOLD),
+            confirmationObservations: positiveInteger(options.confirmationObservations, DEFAULT_CONFIRMATION_OBSERVATIONS),
+            maxMissedFrames: nonNegativeInteger(options.maxMissedFrames, DEFAULT_MAX_MISSED_FRAMES),
+            velocitySmoothing: unitInterval(options.velocitySmoothing, DEFAULT_VELOCITY_SMOOTHING),
+            ...(options.association ? { association: { ...options.association } } : {}),
+        };
+    }
+    update(observations, frameOrId, timestamp = Date.now()) {
+        const frame = typeof frameOrId === "number" ? { frameId: frameOrId, timestamp } : frameOrId;
+        this.validateFrame(frame);
+        this.statistics.processedFrames += 1;
+        this.statistics.receivedObservations += observations.length;
+        this.pendingObservationCount = Math.min(observations.length, this.options.maxObservations);
+        const bounded = observations.slice(0, this.options.maxObservations);
+        const considered = bounded.filter((observation) => observation.payload.length > 0 && isFiniteGeometry(observation.geometry));
+        let ignoredObservationCount = observations.length - considered.length;
+        this.statistics.consideredObservations += considered.length;
+        const retiredBeforeAssociation = [];
+        const currentTracks = [...this.tracks.values()].filter((track) => {
+            const unseenFramesBeforeCurrent = Math.max(0, frame.frameId - track.lastFrameId - 1);
+            if (unseenFramesBeforeCurrent <= this.options.maxMissedFrames)
+                return true;
+            track.missedFrameCount = unseenFramesBeforeCurrent;
+            track.evaluatedFrameId = frame.frameId;
+            track.state = "retired";
+            retiredBeforeAssociation.push(snapshot(track));
+            this.tracks.delete(track.trackId);
+            this.statistics.retiredTrackCount += 1;
+            return false;
+        });
+        const started = monotonicNow();
+        const association = associateTracks(currentTracks, considered, frame.frameId, {
+            threshold: this.options.associationThreshold,
+            weights: this.options.association,
+            timestamp: frame.timestamp,
+        });
+        this.recordAssociationLatency(monotonicNow() - started);
+        const matchedTracks = [];
+        const updatedTracks = [];
+        const restoredTracks = [];
+        const lostTracks = [];
+        const retiredTracks = [...retiredBeforeAssociation];
+        const newTracks = [];
+        for (const match of association.matches) {
+            const track = currentTracks[match.trackIndex];
+            const observation = considered[match.observationIndex];
+            if (!track || !observation)
+                continue;
+            const previousState = track.state;
+            const wasConfirmed = track.everConfirmed;
+            this.applyObservation(track, observation, frame);
+            if (!wasConfirmed && track.everConfirmed)
+                this.statistics.confirmedTrackCount += 1;
+            if (previousState === "lost") {
+                restoredTracks.push(snapshot(track));
+                this.statistics.restoredTrackCount += 1;
+            }
+            const publicTrack = snapshot(track);
+            matchedTracks.push(publicTrack);
+            updatedTracks.push(publicTrack);
+            this.statistics.matchedObservationCount += 1;
+        }
+        for (const trackIndex of association.unmatchedTrackIndices) {
+            const track = currentTracks[trackIndex];
+            if (!track)
+                continue;
+            const priorState = track.state;
+            const frameDelta = Math.max(1, frame.frameId - track.evaluatedFrameId);
+            track.evaluatedFrameId = frame.frameId;
+            track.missedFrameCount += frameDelta;
+            if (track.missedFrameCount > this.options.maxMissedFrames) {
+                track.state = "retired";
+                retiredTracks.push(snapshot(track));
+                this.tracks.delete(track.trackId);
+                this.statistics.retiredTrackCount += 1;
+            }
+            else {
+                track.state = "lost";
+                if (priorState !== "lost") {
+                    lostTracks.push(snapshot(track));
+                    this.statistics.lostTransitionCount += 1;
+                }
+            }
+        }
+        const availableSlots = Math.max(0, this.options.maxTracks - this.tracks.size);
+        const observationsToCreate = association.unmatchedObservationIndices.slice(0, availableSlots);
+        ignoredObservationCount += association.unmatchedObservationIndices.length - observationsToCreate.length;
+        this.statistics.ignoredObservations += ignoredObservationCount;
+        for (const observationIndex of observationsToCreate) {
+            const observation = considered[observationIndex];
+            if (!observation)
+                continue;
+            const track = this.createTrack(observation, frame);
+            this.tracks.set(track.trackId, track);
+            newTracks.push(snapshot(track));
+            this.statistics.createdTrackCount += 1;
+            if (track.everConfirmed)
+                this.statistics.confirmedTrackCount += 1;
+        }
+        this.lastProcessedFrameId = frame.frameId;
+        this.pendingObservationCount = 0;
+        this.statistics.peakTrackCount = Math.max(this.statistics.peakTrackCount, this.tracks.size);
+        const tracks = this.getTracks();
+        return {
+            frameId: frame.frameId,
+            timestamp: frame.timestamp,
+            matchedTracks,
+            newTracks,
+            updatedTracks,
+            lostTracks,
+            restoredTracks,
+            retiredTracks,
+            tracks,
+            ignoredObservationCount,
+            association,
+        };
+    }
+    /** Alias that emphasizes the required one-complete-observation-set-per-frame contract. */
+    observeFrame(observations, frame) {
+        return this.update(observations, frame);
+    }
+    getTracks() {
+        return [...this.tracks.values()].map(snapshot);
+    }
+    getTrack(trackId) {
+        const track = this.tracks.get(trackId);
+        return track ? snapshot(track) : undefined;
+    }
+    get size() { return this.tracks.size; }
+    get lostSize() { return [...this.tracks.values()].filter((track) => track.state === "lost").length; }
+    getStatistics() {
+        return {
+            ...this.statistics,
+            activeTrackCount: this.tracks.size,
+            lostTrackCount: this.lostSize,
+            pendingObservationCount: this.pendingObservationCount,
+            associationP50Ms: percentile(this.associationLatencies, 0.5),
+            associationP95Ms: percentile(this.associationLatencies, 0.95),
+        };
+    }
+    reset() {
+        this.tracks.clear();
+        this.associationLatencies.length = 0;
+        this.lastProcessedFrameId = undefined;
+        this.pendingObservationCount = 0;
+    }
+    dispose() { this.reset(); }
+    createTrack(observation, frame) {
+        const sequence = ++this.sequence;
+        const confirmed = this.options.confirmationObservations <= 1;
+        return {
+            trackId: `track-${sequence}`,
+            physicalInstanceId: `physical-${sequence}`,
+            payload: observation.payload,
+            format: observation.format,
+            state: confirmed ? "confirmed" : "tentative",
+            firstSeenAt: frame.timestamp,
+            lastSeenAt: frame.timestamp,
+            firstFrameId: frame.frameId,
+            lastFrameId: frame.frameId,
+            observationCount: 1,
+            missedFrameCount: 0,
+            geometry: cloneGeometry(observation.geometry),
+            everConfirmed: confirmed,
+            evaluatedFrameId: frame.frameId,
+        };
+    }
+    applyObservation(track, observation, frame) {
+        const oldCenter = geometryCenter(track.geometry);
+        const newCenter = geometryCenter(observation.geometry);
+        const frameDelta = Math.max(1, frame.frameId - track.lastFrameId);
+        const measured = { x: (newCenter.x - oldCenter.x) / frameDelta, y: (newCenter.y - oldCenter.y) / frameDelta };
+        const alpha = this.options.velocitySmoothing;
+        track.velocity = track.velocity
+            ? {
+                x: measured.x * alpha + track.velocity.x * (1 - alpha),
+                y: measured.y * alpha + track.velocity.y * (1 - alpha),
+            }
+            : measured;
+        track.lastSeenAt = frame.timestamp;
+        track.lastFrameId = frame.frameId;
+        track.evaluatedFrameId = frame.frameId;
+        track.observationCount += 1;
+        track.missedFrameCount = 0;
+        track.geometry = cloneGeometry(observation.geometry);
+        if (track.everConfirmed || track.observationCount >= this.options.confirmationObservations) {
+            track.everConfirmed = true;
+            track.state = "confirmed";
+        }
+        else {
+            track.state = "tentative";
+        }
+    }
+    validateFrame(frame) {
+        if (!Number.isInteger(frame.frameId) || frame.frameId < 0)
+            throw new RangeError("Tracking frameId must be a non-negative integer.");
+        if (!Number.isFinite(frame.timestamp))
+            throw new RangeError("Tracking timestamp must be finite.");
+        if (this.lastProcessedFrameId !== undefined && frame.frameId <= this.lastProcessedFrameId) {
+            throw new RangeError("BarcodeTracker requires one complete observation set per monotonically increasing frameId.");
+        }
+    }
+    recordAssociationLatency(value) {
+        this.associationLatencies.push(Math.max(0, value));
+        if (this.associationLatencies.length > 512)
+            this.associationLatencies.shift();
+    }
+}
+function snapshot(track) {
+    return {
+        trackId: track.trackId,
+        physicalInstanceId: track.physicalInstanceId,
+        payload: track.payload,
+        format: track.format,
+        state: track.state,
+        firstSeenAt: track.firstSeenAt,
+        lastSeenAt: track.lastSeenAt,
+        firstFrameId: track.firstFrameId,
+        lastFrameId: track.lastFrameId,
+        observationCount: track.observationCount,
+        missedFrameCount: track.missedFrameCount,
+        geometry: cloneGeometry(track.geometry),
+        ...(track.velocity ? { velocity: { ...track.velocity } } : {}),
+    };
+}
+function monotonicNow() {
+    return typeof performance === "undefined" ? Date.now() : performance.now();
+}
+function percentile(values, quantile) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    return sorted[Math.min(sorted.length - 1, Math.max(0, Math.ceil(sorted.length * quantile) - 1))] ?? 0;
+}
+function positiveInteger(value, fallback) {
+    return value === undefined || !Number.isFinite(value) ? fallback : Math.max(1, Math.floor(value));
+}
+function nonNegativeInteger(value, fallback) {
+    return value === undefined || !Number.isFinite(value) ? fallback : Math.max(0, Math.floor(value));
+}
+function nonNegative(value, fallback) {
+    return value === undefined || !Number.isFinite(value) ? fallback : Math.max(0, value);
+}
+function unitInterval(value, fallback) {
+    return value === undefined || !Number.isFinite(value) ? fallback : Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=barcode-tracker.js.map

package/dist/tracking/barcode-tracker.js.map

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

package/dist/tracking/geometry.d.ts

@@ -0,0 +1,13 @@
+import type { BarcodeGeometry } from "../scanner/types.js";
+export interface Point {
+    x: number;
+    y: number;
+}
+export declare function geometryCenter(geometry: BarcodeGeometry): Point;
+export declare function geometryArea(geometry: BarcodeGeometry): number;
+export declare function geometryIoU(a: BarcodeGeometry, b: BarcodeGeometry): number;
+export declare function geometryDistanceScale(a: BarcodeGeometry, b: BarcodeGeometry): number;
+export declare function translateGeometry(geometry: BarcodeGeometry, x: number, y: number): BarcodeGeometry;
+export declare function cloneGeometry(geometry: BarcodeGeometry): BarcodeGeometry;
+export declare function isFiniteGeometry(geometry: BarcodeGeometry): boolean;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/tracking/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/tracking/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,KAAK;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE;AAI/C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,KAAK,CAG/D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAE9D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,MAAM,CAQ1E;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,MAAM,CASpF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,eAAe,CAYlG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAOxE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAGnE"}

package/dist/tracking/geometry.js

@@ -0,0 +1,51 @@
+const EPSILON = 1e-9;
+export function geometryCenter(geometry) {
+    const box = geometry.boundingBox;
+    return { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+}
+export function geometryArea(geometry) {
+    return Math.max(EPSILON, Math.max(0, geometry.boundingBox.width) * Math.max(0, geometry.boundingBox.height));
+}
+export function geometryIoU(a, b) {
+    const left = Math.max(a.boundingBox.x, b.boundingBox.x);
+    const top = Math.max(a.boundingBox.y, b.boundingBox.y);
+    const right = Math.min(a.boundingBox.x + Math.max(0, a.boundingBox.width), b.boundingBox.x + Math.max(0, b.boundingBox.width));
+    const bottom = Math.min(a.boundingBox.y + Math.max(0, a.boundingBox.height), b.boundingBox.y + Math.max(0, b.boundingBox.height));
+    const intersection = Math.max(0, right - left) * Math.max(0, bottom - top);
+    const union = geometryArea(a) + geometryArea(b) - intersection;
+    return union <= EPSILON ? 0 : Math.max(0, Math.min(1, intersection / union));
+}
+export function geometryDistanceScale(a, b) {
+    const frameWidth = Math.max(a.frameWidth ?? 0, b.frameWidth ?? 0);
+    const frameHeight = Math.max(a.frameHeight ?? 0, b.frameHeight ?? 0);
+    if (frameWidth > 0 && frameHeight > 0)
+        return Math.max(EPSILON, Math.hypot(frameWidth, frameHeight) * 0.25);
+    const largestSymbolDiagonal = Math.max(Math.hypot(a.boundingBox.width, a.boundingBox.height), Math.hypot(b.boundingBox.width, b.boundingBox.height));
+    return Math.max(EPSILON, largestSymbolDiagonal * 4);
+}
+export function translateGeometry(geometry, x, y) {
+    return {
+        cornerPoints: geometry.cornerPoints.map((point) => ({ x: point.x + x, y: point.y + y })),
+        boundingBox: {
+            x: geometry.boundingBox.x + x,
+            y: geometry.boundingBox.y + y,
+            width: geometry.boundingBox.width,
+            height: geometry.boundingBox.height,
+        },
+        ...(geometry.frameWidth !== undefined ? { frameWidth: geometry.frameWidth } : {}),
+        ...(geometry.frameHeight !== undefined ? { frameHeight: geometry.frameHeight } : {}),
+    };
+}
+export function cloneGeometry(geometry) {
+    return {
+        cornerPoints: geometry.cornerPoints.map((point) => ({ ...point })),
+        boundingBox: { ...geometry.boundingBox },
+        ...(geometry.frameWidth !== undefined ? { frameWidth: geometry.frameWidth } : {}),
+        ...(geometry.frameHeight !== undefined ? { frameHeight: geometry.frameHeight } : {}),
+    };
+}
+export function isFiniteGeometry(geometry) {
+    const { x, y, width, height } = geometry.boundingBox;
+    return [x, y, width, height].every(Number.isFinite) && width > 0 && height > 0;
+}
+//# sourceMappingURL=geometry.js.map

package/dist/tracking/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/tracking/geometry.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,GAAG,IAAI,CAAC;AAErB,MAAM,UAAU,cAAc,CAAC,QAAyB;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC;IACjC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/G,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAkB,EAAE,CAAkB;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/H,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAClI,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC;IAC/D,OAAO,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAkB,EAAE,CAAkB;IAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IACrE,IAAI,UAAU,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5G,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,CACpC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EACrD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CACtD,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAyB,EAAE,CAAS,EAAE,CAAS;IAC/E,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxF,WAAW,EAAE;YACX,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC;YAC7B,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC;YAC7B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK;YACjC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM;SACpC;QACD,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAClE,WAAW,EAAE,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE;QACxC,GAAG,CAAC,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAyB;IACxD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC;IACrD,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AACjF,CAAC"}

package/dist/tracking/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./geometry.js";
+export * from "./track-association.js";
+export * from "./barcode-tracker.js";
+export * from "./track-roi-set.js";
+export * from "./track-overlay.js";
+export * from "./scanner-tracking-runtime.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC"}

package/dist/tracking/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./geometry.js";
+export * from "./track-association.js";
+export * from "./barcode-tracker.js";
+export * from "./track-roi-set.js";
+export * from "./track-overlay.js";
+export * from "./scanner-tracking-runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/tracking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracking/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC"}

package/dist/tracking/scanner-tracking-runtime.d.ts

@@ -0,0 +1,45 @@
+import type { NormalizedFrame } from "@scanly/core";
+import type { BarcodeObservationSet } from "../scanner/types.js";
+import type { DecodeProfile, ScannerDecodeROIPhase, TemporalROIHint } from "../scanner/types.js";
+import { BarcodeTracker } from "./barcode-tracker.js";
+import { TrackROISet } from "./track-roi-set.js";
+import type { BarcodeTrack, BarcodeTrackerOptions, TrackROIPlan, TrackROISetOptions, TrackingStatistics } from "./types.js";
+export interface ScannerTrackingRuntimeOptions {
+    tracker?: BarcodeTracker;
+    trackerOptions?: BarcodeTrackerOptions;
+    roiSet?: TrackROISet;
+    roi?: TrackROISetOptions;
+    /** Maximum observations retained from one bounded multi-code decode. */
+    maxResults?: number;
+    /** Optional profile pin; omitted to retain Beta 1 bounded escalation. */
+    profile?: DecodeProfile;
+    /** Non-global frames between one tracked-envelope request and an uncovered-cell request. */
+    uncoveredRegionIntervalFrames?: number;
+}
+export interface ScannerTrackingDecodeSelection {
+    phase: Exclude<ScannerDecodeROIPhase, "temporal">;
+    roi?: TemporalROIHint;
+    plan: TrackROIPlan;
+}
+/**
+ * Small composition layer between ScannerSession and BarcodeTracker. It turns
+ * a TrackROISet plan into one decode request per frame, keeping decode work
+ * independent of the number of live tracks.
+ */
+export declare class ScannerTrackingRuntime {
+    readonly maxResults: number;
+    readonly profile?: DecodeProfile;
+    private readonly tracker;
+    private readonly roiSet;
+    private readonly uncoveredRegionIntervalFrames;
+    private nonGlobalFrameCount;
+    private uncoveredCursor;
+    constructor(options?: ScannerTrackingRuntimeOptions);
+    selectDecode(frameId: number, frame: Pick<NormalizedFrame, "width" | "height">): ScannerTrackingDecodeSelection;
+    observe(set: BarcodeObservationSet): void;
+    getTracks(): readonly BarcodeTrack[];
+    getStatistics(): TrackingStatistics;
+    get controlledSize(): number;
+    reset(): void;
+}
+//# sourceMappingURL=scanner-tracking-runtime.d.ts.map

package/dist/tracking/scanner-tracking-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-tracking-runtime.d.ts","sourceRoot":"","sources":["../../src/tracking/scanner-tracking-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EAErB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,4FAA4F;IAC5F,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,OAAO,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAClD,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAS;IACvD,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,eAAe,CAAK;gBAEhB,OAAO,GAAE,6BAAkC;IAmBvD,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,QAAQ,CAAC,GAAG,8BAA8B;IAiC/G,OAAO,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI;IAQzC,SAAS,IAAI,SAAS,YAAY,EAAE;IACpC,aAAa,IAAI,kBAAkB;IACnC,IAAI,cAAc,IAAI,MAAM,CAAiD;IAE7E,KAAK,IAAI,IAAI;CAMd"}

package/dist/tracking/scanner-tracking-runtime.js

@@ -0,0 +1,93 @@
+import { BarcodeTracker } from "./barcode-tracker.js";
+import { TrackROISet } from "./track-roi-set.js";
+const DEFAULT_MAX_RESULTS = 32;
+const DEFAULT_UNCOVERED_INTERVAL = 2;
+/**
+ * Small composition layer between ScannerSession and BarcodeTracker. It turns
+ * a TrackROISet plan into one decode request per frame, keeping decode work
+ * independent of the number of live tracks.
+ */
+export class ScannerTrackingRuntime {
+    maxResults;
+    profile;
+    tracker;
+    roiSet;
+    uncoveredRegionIntervalFrames;
+    nonGlobalFrameCount = 0;
+    uncoveredCursor = 0;
+    constructor(options = {}) {
+        this.tracker = options.tracker ?? new BarcodeTracker(options.trackerOptions);
+        this.roiSet = options.roiSet ?? new TrackROISet(options.roi);
+        this.maxResults = positiveInteger(options.maxResults
+            ?? options.trackerOptions?.maxObservations
+            ?? options.trackerOptions?.maxTracks
+            ?? options.trackerOptions?.maxTrackedBarcodes, DEFAULT_MAX_RESULTS, DEFAULT_MAX_RESULTS);
+        this.profile = options.profile;
+        this.uncoveredRegionIntervalFrames = positiveInteger(options.uncoveredRegionIntervalFrames, DEFAULT_UNCOVERED_INTERVAL, Number.MAX_SAFE_INTEGER);
+    }
+    selectDecode(frameId, frame) {
+        const plan = this.roiSet.plan(this.tracker.getTracks(), { frameId, width: frame.width, height: frame.height });
+        if (plan.includeFullFrame) {
+            this.nonGlobalFrameCount = 0;
+            return { phase: "full-frame", plan };
+        }
+        this.nonGlobalFrameCount += 1;
+        const selectUncovered = plan.uncoveredRegions.length > 0
+            && this.nonGlobalFrameCount % this.uncoveredRegionIntervalFrames === 0;
+        if (selectUncovered) {
+            const region = plan.uncoveredRegions[this.uncoveredCursor % plan.uncoveredRegions.length];
+            this.uncoveredCursor += 1;
+            // One rectangular decode covers both the current tracks and one search
+            // cell. Existing tracks therefore remain observable while discovery is
+            // interleaved without adding a second decode call.
+            const combined = region ? roiEnvelope([...plan.trackedROIs, region]) : undefined;
+            if (combined) {
+                const maximumMisses = plan.trackedROIs.reduce((maximum, roi) => Math.max(maximum, roi.missCount), 0);
+                return { phase: "uncovered-regions", roi: hint(combined, maximumMisses), plan };
+            }
+        }
+        const envelope = roiEnvelope(plan.trackedROIs);
+        if (envelope) {
+            const maximumMisses = plan.trackedROIs.reduce((maximum, roi) => Math.max(maximum, roi.missCount), 0);
+            return { phase: "tracked-rois", roi: hint(envelope, maximumMisses), plan };
+        }
+        // Defensive fallback: an empty/invalid plan may never suppress recovery.
+        return { phase: "full-frame", plan };
+    }
+    observe(set) {
+        this.tracker.observeFrame(set.observations.flatMap((observation) => observation.geometry ? [{
+                payload: observation.barcode.text,
+                format: observation.barcode.format,
+                geometry: observation.geometry,
+            }] : []), { frameId: set.frameId, timestamp: set.timestamp });
+    }
+    getTracks() { return this.tracker.getTracks(); }
+    getStatistics() { return this.tracker.getStatistics(); }
+    get controlledSize() { return this.tracker.size + this.roiSet.size; }
+    reset() {
+        this.tracker.reset();
+        this.roiSet.reset();
+        this.nonGlobalFrameCount = 0;
+        this.uncoveredCursor = 0;
+    }
+}
+function roiEnvelope(rois) {
+    if (rois.length === 0)
+        return undefined;
+    const left = Math.min(...rois.map((roi) => roi.x));
+    const top = Math.min(...rois.map((roi) => roi.y));
+    const right = Math.max(...rois.map((roi) => roi.x + roi.width));
+    const bottom = Math.max(...rois.map((roi) => roi.y + roi.height));
+    if (![left, top, right, bottom].every(Number.isFinite) || right <= left || bottom <= top)
+        return undefined;
+    return { x: left, y: top, width: right - left, height: bottom - top };
+}
+function hint(region, missCount) {
+    return { ...region, ageMs: 0, missCount };
+}
+function positiveInteger(value, fallback, maximum) {
+    return value === undefined || !Number.isFinite(value)
+        ? fallback
+        : Math.max(1, Math.min(maximum, Math.floor(value)));
+}
+//# sourceMappingURL=scanner-tracking-runtime.js.map

package/dist/tracking/scanner-tracking-runtime.js.map

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

package/dist/tracking/track-association.d.ts

@@ -0,0 +1,19 @@
+import type { BarcodeTrack, BarcodeObservation, TrackAssociationResult, TrackAssociationWeights } from "./types.js";
+export declare const DEFAULT_ASSOCIATION_THRESHOLD = 2.5;
+export declare const DEFAULT_ASSOCIATION_WEIGHTS: Readonly<TrackAssociationWeights>;
+export interface TrackAssociationOptions {
+    threshold?: number;
+    weights?: Partial<TrackAssociationWeights>;
+    /** Current frame time, used to age associations after irregular capture. */
+    timestamp?: number;
+    /** Converts elapsed milliseconds to a comparable number of frame periods. */
+    nominalFrameDurationMs?: number;
+}
+export declare function calculateAssociationCost(track: BarcodeTrack, observation: BarcodeObservation, frameId: number, options?: TrackAssociationOptions): number;
+/**
+ * Globally minimizes the bounded track/observation cost matrix. Dummy columns
+ * model an unmatched track, so an over-threshold pair can never steal a valid
+ * observation from another track.
+ */
+export declare function associateTracks(tracks: readonly BarcodeTrack[], observations: readonly BarcodeObservation[], frameId: number, options?: TrackAssociationOptions): TrackAssociationResult;
+//# sourceMappingURL=track-association.d.ts.map

package/dist/tracking/track-association.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-association.d.ts","sourceRoot":"","sources":["../../src/tracking/track-association.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGpH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,eAAO,MAAM,2BAA2B,EAAE,QAAQ,CAAC,uBAAuB,CAWxE,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC3C,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,kBAAkB,EAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAkCR;AA0BD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,YAAY,EAAE,SAAS,kBAAkB,EAAE,EAC3C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAyCxB"}