@scanly/browser 2.0.0

package/dist/tracking/track-association.js

@@ -0,0 +1,191 @@
+import { geometryArea, geometryCenter, geometryDistanceScale, geometryIoU } from "./geometry.js";
+export const DEFAULT_ASSOCIATION_THRESHOLD = 2.5;
+export const DEFAULT_ASSOCIATION_WEIGHTS = Object.freeze({
+    // Compatibility weights remain explicit in the public cost schema, while
+    // the semantic eligibility gate below takes precedence over every weight.
+    payloadMismatch: 8,
+    formatMismatch: 8,
+    spatialDistance: 0.9,
+    iouPenalty: 0.35,
+    geometrySize: 0.25,
+    // Prediction helps at crossings, but current geometry has the larger weight.
+    motionPrediction: 0.7,
+    timeSinceObservation: 0.08,
+});
+export function calculateAssociationCost(track, observation, frameId, options = {}) {
+    // Payload and format identify what was decoded, not merely how expensive a
+    // spatial association should be. A semantic mismatch is never a candidate,
+    // even when callers deliberately raise the threshold or zero custom weights.
+    if (track.payload !== observation.payload || track.format !== observation.format) {
+        return Number.POSITIVE_INFINITY;
+    }
+    const weights = resolveWeights(options.weights);
+    const currentCenter = geometryCenter(track.geometry);
+    const observedCenter = geometryCenter(observation.geometry);
+    const elapsedFrames = Math.max(1, frameId - track.lastFrameId);
+    const predictedCenter = track.velocity
+        ? {
+            x: currentCenter.x + track.velocity.x * elapsedFrames,
+            y: currentCenter.y + track.velocity.y * elapsedFrames,
+        }
+        : currentCenter;
+    const scale = geometryDistanceScale(track.geometry, observation.geometry);
+    const spatialDistance = Math.hypot(observedCenter.x - currentCenter.x, observedCenter.y - currentCenter.y) / scale;
+    const predictionDistance = Math.hypot(observedCenter.x - predictedCenter.x, observedCenter.y - predictedCenter.y) / scale;
+    const directionConflict = motionDirectionConflict(track, currentCenter, observedCenter, elapsedFrames);
+    const sizePenalty = Math.min(4, Math.abs(Math.log(geometryArea(observation.geometry) / geometryArea(track.geometry))));
+    const elapsedTimeFrames = options.timestamp === undefined
+        ? 0
+        : Math.max(0, (options.timestamp - track.lastSeenAt) / positive(options.nominalFrameDurationMs, 1000 / 30) - 1);
+    const missingFrames = Math.max(track.missedFrameCount, frameId - track.lastFrameId - 1, elapsedTimeFrames);
+    const cost = spatialDistance * weights.spatialDistance
+        + (1 - geometryIoU(track.geometry, observation.geometry)) * weights.iouPenalty
+        + sizePenalty * weights.geometrySize
+        + (predictionDistance + directionConflict) * weights.motionPrediction
+        + missingFrames * weights.timeSinceObservation;
+    return Number.isFinite(cost) ? cost : Number.MAX_SAFE_INTEGER;
+}
+function motionDirectionConflict(track, current, observed, elapsedFrames) {
+    if (!track.velocity)
+        return 0;
+    const expectedX = track.velocity.x * elapsedFrames;
+    const expectedY = track.velocity.y * elapsedFrames;
+    const expectedMagnitude = Math.hypot(expectedX, expectedY);
+    if (expectedMagnitude <= Number.EPSILON)
+        return 0;
+    const actualX = observed.x - current.x;
+    const actualY = observed.y - current.y;
+    const actualMagnitude = Math.hypot(actualX, actualY);
+    // At a crossing, choosing the other object often looks like an implausible
+    // stop at the previous position. Preserve that evidence without rejecting a
+    // real stop outright: this is a soft cost and remains under the threshold.
+    if (actualMagnitude < expectedMagnitude * 0.25)
+        return 1;
+    const cosine = Math.max(-1, Math.min(1, (actualX * expectedX + actualY * expectedY) / (actualMagnitude * expectedMagnitude)));
+    return (1 - cosine) / 2;
+}
+/**
+ * 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 function associateTracks(tracks, observations, frameId, options = {}) {
+    const threshold = nonNegative(options.threshold, DEFAULT_ASSOCIATION_THRESHOLD);
+    const costMatrix = tracks.map((track) => observations.map((observation) => calculateAssociationCost(track, observation, frameId, options)));
+    if (tracks.length === 0 || observations.length === 0) {
+        return {
+            matches: [],
+            unmatchedTrackIndices: tracks.map((_, index) => index),
+            unmatchedObservationIndices: observations.map((_, index) => index),
+            costMatrix,
+        };
+    }
+    // One dummy column per track guarantees columns >= rows and permits every
+    // row to choose the unmatched cost independently.
+    const assignmentMatrix = costMatrix.map((row) => [
+        ...row,
+        ...Array.from({ length: tracks.length }, () => threshold),
+    ]);
+    const assignedColumns = hungarianRowsToColumns(assignmentMatrix);
+    const matchedObservations = new Set();
+    const matches = assignedColumns.flatMap((column, trackIndex) => {
+        if (column < 0 || column >= observations.length)
+            return [];
+        const track = tracks[trackIndex];
+        const observation = observations[column];
+        if (!track || !observation || track.payload !== observation.payload || track.format !== observation.format)
+            return [];
+        const cost = costMatrix[trackIndex]?.[column] ?? Number.MAX_SAFE_INTEGER;
+        if (!Number.isFinite(cost) || cost > threshold)
+            return [];
+        matchedObservations.add(column);
+        return [{ trackIndex, observationIndex: column, cost }];
+    });
+    const matchedTracks = new Set(matches.map((match) => match.trackIndex));
+    return {
+        matches,
+        unmatchedTrackIndices: tracks.map((_, index) => index).filter((index) => !matchedTracks.has(index)),
+        unmatchedObservationIndices: observations.map((_, index) => index).filter((index) => !matchedObservations.has(index)),
+        costMatrix,
+    };
+}
+function resolveWeights(input) {
+    return {
+        payloadMismatch: nonNegative(input?.payloadMismatch, DEFAULT_ASSOCIATION_WEIGHTS.payloadMismatch),
+        formatMismatch: nonNegative(input?.formatMismatch, DEFAULT_ASSOCIATION_WEIGHTS.formatMismatch),
+        spatialDistance: nonNegative(input?.spatialDistance, DEFAULT_ASSOCIATION_WEIGHTS.spatialDistance),
+        iouPenalty: nonNegative(input?.iouPenalty, DEFAULT_ASSOCIATION_WEIGHTS.iouPenalty),
+        geometrySize: nonNegative(input?.geometrySize, DEFAULT_ASSOCIATION_WEIGHTS.geometrySize),
+        motionPrediction: nonNegative(input?.motionPrediction, DEFAULT_ASSOCIATION_WEIGHTS.motionPrediction),
+        timeSinceObservation: nonNegative(input?.timeSinceObservation, DEFAULT_ASSOCIATION_WEIGHTS.timeSinceObservation),
+    };
+}
+function nonNegative(value, fallback) {
+    return value === undefined || !Number.isFinite(value) ? fallback : Math.max(0, value);
+}
+function positive(value, fallback) {
+    return value === undefined || !Number.isFinite(value) ? fallback : Math.max(Number.EPSILON, value);
+}
+/** Hungarian minimum-cost assignment for a finite matrix with rows <= columns. */
+function hungarianRowsToColumns(matrix) {
+    const rowCount = matrix.length;
+    const columnCount = matrix[0]?.length ?? 0;
+    if (rowCount === 0)
+        return [];
+    if (columnCount < rowCount)
+        throw new RangeError("Hungarian assignment requires at least as many columns as rows.");
+    const rowPotential = new Array(rowCount + 1).fill(0);
+    const columnPotential = new Array(columnCount + 1).fill(0);
+    const columnMatch = new Array(columnCount + 1).fill(0);
+    const predecessor = new Array(columnCount + 1).fill(0);
+    for (let row = 1; row <= rowCount; row += 1) {
+        columnMatch[0] = row;
+        let currentColumn = 0;
+        const minimum = new Array(columnCount + 1).fill(Number.POSITIVE_INFINITY);
+        const used = new Array(columnCount + 1).fill(false);
+        do {
+            used[currentColumn] = true;
+            const currentRow = columnMatch[currentColumn] ?? 0;
+            let delta = Number.POSITIVE_INFINITY;
+            let nextColumn = 0;
+            for (let column = 1; column <= columnCount; column += 1) {
+                if (used[column])
+                    continue;
+                const raw = matrix[currentRow - 1]?.[column - 1] ?? Number.MAX_SAFE_INTEGER;
+                const reduced = raw - (rowPotential[currentRow] ?? 0) - (columnPotential[column] ?? 0);
+                if (reduced < (minimum[column] ?? Number.POSITIVE_INFINITY)) {
+                    minimum[column] = reduced;
+                    predecessor[column] = currentColumn;
+                }
+                if ((minimum[column] ?? Number.POSITIVE_INFINITY) < delta) {
+                    delta = minimum[column] ?? Number.POSITIVE_INFINITY;
+                    nextColumn = column;
+                }
+            }
+            for (let column = 0; column <= columnCount; column += 1) {
+                if (used[column]) {
+                    const matchedRow = columnMatch[column] ?? 0;
+                    rowPotential[matchedRow] = (rowPotential[matchedRow] ?? 0) + delta;
+                    columnPotential[column] = (columnPotential[column] ?? 0) - delta;
+                }
+                else {
+                    minimum[column] = (minimum[column] ?? Number.POSITIVE_INFINITY) - delta;
+                }
+            }
+            currentColumn = nextColumn;
+        } while ((columnMatch[currentColumn] ?? 0) !== 0);
+        do {
+            const nextColumn = predecessor[currentColumn] ?? 0;
+            columnMatch[currentColumn] = columnMatch[nextColumn] ?? 0;
+            currentColumn = nextColumn;
+        } while (currentColumn !== 0);
+    }
+    const assignment = new Array(rowCount).fill(-1);
+    for (let column = 1; column <= columnCount; column += 1) {
+        const row = columnMatch[column] ?? 0;
+        if (row > 0)
+            assignment[row - 1] = column - 1;
+    }
+    return assignment;
+}
+//# sourceMappingURL=track-association.js.map

package/dist/tracking/track-association.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-association.js","sourceRoot":"","sources":["../../src/tracking/track-association.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjG,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,MAAM,CAAC,MAAM,2BAA2B,GAAsC,MAAM,CAAC,MAAM,CAAC;IAC1F,yEAAyE;IACzE,0EAA0E;IAC1E,eAAe,EAAE,CAAC;IAClB,cAAc,EAAE,CAAC;IACjB,eAAe,EAAE,GAAG;IACpB,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,6EAA6E;IAC7E,gBAAgB,EAAE,GAAG;IACrB,oBAAoB,EAAE,IAAI;CAC3B,CAAC,CAAC;AAWH,MAAM,UAAU,wBAAwB,CACtC,KAAmB,EACnB,WAA+B,EAC/B,OAAe,EACf,UAAmC,EAAE;IAErC,2EAA2E;IAC3E,2EAA2E;IAC3E,6EAA6E;IAC7E,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;QACjF,OAAO,MAAM,CAAC,iBAAiB,CAAC;IAClC,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ;QACpC,CAAC,CAAC;YACE,CAAC,EAAE,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,aAAa;YACrD,CAAC,EAAE,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,aAAa;SACtD;QACH,CAAC,CAAC,aAAa,CAAC;IAClB,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACnH,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAC1H,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACvG,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvH,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS;QACvD,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClH,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,OAAO,GAAG,KAAK,CAAC,WAAW,GAAG,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAE3G,MAAM,IAAI,GACR,eAAe,GAAG,OAAO,CAAC,eAAe;UACvC,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU;UAC5E,WAAW,GAAG,OAAO,CAAC,YAAY;UAClC,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,GAAG,OAAO,CAAC,gBAAgB;UACnE,aAAa,GAAG,OAAO,CAAC,oBAAoB,CAAC;IACjD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;AAChE,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAmB,EACnB,OAAiC,EACjC,QAAkC,EAClC,aAAqB;IAErB,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,aAAa,CAAC;IACnD,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,aAAa,CAAC;IACnD,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,IAAI,iBAAiB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACvC,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,2EAA2E;IAC3E,4EAA4E;IAC5E,2EAA2E;IAC3E,IAAI,eAAe,GAAG,iBAAiB,GAAG,IAAI;QAAE,OAAO,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EACpC,CAAC,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,eAAe,GAAG,iBAAiB,CAAC,CACpF,CAAC,CAAC;IACH,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA+B,EAC/B,YAA2C,EAC3C,OAAe,EACf,UAAmC,EAAE;IAErC,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACxE,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAC/D,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO;YACL,OAAO,EAAE,EAAE;YACX,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;YACtD,2BAA2B,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;YAClE,UAAU;SACX,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,kDAAkD;IAClD,MAAM,gBAAgB,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QAC/C,GAAG,GAAG;QACN,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC;KAC1D,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IACjE,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9C,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;QAC7D,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,YAAY,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QACtH,MAAM,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC;QACzE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1D,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAExE,OAAO;QACL,OAAO;QACP,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnG,2BAA2B,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrH,UAAU;KACX,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAmD;IACzE,OAAO;QACL,eAAe,EAAE,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,2BAA2B,CAAC,eAAe,CAAC;QACjG,cAAc,EAAE,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,2BAA2B,CAAC,cAAc,CAAC;QAC9F,eAAe,EAAE,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,2BAA2B,CAAC,eAAe,CAAC;QACjG,UAAU,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,2BAA2B,CAAC,UAAU,CAAC;QAClF,YAAY,EAAE,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,2BAA2B,CAAC,YAAY,CAAC;QACxF,gBAAgB,EAAE,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,gBAAgB,CAAC;QACpG,oBAAoB,EAAE,WAAW,CAAC,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,CAAC,oBAAoB,CAAC;KACjH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB,EAAE,QAAgB;IAC9D,OAAO,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,QAAQ,CAAC,KAAyB,EAAE,QAAgB;IAC3D,OAAO,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACrG,CAAC;AAED,kFAAkF;AAClF,SAAS,sBAAsB,CAAC,MAAsC;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,WAAW,GAAG,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,iEAAiE,CAAC,CAAC;IAEpH,MAAM,YAAY,GAAG,IAAI,KAAK,CAAS,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,eAAe,GAAG,IAAI,KAAK,CAAS,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,IAAI,KAAK,CAAS,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,IAAI,KAAK,CAAS,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/D,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAC5C,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACrB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,KAAK,CAAS,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAClF,MAAM,IAAI,GAAG,IAAI,KAAK,CAAU,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7D,GAAG,CAAC;YACF,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;YAC3B,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC;YACrC,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxD,IAAI,IAAI,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC;gBAC5E,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBACvF,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBAC5D,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;oBAC1B,WAAW,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC;gBACtC,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,GAAG,KAAK,EAAE,CAAC;oBAC1D,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC;oBACpD,UAAU,GAAG,MAAM,CAAC;gBACtB,CAAC;YACH,CAAC;YACD,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxD,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;oBACjB,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC5C,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;oBACnE,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;gBACnE,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC;gBAC1E,CAAC;YACH,CAAC;YACD,aAAa,GAAG,UAAU,CAAC;QAC7B,CAAC,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE;QAElD,GAAG,CAAC;YACF,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACnD,WAAW,CAAC,aAAa,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1D,aAAa,GAAG,UAAU,CAAC;QAC7B,CAAC,QAAQ,aAAa,KAAK,CAAC,EAAE;IAChC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,KAAK,CAAS,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,GAAG,CAAC;YAAE,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { BarcodeTrack, TrackOverlayModel } from "./types.js";
+export declare function createTrackOverlayModel(track: BarcodeTrack): TrackOverlayModel;
+export declare function createTrackOverlayModels(tracks: readonly BarcodeTrack[]): readonly TrackOverlayModel[];
+//# sourceMappingURL=track-overlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"track-overlay.d.ts","sourceRoot":"","sources":["../../src/tracking/track-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,CAW9E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,iBAAiB,EAAE,CAEtG"}

package/dist/tracking/track-overlay.js

@@ -0,0 +1,16 @@
+export function createTrackOverlayModel(track) {
+    return {
+        trackId: track.trackId,
+        physicalInstanceId: track.physicalInstanceId,
+        payload: track.payload,
+        format: track.format,
+        state: track.state,
+        boundingBox: { ...track.geometry.boundingBox },
+        cornerPoints: track.geometry.cornerPoints.map((point) => ({ ...point })),
+        ...(track.velocity ? { velocity: { ...track.velocity } } : {}),
+    };
+}
+export function createTrackOverlayModels(tracks) {
+    return tracks.map(createTrackOverlayModel);
+}
+//# sourceMappingURL=track-overlay.js.map

package/dist/tracking/track-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-overlay.js","sourceRoot":"","sources":["../../src/tracking/track-overlay.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE;QAC9C,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAA+B;IACtE,OAAO,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC7C,CAAC"}

package/dist/tracking/track-roi-set.d.ts

@@ -0,0 +1,17 @@
+import type { BarcodeTrack, TrackROIFrame, TrackROIPlan, TrackROISetOptions } from "./types.js";
+/**
+ * Produces a bounded, renderer/decoder-neutral multi-target ROI plan. The plan
+ * always schedules a periodic global scan so ROI optimization cannot hide a
+ * newly entering barcode indefinitely.
+ */
+export declare class TrackROISet {
+    private readonly options;
+    private lastGlobalFrame;
+    private lastSize;
+    constructor(options?: TrackROISetOptions);
+    plan(tracks: readonly BarcodeTrack[], frame: TrackROIFrame): TrackROIPlan;
+    get size(): number;
+    reset(): void;
+    private roiFor;
+}
+//# sourceMappingURL=track-roi-set.d.ts.map

package/dist/tracking/track-roi-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-roi-set.d.ts","sourceRoot":"","sources":["../../src/tracking/track-roi-set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAY,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAW1G;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAK;gBAET,OAAO,GAAE,kBAAuB;IAgB5C,IAAI,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY;IA2BzE,IAAI,IAAI,IAAI,MAAM,CAA0B;IAE5C,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,MAAM;CAwBf"}

package/dist/tracking/track-roi-set.js

@@ -0,0 +1,119 @@
+import { translateGeometry } from "./geometry.js";
+const DEFAULT_MAX_ROIS = 32;
+const DEFAULT_MAX_CANDIDATE_TRACKS = 128;
+const HARD_MAX_CANDIDATE_TRACKS = 128;
+const HARD_MAX_ROIS = 32;
+const HARD_MAX_UNCOVERED_GRID_SIZE = 16;
+const HARD_MAX_UNCOVERED_REGIONS = 64;
+const HARD_MAX_GRID_CELL_CHECKS = HARD_MAX_UNCOVERED_GRID_SIZE ** 2;
+/**
+ * Produces a bounded, renderer/decoder-neutral multi-target ROI plan. The plan
+ * always schedules a periodic global scan so ROI optimization cannot hide a
+ * newly entering barcode indefinitely.
+ */
+export class TrackROISet {
+    options;
+    lastGlobalFrame;
+    lastSize = 0;
+    constructor(options = {}) {
+        this.options = {
+            maxCandidateTracks: boundedPositiveInteger(options.maxCandidateTracks, DEFAULT_MAX_CANDIDATE_TRACKS, HARD_MAX_CANDIDATE_TRACKS),
+            maxROIs: boundedPositiveInteger(options.maxROIs, DEFAULT_MAX_ROIS, HARD_MAX_ROIS),
+            expansion: bounded(options.expansion, 0.25, 0, 2),
+            missedFrameExpansion: bounded(options.missedFrameExpansion, 0.15, 0, 1),
+            globalScanIntervalFrames: positiveInteger(options.globalScanIntervalFrames, 10),
+            uncoveredGridSize: boundedPositiveInteger(options.uncoveredGridSize, 4, HARD_MAX_UNCOVERED_GRID_SIZE),
+            maxUncoveredRegions: boundedPositiveInteger(options.maxUncoveredRegions, 16, HARD_MAX_UNCOVERED_REGIONS),
+        };
+    }
+    plan(tracks, frame) {
+        validateFrame(frame);
+        // Only a fixed prefix is inspected. The runtime tracker itself is bounded,
+        // but TrackROISet is public and must remain safe with arbitrary callers.
+        const eligible = tracks
+            .slice(0, this.options.maxCandidateTracks)
+            .filter((track) => track.state === "confirmed" || track.state === "lost")
+            .sort((a, b) => statePriority(a.state) - statePriority(b.state) || a.trackId.localeCompare(b.trackId))
+            .slice(0, this.options.maxROIs);
+        const trackedROIs = eligible.map((track) => this.roiFor(track, frame));
+        const uncoveredRegions = createUncoveredGrid(trackedROIs, this.options.uncoveredGridSize, this.options.maxUncoveredRegions);
+        const includeFullFrame = trackedROIs.length === 0
+            || this.lastGlobalFrame === undefined
+            || frame.frameId - this.lastGlobalFrame >= this.options.globalScanIntervalFrames;
+        if (includeFullFrame)
+            this.lastGlobalFrame = frame.frameId;
+        this.lastSize = trackedROIs.length;
+        const phases = [];
+        if (trackedROIs.length > 0)
+            phases.push("tracked-rois");
+        if (uncoveredRegions.length > 0)
+            phases.push("uncovered-regions");
+        if (includeFullFrame)
+            phases.push("full-frame");
+        return { frameId: frame.frameId, trackedROIs, uncoveredRegions, includeFullFrame, phases };
+    }
+    get size() { return this.lastSize; }
+    reset() {
+        this.lastGlobalFrame = undefined;
+        this.lastSize = 0;
+    }
+    roiFor(track, frame) {
+        const deltaFrames = Math.max(0, frame.frameId - track.lastFrameId);
+        const predicted = Boolean(track.velocity && deltaFrames > 0);
+        const geometry = predicted && track.velocity
+            ? translateGeometry(track.geometry, track.velocity.x * deltaFrames, track.velocity.y * deltaFrames)
+            : track.geometry;
+        const expansion = this.options.expansion + track.missedFrameCount * this.options.missedFrameExpansion;
+        const dx = geometry.boundingBox.width * expansion;
+        const dy = geometry.boundingBox.height * expansion;
+        const left = clamp(geometry.boundingBox.x - dx, 0, frame.width);
+        const top = clamp(geometry.boundingBox.y - dy, 0, frame.height);
+        const right = clamp(geometry.boundingBox.x + geometry.boundingBox.width + dx, left, frame.width);
+        const bottom = clamp(geometry.boundingBox.y + geometry.boundingBox.height + dy, top, frame.height);
+        return {
+            trackId: track.trackId,
+            state: track.state,
+            x: left / frame.width,
+            y: top / frame.height,
+            width: (right - left) / frame.width,
+            height: (bottom - top) / frame.height,
+            predicted,
+            missCount: track.missedFrameCount,
+        };
+    }
+}
+function createUncoveredGrid(tracked, gridSize, maximum) {
+    if (tracked.length === 0)
+        return [];
+    const cellSize = 1 / gridSize;
+    const uncovered = [];
+    const cellChecks = Math.min(HARD_MAX_GRID_CELL_CHECKS, gridSize * gridSize);
+    for (let index = 0; index < cellChecks && uncovered.length < maximum; index += 1) {
+        const row = Math.floor(index / gridSize);
+        const column = index % gridSize;
+        const cell = { x: column * cellSize, y: row * cellSize, width: cellSize, height: cellSize };
+        if (!tracked.some((roi) => rectanglesIntersect(cell, roi)))
+            uncovered.push(cell);
+    }
+    return uncovered;
+}
+function rectanglesIntersect(a, b) {
+    return a.x < b.x + b.width && a.x + a.width > b.x && a.y < b.y + b.height && a.y + a.height > b.y;
+}
+function statePriority(state) { return state === "confirmed" ? 0 : 1; }
+function clamp(value, minimum, maximum) { return Math.max(minimum, Math.min(maximum, value)); }
+function positiveInteger(value, fallback) {
+    return value === undefined || !Number.isFinite(value) ? fallback : Math.max(1, Math.floor(value));
+}
+function boundedPositiveInteger(value, fallback, maximum) {
+    return Math.min(maximum, positiveInteger(value, fallback));
+}
+function bounded(value, fallback, minimum, maximum) {
+    return value === undefined || !Number.isFinite(value) ? fallback : clamp(value, minimum, maximum);
+}
+function validateFrame(frame) {
+    if (!Number.isInteger(frame.frameId) || frame.frameId < 0 || !Number.isFinite(frame.width) || !Number.isFinite(frame.height) || frame.width <= 0 || frame.height <= 0) {
+        throw new RangeError("TrackROISet requires a non-negative frameId and positive finite frame dimensions.");
+    }
+}
+//# sourceMappingURL=track-roi-set.js.map

package/dist/tracking/track-roi-set.js.map

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

package/dist/tracking/types.d.ts

@@ -0,0 +1,154 @@
+import type { DecodedBarcode } from "@scanly/core";
+import type { BarcodeGeometry } from "../scanner/types.js";
+/** Lifecycle of one physical barcode identity. */
+export type BarcodeTrackState = "tentative" | "confirmed" | "lost" | "retired";
+/**
+ * One decoder observation in a frame. Observations deliberately do not carry
+ * identity: assigning a stable physical identity is BarcodeTracker's job.
+ */
+export interface BarcodeObservation {
+    payload: string;
+    format: DecodedBarcode["format"];
+    geometry: BarcodeGeometry;
+    confidence?: number;
+}
+/** Stable, SDK-owned view of a physical barcode instance. */
+export interface BarcodeTrack {
+    trackId: string;
+    payload: string;
+    format: DecodedBarcode["format"];
+    state: BarcodeTrackState;
+    firstSeenAt: number;
+    lastSeenAt: number;
+    firstFrameId: number;
+    lastFrameId: number;
+    observationCount: number;
+    missedFrameCount: number;
+    geometry: BarcodeGeometry;
+    /** Center displacement in image coordinates per processed frame. */
+    velocity?: {
+        x: number;
+        y: number;
+    };
+    physicalInstanceId: string;
+}
+export interface TrackingFrame {
+    frameId: number;
+    timestamp: number;
+}
+export interface BarcodeTrackerOptions {
+    /** Maximum live (tentative, confirmed, or lost) identities. */
+    maxTracks?: number;
+    /** Public scanner-facing alias for maxTracks. maxTracks takes precedence. */
+    maxTrackedBarcodes?: number;
+    /** Maximum observations considered from any one frame. */
+    maxObservations?: number;
+    /** Maximum accepted association cost. */
+    associationThreshold?: number;
+    /** Observations required before a new identity is confirmed. */
+    confirmationObservations?: number;
+    /** Consecutive missing frames retained for occlusion recovery. */
+    maxMissedFrames?: number;
+    /** EMA weight applied to the newest measured velocity. */
+    velocitySmoothing?: number;
+    association?: Partial<TrackAssociationWeights>;
+}
+export interface TrackAssociationWeights {
+    payloadMismatch: number;
+    formatMismatch: number;
+    spatialDistance: number;
+    iouPenalty: number;
+    geometrySize: number;
+    motionPrediction: number;
+    timeSinceObservation: number;
+}
+export interface TrackAssociationMatch {
+    trackIndex: number;
+    observationIndex: number;
+    cost: number;
+}
+export interface TrackAssociationResult {
+    matches: readonly TrackAssociationMatch[];
+    unmatchedTrackIndices: readonly number[];
+    unmatchedObservationIndices: readonly number[];
+    /** Rows are tracks and columns are observations. */
+    costMatrix: readonly (readonly number[])[];
+}
+export interface BarcodeTrackerUpdate {
+    frameId: number;
+    timestamp: number;
+    matchedTracks: readonly BarcodeTrack[];
+    newTracks: readonly BarcodeTrack[];
+    updatedTracks: readonly BarcodeTrack[];
+    lostTracks: readonly BarcodeTrack[];
+    restoredTracks: readonly BarcodeTrack[];
+    retiredTracks: readonly BarcodeTrack[];
+    tracks: readonly BarcodeTrack[];
+    ignoredObservationCount: number;
+    association: TrackAssociationResult;
+}
+export interface TrackingStatistics {
+    processedFrames: number;
+    receivedObservations: number;
+    consideredObservations: number;
+    ignoredObservations: number;
+    matchedObservationCount: number;
+    createdTrackCount: number;
+    confirmedTrackCount: number;
+    lostTransitionCount: number;
+    restoredTrackCount: number;
+    retiredTrackCount: number;
+    activeTrackCount: number;
+    lostTrackCount: number;
+    pendingObservationCount: number;
+    peakTrackCount: number;
+    associationP50Ms: number;
+    associationP95Ms: number;
+}
+export interface TrackROIFrame {
+    frameId: number;
+    width: number;
+    height: number;
+}
+export interface TrackROI {
+    trackId: string;
+    state: BarcodeTrackState;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    predicted: boolean;
+    missCount: number;
+}
+export interface TrackROIPlan {
+    frameId: number;
+    trackedROIs: readonly TrackROI[];
+    uncoveredRegions: readonly Omit<TrackROI, "trackId" | "state" | "predicted" | "missCount">[];
+    includeFullFrame: boolean;
+    phases: readonly ("tracked-rois" | "uncovered-regions" | "full-frame")[];
+}
+export interface TrackROISetOptions {
+    /** Maximum input candidates inspected before ROI prioritization. */
+    maxCandidateTracks?: number;
+    maxROIs?: number;
+    expansion?: number;
+    missedFrameExpansion?: number;
+    globalScanIntervalFrames?: number;
+    uncoveredGridSize?: number;
+    maxUncoveredRegions?: number;
+}
+/** Renderer-neutral overlay data; Canvas/SVG ownership stays with applications. */
+export interface TrackOverlayModel {
+    trackId: string;
+    physicalInstanceId: string;
+    payload: string;
+    format: DecodedBarcode["format"];
+    state: BarcodeTrackState;
+    boundingBox: BarcodeGeometry["boundingBox"];
+    cornerPoints: BarcodeGeometry["cornerPoints"];
+    velocity?: {
+        x: number;
+        y: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tracking/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tracking/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tracking/types.ts"],"names":[],"mappings":""}

package/dist/worker/decode-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decode-worker.d.ts.map

package/dist/worker/decode-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-worker.d.ts","sourceRoot":"","sources":["../../src/worker/decode-worker.ts"],"names":[],"mappings":"AAuFA,OAAO,EAAE,CAAC"}