tods-competition-factory 2.0.0-alpha.1 → 2.0.0-beta.0

package/dist/tods-competition-factory.development.cjs.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 function factoryVersion() {
-    return '2.0.0-alpha.1';
+    return '2.0.0-beta.0';
 }
 
 /******************************************************************************
@@ -26950,7 +26950,7 @@ function tallyParticipantResults(_a) {
     var completedTieMatchUps = matchUps.every(function (_a) {
         var matchUpType = _a.matchUpType, tieMatchUps = _a.tieMatchUps;
         return matchUpType === TEAM$1 &&
-            tieMatchUps.every(function (matchUp) { return checkMatchUpIsComplete({ matchUp: matchUp }); });
+            (tieMatchUps === null || tieMatchUps === void 0 ? void 0 : tieMatchUps.every(function (matchUp) { return checkMatchUpIsComplete({ matchUp: matchUp }); }));
     });
     var tallyPolicy = policyDefinitions === null || policyDefinitions === void 0 ? void 0 : policyDefinitions[POLICY_TYPE_ROUND_ROBIN_TALLY];
     var consideredMatchUps = matchUps.filter(function (matchUp) {
@@ -36328,49 +36328,6 @@ function removeAdHocRound(_a) {
     return __assign({ deletedMatchUpsCount: deletedMatchUpIds.length, roundRemoved: roundRemoved }, SUCCESS);
 }
 
-function addAdHocMatchUps(_a) {
-    var _b;
-    var _c, _d, _e, _f, _g, _h, _j;
-    var tournamentRecord = _a.tournamentRecord, drawDefinition = _a.drawDefinition, structureId = _a.structureId, matchUps = _a.matchUps;
-    if (typeof drawDefinition !== 'object')
-        return { error: MISSING_DRAW_DEFINITION };
-    if (!structureId && ((_c = drawDefinition.structures) === null || _c === void 0 ? void 0 : _c.length) === 1)
-        structureId = (_e = (_d = drawDefinition.structures) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.structureId;
-    if (typeof structureId !== 'string')
-        return { error: MISSING_STRUCTURE_ID };
-    if (!validMatchUps(matchUps))
-        return { error: INVALID_VALUES, info: mustBeAnArray('matchUps') };
-    var structure = (_f = drawDefinition.structures) === null || _f === void 0 ? void 0 : _f.find(function (structure) { return structure.structureId === structureId; });
-    if (!structure)
-        return { error: STRUCTURE_NOT_FOUND };
-    var existingMatchUps = structure === null || structure === void 0 ? void 0 : structure.matchUps;
-    var structureHasRoundPositions = existingMatchUps.find(function (matchUp) { return !!matchUp.roundPosition; });
-    if (structure.structures ||
-        structureHasRoundPositions ||
-        structure.finishingPosition === ROUND_OUTCOME) {
-        return { error: INVALID_STRUCTURE };
-    }
-    var existingMatchUpIds = (_j = (_h = (_g = allTournamentMatchUps({
-        tournamentRecord: tournamentRecord,
-        inContext: false,
-    })) === null || _g === void 0 ? void 0 : _g.matchUps) === null || _h === void 0 ? void 0 : _h.map(getMatchUpId)) !== null && _j !== void 0 ? _j : [];
-    var newMatchUpIds = matchUps.map(getMatchUpId);
-    if (overlap(existingMatchUpIds, newMatchUpIds)) {
-        return {
-            error: EXISTING_MATCHUP_ID,
-            info: 'One or more matchUpIds already present in tournamentRecord',
-        };
-    }
-    (_b = structure.matchUps).push.apply(_b, __spreadArray([], __read(matchUps), false));
-    addMatchUpsNotice({
-        tournamentId: tournamentRecord === null || tournamentRecord === void 0 ? void 0 : tournamentRecord.tournamentId,
-        drawDefinition: drawDefinition,
-        matchUps: matchUps,
-    });
-    modifyDrawNotice({ drawDefinition: drawDefinition, structureIds: [structureId] });
-    return __assign({}, SUCCESS);
-}
-
 function aggregateTieFormats(_a) {
     var e_1, _b;
     var _c, _d, _e, _f, _g;
@@ -37264,1279 +37221,1327 @@ function modifyEventEntries(_a) {
     return __assign({}, SUCCESS);
 }
 
-function attachFlightProfile(_a) {
-    var _b;
-    var deleteExisting = _a.deleteExisting, event = _a.event, flightProfile = _a.flightProfile;
-    var stack = 'attachFlightProfile';
-    if (!flightProfile)
-        return decorateResult({ result: { error: MISSING_VALUE }, stack: stack });
-    if (!event)
-        return decorateResult({ result: { error: MISSING_EVENT }, stack: stack });
-    var existingFlightProfile = getFlightProfile({ event: event }).flightProfile;
-    if (existingFlightProfile && !deleteExisting)
-        return decorateResult({ result: { error: EXISTING_PROFILE }, stack: stack });
-    if ((_b = event.drawDefinitions) === null || _b === void 0 ? void 0 : _b.length)
-        return decorateResult({
-            result: { error: EXISTING_DRAW_DEFINITIONS },
-            stack: stack,
+function generateAdHocMatchUps(_a) {
+    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+    var participantIdPairings = _a.participantIdPairings, _q = _a.matchUpIds, matchUpIds = _q === void 0 ? [] : _q, drawDefinition = _a.drawDefinition, matchUpsCount = _a.matchUpsCount, roundNumber = _a.roundNumber, structureId = _a.structureId, newRound = _a.newRound, isMock = _a.isMock, event = _a.event;
+    if (typeof drawDefinition !== 'object')
+        return { error: MISSING_DRAW_DEFINITION };
+    if (!structureId && ((_b = drawDefinition.structures) === null || _b === void 0 ? void 0 : _b.length) === 1)
+        structureId = (_d = (_c = drawDefinition.structures) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.structureId;
+    if (typeof structureId !== 'string')
+        return { error: MISSING_STRUCTURE_ID };
+    // if drawDefinition and structureId are provided it is possible to infer roundNumber
+    var structure = (_e = drawDefinition.structures) === null || _e === void 0 ? void 0 : _e.find(function (structure) { return structure.structureId === structureId; });
+    if (!structure)
+        return { error: STRUCTURE_NOT_FOUND };
+    var structureHasRoundPositions;
+    var existingMatchUps = (_f = structure.matchUps) !== null && _f !== void 0 ? _f : [];
+    var lastRoundNumber = existingMatchUps === null || existingMatchUps === void 0 ? void 0 : existingMatchUps.reduce(function (roundNumber, matchUp) {
+        if (matchUp.roundPosition)
+            structureHasRoundPositions = true;
+        return ((matchUp === null || matchUp === void 0 ? void 0 : matchUp.roundNumber) || 0) > roundNumber
+            ? matchUp.roundNumber
+            : roundNumber;
+    }, 0);
+    if (!matchUpsCount) {
+        var selectedEntries = (_h = (_g = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries) === null || _g === void 0 ? void 0 : _g.filter(function (entry) {
+            var entryStatus = entry.entryStatus;
+            return STRUCTURE_SELECTED_STATUSES.includes(entryStatus);
+        })) !== null && _h !== void 0 ? _h : [];
+        var roundMatchUpsCount = Math.floor((selectedEntries === null || selectedEntries === void 0 ? void 0 : selectedEntries.length) / 2) || 1;
+        if (newRound) {
+            matchUpsCount = roundMatchUpsCount;
+        }
+        else {
+            var targetRoundNumber_1 = (_j = roundNumber !== null && roundNumber !== void 0 ? roundNumber : lastRoundNumber) !== null && _j !== void 0 ? _j : 1;
+            var existingRoundMatchUps = (_m = (_l = (_k = structure.matchUps) === null || _k === void 0 ? void 0 : _k.filter(function (matchUp) { return matchUp.roundNumber === targetRoundNumber_1; })) === null || _l === void 0 ? void 0 : _l.length) !== null && _m !== void 0 ? _m : 0;
+            var maxRemaining = roundMatchUpsCount - existingRoundMatchUps;
+            if (maxRemaining > 0)
+                matchUpsCount = maxRemaining;
+        }
+    }
+    if ((participantIdPairings && !Array.isArray(participantIdPairings)) ||
+        (matchUpsCount && !isConvertableInteger(matchUpsCount)) ||
+        (matchUpIds && !Array.isArray(matchUpIds)) ||
+        (!participantIdPairings && !matchUpsCount)) {
+        return { error: INVALID_VALUES, info: 'matchUpsCount or pairings error' };
+    }
+    // structure must not be a container of other structures
+    // structure must not contain matchUps with roundPosition
+    // structure must not determine finishingPosition by ROUND_OUTCOME
+    if (structure.structures ||
+        structureHasRoundPositions ||
+        structure.finishingPosition === ROUND_OUTCOME) {
+        return { error: INVALID_STRUCTURE };
+    }
+    if (roundNumber && roundNumber - 1 > (lastRoundNumber || 0))
+        return { error: INVALID_VALUES, info: 'roundNumber error' };
+    var nextRoundNumber = roundNumber !== null && roundNumber !== void 0 ? roundNumber : ((newRound && (lastRoundNumber !== null && lastRoundNumber !== void 0 ? lastRoundNumber : 0) + 1) || lastRoundNumber || 1);
+    participantIdPairings =
+        participantIdPairings !== null && participantIdPairings !== void 0 ? participantIdPairings : generateRange(0, matchUpsCount).map(function () { return ({
+            participantIds: [undefined, undefined],
+        }); });
+    var matchUps = participantIdPairings === null || participantIdPairings === void 0 ? void 0 : participantIdPairings.map(function (pairing) {
+        var _a, _b;
+        var idStack = (_a = pairing === null || pairing === void 0 ? void 0 : pairing.participantIds) !== null && _a !== void 0 ? _a : [undefined, undefined];
+        // ensure there are always 2 sides in generated matchUps
+        idStack.push.apply(idStack, [undefined, undefined]);
+        var participantIds = idStack.slice(0, 2);
+        var sides = participantIds.map(function (participantId, i) {
+            return definedAttributes({
+                sideNumber: i + 1,
+                participantId: participantId,
+            });
         });
-    var extension = {
-        name: FLIGHT_PROFILE,
-        value: flightProfile,
-    };
-    addEventExtension({ event: event, extension: extension });
-    return __assign({ flightProfile: makeDeepCopy(flightProfile, false, true) }, SUCCESS);
+        return {
+            matchUpId: (_b = matchUpIds.pop()) !== null && _b !== void 0 ? _b : UUID(),
+            roundNumber: nextRoundNumber,
+            matchUpStatus: TO_BE_PLAYED,
+            sides: sides,
+        };
+    });
+    if (matchUps === null || matchUps === void 0 ? void 0 : matchUps.length) {
+        var tieFormat_1 = (_o = resolveTieFormat({ drawDefinition: drawDefinition, event: event })) === null || _o === void 0 ? void 0 : _o.tieFormat;
+        if (tieFormat_1) {
+            matchUps.forEach(function (matchUp) {
+                var tieMatchUps = generateTieMatchUps({ tieFormat: tieFormat_1, isMock: isMock }).tieMatchUps;
+                Object.assign(matchUp, { tieMatchUps: tieMatchUps, matchUpType: TEAM$1 });
+            });
+        }
+    }
+    return __assign({ matchUpsCount: (_p = matchUps === null || matchUps === void 0 ? void 0 : matchUps.length) !== null && _p !== void 0 ? _p : 0, matchUps: matchUps }, SUCCESS);
 }
 
-/**
- *
- * @param {object} tournamentRecord - passed automatically if tournamentEngine.setState()
- * @param {string[]} participantIds
- * @param {string} scaleAttributes - { scaleType, scaleName, eventType }
- * @returns {boolean} { success: true } or { error }
- */
-function removeParticipantsScaleItems(_a) {
-    var _b;
-    var tournamentRecord = _a.tournamentRecord, scaleAttributes = _a.scaleAttributes, participantIds = _a.participantIds;
-    if (!tournamentRecord)
-        return { error: MISSING_TOURNAMENT_RECORD };
-    if (!participantIds)
-        return { error: MISSING_PARTICIPANT_IDS };
-    if (!scaleAttributes)
-        return { error: MISSING_VALUE, info: 'scaleAttributes required' };
-    var scaleType = scaleAttributes.scaleType, eventType = scaleAttributes.eventType, scaleName = scaleAttributes.scaleName;
-    var itemType = [SCALE, scaleType, eventType, scaleName].join('.');
-    (_b = tournamentRecord.participants) === null || _b === void 0 ? void 0 : _b.forEach(function (participant) {
-        if (participantIds.includes(participant.participantId) &&
-            participant.timeItems) {
-            participant.timeItems = participant.timeItems.filter(function (timeItem) {
-                return timeItem && (timeItem === null || timeItem === void 0 ? void 0 : timeItem.itemType) !== itemType;
-            });
+function generateCandidate(_a) {
+    var _b = _a.maxIterations, maxIterations = _b === void 0 ? 4000 : _b, // cap the processing intensity of the candidate generator
+    valueSortedPairings = _a.valueSortedPairings, // pairings sorted by value from low to high
+    pairingValues = _a.pairingValues, valueObjects = _a.valueObjects, deltaObjects = _a.deltaObjects;
+    var pairingValueMap = Object.assign.apply(Object, __spreadArray([{}], __read(valueSortedPairings.map(function (rm) {
+        var _a;
+        return (_a = {}, _a[rm.pairing] = rm.value, _a);
+    })), false));
+    var actors = Object.keys(pairingValues);
+    var proposedCandidates = [];
+    // generate an initial candidate value with no stipulated pairings
+    var initialProposal = roundCandidate({
+        actorsCount: actors.length,
+        valueSortedPairings: valueSortedPairings,
+        pairingValueMap: pairingValueMap,
+        deltaObjects: deltaObjects,
+        valueObjects: valueObjects,
+    });
+    var candidateHashes = [candidateHash(initialProposal)];
+    proposedCandidates.push(initialProposal);
+    var lowCandidateValue = initialProposal.value;
+    var deltaCandidate = initialProposal;
+    // iterations is the number of loops over valueSortedPairings
+    var candidatesCount = 0;
+    var iterations = 0;
+    var opponentCount = actors.length;
+    var calculatedIterations;
+    // calculate the number of opponents to consider for each participantId
+    do {
+        opponentCount -= 1;
+        calculatedIterations = actors.length * pairingValues[actors[0]].length;
+    } while (calculatedIterations > maxIterations && opponentCount > 5);
+    // keep track of proposed pairings
+    var stipulatedPairs = [];
+    // for each actor generate a roundCandidate using opponentCount of pairing values
+    actors.forEach(function (actor) {
+        var participantIdPairings = pairingValues[actor];
+        // opponentCount limits the number of opponents to consider
+        participantIdPairings.slice(0, opponentCount).forEach(function (pairing) {
+            iterations += 1;
+            var stipulatedPair = pairingHash(actor, pairing.opponent);
+            if (!stipulatedPairs.includes(stipulatedPair)) {
+                var proposed = roundCandidate({
+                    // each roundCandidate starts with stipulated pairings
+                    stipulated: [[actor, pairing.opponent]],
+                    actorsCount: actors.length,
+                    valueSortedPairings: valueSortedPairings,
+                    pairingValueMap: pairingValueMap,
+                    deltaObjects: deltaObjects,
+                    valueObjects: valueObjects,
+                });
+                // ensure no duplicate candidates are considered
+                if (!candidateHashes.includes(candidateHash(proposed))) {
+                    candidateHashes.push(candidateHash(proposed));
+                    proposedCandidates.push(proposed);
+                    var maxDelta = proposed.maxDelta, value = proposed.value;
+                    if (maxDelta < deltaCandidate.maxDelta)
+                        deltaCandidate = proposed;
+                    if (value < lowCandidateValue ||
+                        (value === lowCandidateValue && Math.round(Math.random())) // randomize if equivalent values
+                    ) {
+                        lowCandidateValue = value;
+                    }
+                    stipulatedPairs.push(stipulatedPair);
+                    candidatesCount += 1;
+                }
+            }
+        });
+        proposedCandidates = proposedCandidates.filter(function (proposed) { return Math.abs(proposed.value - lowCandidateValue) < 5; });
+    });
+    proposedCandidates.sort(function (a, b) { return a.maxDiff - b.maxDiff; });
+    var candidate = randomPop(proposedCandidates);
+    return {
+        candidatesCount: candidatesCount,
+        deltaCandidate: deltaCandidate,
+        maxIterations: maxIterations,
+        iterations: iterations,
+        candidate: candidate,
+    };
+}
+function candidateHash(candidate) {
+    return candidate.participantIdPairings
+        .map(function (_a) {
+        var participantIds = _a.participantIds;
+        return participantIds.sort().join('|');
+    })
+        .sort()
+        .join('/');
+}
+function roundCandidate(_a) {
+    var valueSortedPairings = _a.valueSortedPairings, _b = _a.stipulated, stipulated = _b === void 0 ? [] : _b, pairingValueMap = _a.pairingValueMap, deltaObjects = _a.deltaObjects, valueObjects = _a.valueObjects, actorsCount = _a.actorsCount;
+    // roundPlayers starts with the stipulated pairing
+    var roundPlayers = [].concat.apply([], __spreadArray([], __read(stipulated), false));
+    // aggregates the pairings generated for a roundCandidate
+    var participantIdPairings = [];
+    // candidateValue is the sum of all participantIdPairings in a roundCandidate
+    // the winning candidate has the LOWEST total value
+    var candidateValue = 0;
+    // candidateValue is initialized with any stipulated pairings
+    stipulated.filter(Boolean).forEach(function (participantIds) {
+        var _a = __read(participantIds, 2), p1 = _a[0], p2 = _a[1];
+        var pairing = pairingHash(p1, p2);
+        var value = pairingValueMap[pairing];
+        participantIdPairings.push({ participantIds: participantIds, value: value });
+        candidateValue += pairingValueMap[pairing];
+    });
+    // valueSortedPairings is an array sorted from lowest value to highest value
+    // introduce random shuffling of chunks of valueSortedPairings
+    var consideredPairings = chunkArray(valueSortedPairings, actorsCount)
+        .map(function (pairings) {
+        return shuffleArray(pairings).map(function (pairing) { return (__assign(__assign({}, pairing), { value: pairing.value + Math.random() * Math.round(Math.random()) })); });
+    })
+        .flat();
+    // go through the valueSortedPairings (of all possible unique pairings)
+    consideredPairings.forEach(function (rankedPairing) {
+        var participantIds = rankedPairing.pairing.split('|');
+        var opponentExists = participantIds.reduce(function (p, c) { return roundPlayers.includes(c) || p; }, false);
+        if (!opponentExists) {
+            roundPlayers.push.apply(roundPlayers, __spreadArray([], __read(participantIds), false));
+            var value = rankedPairing.value;
+            candidateValue += value;
+            participantIdPairings.push({ participantIds: participantIds, value: value });
         }
     });
-    return __assign({}, SUCCESS);
+    // sort the candidate's proposed pairings by value
+    participantIdPairings.sort(function (a, b) { return a.value - b.value; });
+    // determine the greatest delta in the candidate's pairings
+    var maxDelta = participantIdPairings.reduce(function (p, c) {
+        var _a = __read(c.participantIds, 2), p1 = _a[0], p2 = _a[1];
+        var hash = pairingHash(p1, p2);
+        var delta = deltaObjects[hash];
+        return delta > p ? delta : p;
+    }, 0);
+    // determine the greatest delta in the candidate's pairings
+    var maxDiff = participantIdPairings.reduce(function (p, c) {
+        var _a = __read(c.participantIds, 2), p1 = _a[0], p2 = _a[1];
+        var hash = pairingHash(p1, p2);
+        var diff = valueObjects[hash];
+        return diff > p ? diff : p;
+    }, 0);
+    return { value: candidateValue, participantIdPairings: participantIdPairings, maxDelta: maxDelta, maxDiff: maxDiff };
+}
+function pairingHash(id1, id2) {
+    return [id1, id2].sort(stringSort).join('|');
 }
 
-/**
- *
- * @param {object} tournamentRecord - passed automatically if tournamentEngine.setState()
- * @param {string} eventId - resolves to event
- * @param {string} drawId - OPTIONAL - resolves drawDefinition - scopes participants to clear to drawDefinition.entries or flightProfile.flight.drawEntries
- * @param {string} scaleAttributes - { scaleType, scaleName, eventType }
- * @param {string} stage - OPTIONAL - filter event or draw entries by stage
- * @returns {boolean} { success: true } or { error }
- */
-function removeScaleValues(_a) {
-    var _b;
-    var tournamentRecord = _a.tournamentRecord, scaleAttributes = _a.scaleAttributes, drawDefinition = _a.drawDefinition, entryStatuses = _a.entryStatuses, drawId = _a.drawId, event = _a.event, stage = _a.stage;
-    if (!event)
-        return { error: MISSING_EVENT };
-    if (entryStatuses && !Array.isArray(entryStatuses))
-        return decorateResult({
-            result: { error: INVALID_VALUES },
-            info: mustBeAnArray('entryStatus'),
-            stack: 'removeScaleValues',
+function getPairingsData(_a) {
+    var participantIds = _a.participantIds;
+    var possiblePairings = {};
+    var uniquePairings = [];
+    participantIds.forEach(function (participantId) {
+        possiblePairings[participantId] = participantIds.filter(function (id) { return id !== participantId; });
+        possiblePairings[participantId].forEach(function (id) {
+            var pairing = pairingHash(id, participantId);
+            if (!uniquePairings.includes(pairing))
+                uniquePairings.push(pairing);
         });
-    var entries = event.entries;
-    if (drawId) {
-        var flightProfile = getFlightProfile({ event: event }).flightProfile;
-        var flight = (_b = flightProfile === null || flightProfile === void 0 ? void 0 : flightProfile.flights) === null || _b === void 0 ? void 0 : _b.find(function (flight) { return flight.drawId === drawId; });
-        if (flight) {
-            entries = flight.drawEntries;
+    });
+    var deltaObjects = Object.assign.apply(Object, __spreadArray([{}], __read(uniquePairings.map(function (pairing) {
+        var _a;
+        return (_a = {}, _a[pairing] = 0, _a);
+    })), false));
+    return { uniquePairings: uniquePairings, possiblePairings: possiblePairings, deltaObjects: deltaObjects };
+}
+
+function getEncounters(_a) {
+    var e_1, _b;
+    var matchUps = _a.matchUps;
+    var encounters = [];
+    try {
+        for (var matchUps_1 = __values(matchUps), matchUps_1_1 = matchUps_1.next(); !matchUps_1_1.done; matchUps_1_1 = matchUps_1.next()) {
+            var matchUp = matchUps_1_1.value;
+            var participantIds = matchUp.sides.map(extractAttributes('participantId'));
+            if (participantIds.length === 2) {
+                var _c = __read(participantIds, 2), p1 = _c[0], p2 = _c[1];
+                var pairing = pairingHash(p1, p2);
+                if (!encounters.includes(pairing))
+                    encounters.push(pairing);
+            }
         }
-        else {
-            entries = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries;
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (matchUps_1_1 && !matchUps_1_1.done && (_b = matchUps_1.return)) _b.call(matchUps_1);
         }
+        finally { if (e_1) throw e_1.error; }
     }
-    var stageEntries = (entries || []).filter(function (entry) {
-        return (!stage || !entry.entryStage || entry.entryStage === stage) &&
-            (!entryStatuses || entryStatuses.includes(entry.entryStatus));
-    });
-    var participantIds = stageEntries.map(getParticipantId);
-    return removeParticipantsScaleItems({
-        tournamentRecord: tournamentRecord,
-        scaleAttributes: scaleAttributes,
-        participantIds: participantIds,
-    });
+    return { encounters: encounters };
 }
 
-function applyLineUps(_a) {
-    var e_1, _b, e_2, _c, e_3, _d, e_4, _e;
-    var _f, _g, _h, _j;
-    var tournamentRecord = _a.tournamentRecord, drawDefinition = _a.drawDefinition, matchUpId = _a.matchUpId, lineUps = _a.lineUps, event = _a.event;
-    if (!tournamentRecord)
-        return { error: MISSING_TOURNAMENT_RECORD };
-    if (!drawDefinition)
-        return { error: DRAW_DEFINITION_NOT_FOUND };
-    if (typeof matchUpId !== 'string')
-        return { error: INVALID_MATCHUP };
-    if (!Array.isArray(lineUps))
-        return { error: INVALID_VALUES, lineUps: lineUps };
-    var stack = 'applyLineUps';
-    var tournamentParticipants = tournamentRecord.participants || [];
-    var result = findDrawMatchUp({
-        tournamentParticipants: tournamentParticipants,
-        inContext: true,
-        drawDefinition: drawDefinition,
-        matchUpId: matchUpId,
-    });
-    if (result.error)
-        return result;
-    if (!result.matchUp)
-        return { error: MATCHUP_NOT_FOUND };
-    var inContextMatchUp = result.matchUp, structure = result.structure;
-    var drawPositions = inContextMatchUp.drawPositions, matchUpType = inContextMatchUp.matchUpType;
-    if (matchUpType !== TEAM$1)
-        return { error: INVALID_MATCHUP };
-    if (!(drawPositions === null || drawPositions === void 0 ? void 0 : drawPositions.length))
-        return { error: MISSING_DRAW_POSITIONS };
-    var tieFormat = (_f = resolveTieFormat({
-        matchUp: inContextMatchUp,
-        drawDefinition: drawDefinition,
-        structure: structure,
-        event: event,
-    })) === null || _f === void 0 ? void 0 : _f.tieFormat;
-    // verify integrity of lineUps...
-    // 1. all participantIds must be valid individualParticipantIds
-    // 2. there should be at most one participantId for a given collectionPosition in singles
-    // 3. there should be at most two participantIds for a given collectionPosition in doubles
-    var sideAssignments = {};
+function getParticipantPairingValues(_a) {
+    var e_1, _b;
+    var possiblePairings = _a.possiblePairings, valueObjects = _a.valueObjects;
+    var pairingValues = {};
+    var _loop_1 = function (participantId) {
+        var participantValues = possiblePairings[participantId].map(function (opponent) {
+            return pairingValue(participantId, opponent);
+        });
+        pairingValues[participantId] = participantValues.sort(function (a, b) { return a.value - b.value; });
+    };
     try {
-        for (var lineUps_1 = __values(lineUps), lineUps_1_1 = lineUps_1.next(); !lineUps_1_1.done; lineUps_1_1 = lineUps_1.next()) {
-            var lineUp = lineUps_1_1.value;
-            if (!Array.isArray(lineUp))
-                return { error: INVALID_VALUES, lineUp: lineUp };
-            // maintain mapping of collectionId|collectionPosition to the participantIds assigned
-            var collectionParticipantIds = {};
-            var sideNumbers = [];
-            var _loop_1 = function (lineUpAssignment) {
-                var e_5, _m;
-                if (typeof lineUpAssignment !== 'object')
-                    return { value: { error: INVALID_VALUES, lineUpAssignment: lineUpAssignment } };
-                var participantId = lineUpAssignment.participantId, _o = lineUpAssignment.collectionAssignments, collectionAssignments = _o === void 0 ? [] : _o;
-                if (!Array.isArray(collectionAssignments))
-                    return { value: { error: INVALID_VALUES, collectionAssignments: collectionAssignments } };
-                var participant = tournamentParticipants.find(function (participant) { return participant.participantId === participantId; });
-                if (!participant)
-                    return { value: { error: PARTICIPANT_NOT_FOUND } };
-                if (participant.participantType !== INDIVIDUAL)
-                    return { value: { error: INVALID_PARTICIPANT_TYPE } };
-                var sideNumber_1 = (_h = (_g = inContextMatchUp.sides) === null || _g === void 0 ? void 0 : _g.find(function (side) { var _a, _b; return (_b = (_a = side.participant) === null || _a === void 0 ? void 0 : _a.individualParticipantIds) === null || _b === void 0 ? void 0 : _b.includes(participantId); })) === null || _h === void 0 ? void 0 : _h.sideNumber;
-                if (sideNumber_1)
-                    sideNumbers.push(sideNumber_1);
-                var _loop_3 = function (collectionAssignment) {
-                    if (typeof collectionAssignment !== 'object')
-                        return { value: { error: INVALID_VALUES, collectionAssignment: collectionAssignment } };
-                    var collectionId = collectionAssignment.collectionId, collectionPosition = collectionAssignment.collectionPosition;
-                    var collectionDefinition = (_j = tieFormat === null || tieFormat === void 0 ? void 0 : tieFormat.collectionDefinitions) === null || _j === void 0 ? void 0 : _j.find(function (collectionDefinition) {
-                        return collectionDefinition.collectionId === collectionId;
-                    });
-                    // all collectionIds in the lineUp must be present in the tieFormat collectionDefinitions
-                    if (!collectionDefinition)
-                        return { value: { error: INVALID_VALUES, collectionId: collectionId } };
-                    var aggregator = "".concat(collectionId, "-").concat(collectionPosition);
-                    if (!collectionParticipantIds[aggregator]) {
-                        collectionParticipantIds[aggregator] = [];
-                    }
-                    var participantsCount = collectionParticipantIds[aggregator].length;
-                    if ((collectionDefinition.matchUpType === SINGLES && participantsCount) ||
-                        (collectionDefinition.matchUpType === DOUBLES &&
-                            participantsCount > 1)) {
-                        return { value: {
-                                info: 'Excessive collectionPosition assignments',
-                                error: INVALID_VALUES,
-                            } };
-                    }
-                    collectionParticipantIds[aggregator].push(participantId);
-                };
-                try {
-                    for (var collectionAssignments_1 = (e_5 = void 0, __values(collectionAssignments)), collectionAssignments_1_1 = collectionAssignments_1.next(); !collectionAssignments_1_1.done; collectionAssignments_1_1 = collectionAssignments_1.next()) {
-                        var collectionAssignment = collectionAssignments_1_1.value;
-                        var state_2 = _loop_3(collectionAssignment);
-                        if (typeof state_2 === "object")
-                            return state_2;
-                    }
-                }
-                catch (e_5_1) { e_5 = { error: e_5_1 }; }
-                finally {
-                    try {
-                        if (collectionAssignments_1_1 && !collectionAssignments_1_1.done && (_m = collectionAssignments_1.return)) _m.call(collectionAssignments_1);
-                    }
-                    finally { if (e_5) throw e_5.error; }
-                }
-            };
-            try {
-                for (var lineUp_1 = (e_2 = void 0, __values(lineUp)), lineUp_1_1 = lineUp_1.next(); !lineUp_1_1.done; lineUp_1_1 = lineUp_1.next()) {
-                    var lineUpAssignment = lineUp_1_1.value;
-                    var state_1 = _loop_1(lineUpAssignment);
-                    if (typeof state_1 === "object")
-                        return state_1.value;
-                }
-            }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
-            finally {
-                try {
-                    if (lineUp_1_1 && !lineUp_1_1.done && (_c = lineUp_1.return)) _c.call(lineUp_1);
-                }
-                finally { if (e_2) throw e_2.error; }
-            }
-            // ensure that doubles pair participants exist, otherwise create
-            var collectionParticipantIdPairs = Object.values(collectionParticipantIds);
-            try {
-                for (var collectionParticipantIdPairs_1 = (e_3 = void 0, __values(collectionParticipantIdPairs)), collectionParticipantIdPairs_1_1 = collectionParticipantIdPairs_1.next(); !collectionParticipantIdPairs_1_1.done; collectionParticipantIdPairs_1_1 = collectionParticipantIdPairs_1.next()) {
-                    var participantIds = collectionParticipantIdPairs_1_1.value;
-                    if (participantIds.length === 2) {
-                        var pairedParticipant = getPairedParticipant({
-                            tournamentParticipants: tournamentParticipants,
-                            participantIds: participantIds,
-                        }).participant;
-                        if (!pairedParticipant) {
-                            // create pair participant
-                            var newPairParticipant = {
-                                participantType: PAIR,
-                                participantRole: COMPETITOR,
-                                individualParticipantIds: participantIds,
-                            };
-                            var result_1 = addParticipant({
-                                participant: newPairParticipant,
-                                pairOverride: true,
-                                tournamentRecord: tournamentRecord,
-                            });
-                            if (result_1.error)
-                                return result_1;
-                        }
-                    }
-                }
-            }
-            catch (e_3_1) { e_3 = { error: e_3_1 }; }
-            finally {
-                try {
-                    if (collectionParticipantIdPairs_1_1 && !collectionParticipantIdPairs_1_1.done && (_d = collectionParticipantIdPairs_1.return)) _d.call(collectionParticipantIdPairs_1);
-                }
-                finally { if (e_3) throw e_3.error; }
-            }
-            // determine sideNumber based on instances of participants appearing in team participants assigned to sides
-            // allows for some team members to be "borrowed"
-            var instances = instanceCount(sideNumbers);
-            var sideNumber = ((instances[1] || 0) > (instances[2] || 0) && 1) ||
-                ((instances[2] || 0) > (instances[1] || 0) && 2) ||
-                undefined;
-            // if side not previously assigned, map sideNumber to lineUp
-            var sideAssignmentKeys = Object.keys(sideAssignments).map(function (key) {
-                return parseInt(key);
-            });
-            if (sideNumber && !sideAssignmentKeys.includes(sideNumber)) {
-                sideAssignments[sideNumber] = lineUp;
-            }
+        for (var _c = __values(Object.keys(possiblePairings)), _d = _c.next(); !_d.done; _d = _c.next()) {
+            var participantId = _d.value;
+            _loop_1(participantId);
         }
     }
     catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (lineUps_1_1 && !lineUps_1_1.done && (_b = lineUps_1.return)) _b.call(lineUps_1);
+            if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
         }
         finally { if (e_1) throw e_1.error; }
     }
-    if (!Object.keys(sideAssignments).length)
-        return { error: VALUE_UNCHANGED };
-    result = findDrawMatchUp({ drawDefinition: drawDefinition, matchUpId: matchUpId });
-    if (result.error)
-        return result;
-    if (!result.matchUp)
-        return { error: MATCHUP_NOT_FOUND };
-    var matchUp = result.matchUp;
-    if (!matchUp.sides)
-        matchUp.sides = [];
-    var _loop_2 = function (sideNumber) {
-        var side = matchUp.sides.find(function (side) { return side.sideNumber === sideNumber; });
-        var assignment = sideAssignments[sideNumber];
-        if (!assignment) {
-            return "continue";
-        }
-        else if (!side) {
-            matchUp.sides.push({ lineUp: assignment, sideNumber: sideNumber });
+    function pairingValue(participantId, opponent) {
+        var key = pairingHash(participantId, opponent);
+        return { opponent: opponent, value: valueObjects[key] };
+    }
+    return { pairingValues: pairingValues };
+}
+
+var ELO = 'ELO';
+var NTRP = 'NTRP';
+var TRN = 'TRN';
+var UTR = 'UTR';
+var WTN = 'WTN';
+var ratingConstants = {
+    ELO: ELO,
+    NTRP: NTRP,
+    TRN: TRN,
+    UTR: UTR,
+    WTN: WTN,
+};
+
+var _a$e;
+var ratingsParameters = (_a$e = {},
+    _a$e[ELO] = {
+        defaultInitialization: 1500,
+        decimalsCount: 0,
+        range: [0, 3000],
+        ascending: true,
+    },
+    _a$e[NTRP] = {
+        accessors: ['ntrpRating', 'dntrpRatingHundredths'],
+        attributes: { ustaRatingType: '' },
+        accessor: 'dntrpRatingHundredths',
+        defaultInitialization: 3,
+        decimalsCount: 1,
+        ascending: true,
+        range: [1, 7],
+    },
+    _a$e[UTR] = {
+        defaultInitialization: 6,
+        accessors: ['utrRating'],
+        accessor: 'utrRating',
+        decimalsCount: 2,
+        ascending: true,
+        range: [1, 16],
+    },
+    _a$e[WTN] = {
+        attributes: { confidence: { generator: true, range: [60, 100] } },
+        accessors: ['wtnRating', 'confidence'],
+        defaultInitialization: 23,
+        accessor: 'wtnRating',
+        ascending: false,
+        decimalsCount: 2,
+        range: [40, 1],
+    },
+    _a$e);
+
+var DEFAULT_RATING = 0;
+function getSideRatings(_a) {
+    var _b, _c;
+    var tournamentParticipants = _a.tournamentParticipants, adHocRatings = _a.adHocRatings, eventType = _a.eventType, scaleName = _a.scaleName, pairing = _a.pairing;
+    var defaultRating = (_c = (_b = ratingsParameters[scaleName]) === null || _b === void 0 ? void 0 : _b.defaultInitialization) !== null && _c !== void 0 ? _c : DEFAULT_RATING;
+    return pairing.split('|').map(function (participantId) {
+        var _a;
+        if (eventType === DOUBLES$1) {
+            var individualParticipantIds = (_a = tournamentParticipants === null || tournamentParticipants === void 0 ? void 0 : tournamentParticipants.find(function (participant) { return participant.participantId === participantId; })) === null || _a === void 0 ? void 0 : _a.individualParticipantIds;
+            return !individualParticipantIds
+                ? defaultRating * 2
+                : individualParticipantIds === null || individualParticipantIds === void 0 ? void 0 : individualParticipantIds.map(function (participantId) { return adHocRatings[participantId] || defaultRating; });
         }
         else {
-            side.lineUp = assignment;
-        }
-    };
-    try {
-        for (var _k = __values([1, 2]), _l = _k.next(); !_l.done; _l = _k.next()) {
-            var sideNumber = _l.value;
-            _loop_2(sideNumber);
-        }
-    }
-    catch (e_4_1) { e_4 = { error: e_4_1 }; }
-    finally {
-        try {
-            if (_l && !_l.done && (_e = _k.return)) _e.call(_k);
+            return adHocRatings[participantId] || defaultRating;
         }
-        finally { if (e_4) throw e_4.error; }
-    }
-    modifyMatchUpNotice({
-        tournamentId: tournamentRecord === null || tournamentRecord === void 0 ? void 0 : tournamentRecord.tournamentId,
-        context: stack,
-        drawDefinition: drawDefinition,
-        matchUp: matchUp,
     });
-    return __assign({}, SUCCESS);
 }
 
-function resetTieFormat(params) {
-    var _a, _b, e_1, _c, e_2, _d;
-    var _e, _f, _g;
-    var stack = 'resetTieFormat';
-    var drawDefinition = params.drawDefinition, event = params.event, uuids = params.uuids;
-    var paramCheck = checkRequiredParameters(params, [(_a = {}, _a[TOURNAMENT_RECORD] = true, _a[MATCHUP_ID] = true, _a)], stack);
-    if (paramCheck.error)
-        return paramCheck;
-    var resolutions = resolveFromParameters(params, [(_b = {}, _b[PARAM] = MATCHUP, _b)]);
-    if (resolutions[ERROR])
-        return resolutions;
-    var tournamentId = (_e = params.tournamentRecord) === null || _e === void 0 ? void 0 : _e.tournamentId;
-    var _h = (_f = resolutions === null || resolutions === void 0 ? void 0 : resolutions.matchUp) !== null && _f !== void 0 ? _f : {}, matchUp = _h.matchUp, structure = _h.structure;
-    if (!(matchUp === null || matchUp === void 0 ? void 0 : matchUp.tieMatchUps))
-        return decorateResult({
-            result: { error: INVALID_MATCHUP },
-            info: 'Must be a TEAM matchUp',
-            stack: stack,
-        });
-    // if there is no tieFormat there is nothing to do
-    if (!matchUp.tieFormat)
-        return __assign({}, SUCCESS);
-    var tieFormat = (_g = resolveTieFormat({
-        structure: structure,
-        drawDefinition: drawDefinition,
-        event: event,
-    })) === null || _g === void 0 ? void 0 : _g.tieFormat;
-    if (!tieFormat)
-        return decorateResult({
-            result: { error: NOT_FOUND },
-            info: 'No inherited tieFormat',
-            stack: stack,
+function getPairings(_a) {
+    var tournamentParticipants = _a.tournamentParticipants, _b = _a.adHocRatings, adHocRatings = _b === void 0 ? {} : _b, possiblePairings = _a.possiblePairings, // participant keyed; provides array of possible opponents
+    uniquePairings = _a.uniquePairings, // hashes of all possible participantId pairings
+    maxIterations = _a.maxIterations, deltaObjects = _a.deltaObjects, // difference in rating between paired participants
+    valueObjects = _a.valueObjects, // calculated value of a pairing of participants, used for sorting pairings
+    eventType = _a.eventType, scaleName = _a.scaleName, salted = _a.salted;
+    // modify valueObjects by ratings ratingsDifference squared
+    // update deltaObjects to reflect the current difference between participant's ratings
+    uniquePairings.forEach(function (pairing) {
+        var ratings = getSideRatings({
+            tournamentParticipants: tournamentParticipants,
+            adHocRatings: adHocRatings,
+            scaleName: scaleName,
+            eventType: eventType,
+            pairing: pairing,
         });
-    var deletedMatchUpIds = [];
-    var collectionIds = [];
-    var tieMatchUps = [];
-    var newMatchUps = [];
-    var _loop_1 = function (collectionDefinition) {
-        // delete any matchUp.tieMatchUps that are not found in the ancestor tieFormat collectionDefinitions
-        var matchUpCount = collectionDefinition.matchUpCount, collectionId = collectionDefinition.collectionId;
-        collectionIds.push(collectionId);
-        var existingCollectionMatchUps = (matchUp.tieMatchUps || []).filter(function (matchUp) { return matchUp.collectionId === collectionId; });
-        if (existingCollectionMatchUps.length > matchUpCount) {
-            // sort by matchUpStatus to prioritize active or completed matchUpsA
-            existingCollectionMatchUps.sort(function (a, b) {
-                return (a.matchUpStatus === TO_BE_PLAYED ? 1 : 0) -
-                    (b.matchUpStatus === TO_BE_PLAYED ? 1 : 0);
-            });
-            tieMatchUps.push.apply(tieMatchUps, __spreadArray([], __read(existingCollectionMatchUps.slice(0, matchUpCount)), false));
-            deletedMatchUpIds.push.apply(deletedMatchUpIds, __spreadArray([], __read(existingCollectionMatchUps.slice(3).map(getMatchUpId)), false));
-        }
-        else {
-            tieMatchUps.push.apply(tieMatchUps, __spreadArray([], __read(existingCollectionMatchUps), false));
-            if (existingCollectionMatchUps.length < matchUpCount) {
-                var matchUpsLimit = matchUpCount - existingCollectionMatchUps.length;
-                var matchUps = generateCollectionMatchUps({
-                    collectionDefinition: collectionDefinition,
-                    matchUpsLimit: matchUpsLimit,
-                    uuids: uuids,
-                });
-                newMatchUps.push.apply(newMatchUps, __spreadArray([], __read(matchUps), false));
-            }
-        }
+        var salting = (typeof salted === 'number' && salted) || 0.5;
+        var salt = (salted && (Math.round(Math.random()) ? salting : salting * -1)) || 0;
+        var ratingsDifference = Math.abs(ratings[0] - ratings[1]) + salt;
+        var pairingDelta = Math.abs(ratings[0] - ratings[1]);
+        deltaObjects[pairing] = pairingDelta;
+        if (!valueObjects[pairing])
+            valueObjects[pairing] = 0;
+        valueObjects[pairing] += ratingsDifference
+            ? Math.pow(ratingsDifference, 2)
+            : 0;
+    });
+    /**
+     * valueSortedPairings are uniquePairings sorted by the ratings difference of the pairings, lowest to highest
+     */
+    var valueSortedPairings = uniquePairings
+        .map(function (pairing) { return ({ pairing: pairing, value: valueObjects[pairing] }); })
+        .sort(function (a, b) { return a.value - b.value; });
+    /**
+     * pairingValues is keyed by participantId and provides a value-sorted array of pairings for each participantId
+     * 'actorId': [
+          { opponent: 'potentialId1', value: 1 },
+          { opponent: 'potentialId2', value: 1 },
+     */
+    var pairingValues = getParticipantPairingValues({
+        possiblePairings: possiblePairings,
+        valueObjects: valueObjects,
+    }).pairingValues;
+    var _c = generateCandidate({
+        valueSortedPairings: valueSortedPairings,
+        maxIterations: maxIterations,
+        pairingValues: pairingValues,
+        deltaObjects: deltaObjects,
+        valueObjects: valueObjects,
+    }), candidate = _c.candidate, candidatesCount = _c.candidatesCount, deltaCandidate = _c.deltaCandidate, iterations = _c.iterations;
+    var participantIdPairings = candidate.participantIdPairings;
+    return {
+        participantIdPairings: participantIdPairings,
+        candidatesCount: candidatesCount,
+        deltaCandidate: deltaCandidate,
+        iterations: iterations,
+        candidate: candidate,
     };
-    try {
-        for (var _j = __values(tieFormat.collectionDefinitions), _k = _j.next(); !_k.done; _k = _j.next()) {
-            var collectionDefinition = _k.value;
-            _loop_1(collectionDefinition);
-        }
+}
+
+// this should be in policyDefinitions
+var ENCOUNTER_VALUE = 100;
+var SAME_TEAM_VALUE = 100;
+var MAX_ITERATIONS = 4000;
+function generateDrawMaticRound(_a) {
+    var e_1, _b, e_2, _c, e_3, _d;
+    var _e, _f;
+    var _g = _a.encounterValue, encounterValue = _g === void 0 ? ENCOUNTER_VALUE : _g, _h = _a.sameTeamValue, sameTeamValue = _h === void 0 ? SAME_TEAM_VALUE : _h, _j = _a.maxIterations, maxIterations = _j === void 0 ? MAX_ITERATIONS : _j, _k = _a.generateMatchUps, generateMatchUps = _k === void 0 ? true : _k, tournamentParticipants = _a.tournamentParticipants, participantIds = _a.participantIds, drawDefinition = _a.drawDefinition, adHocRatings = _a.adHocRatings, structureId = _a.structureId, _l = _a.salted, salted = _l === void 0 ? 0.5 : _l, matchUpIds = _a.matchUpIds, eventType = _a.eventType, structure = _a.structure, scaleName = _a.scaleName, isMock = _a.isMock, event = _a.event;
+    if (!drawDefinition)
+        return { error: MISSING_DRAW_DEFINITION };
+    if (!structure && !structureId)
+        return { error: STRUCTURE_NOT_FOUND };
+    if (!structure) {
+        structure = findStructure({ drawDefinition: drawDefinition, structureId: structureId }).structure;
     }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
-        }
-        finally { if (e_1) throw e_1.error; }
+    if (!isObject(structure))
+        return { error: MISSING_STRUCTURE };
+    if (!(participantIds === null || participantIds === void 0 ? void 0 : participantIds.length)) {
+        return { error: MISSING_PARTICIPANT_IDS };
     }
+    // create valueObject for each previous encounter within the structure
+    var encounters = getEncounters({ matchUps: (_e = structure === null || structure === void 0 ? void 0 : structure.matchUps) !== null && _e !== void 0 ? _e : [] }).encounters;
+    // valueObjects provide "weighting" to each possible pairing of participants
+    // {
+    //  'P-I-0|P-I-1': 1,
+    //  'P-I-0|P-I-2': 1,
+    //  'P-I-0|P-I-3': 1
+    // }
+    var valueObjects = {};
     try {
-        for (var _l = __values((matchUp === null || matchUp === void 0 ? void 0 : matchUp.tieMatchUps) || []), _m = _l.next(); !_m.done; _m = _l.next()) {
-            var tieMatchUp = _m.value;
-            if (tieMatchUp.collectionId &&
-                !collectionIds.includes(tieMatchUp.collectionId))
-                deletedMatchUpIds.push(tieMatchUp.matchUpId);
+        for (var encounters_1 = __values(encounters), encounters_1_1 = encounters_1.next(); !encounters_1_1.done; encounters_1_1 = encounters_1.next()) {
+            var pairing = encounters_1_1.value;
+            if (!valueObjects[pairing])
+                valueObjects[pairing] = 0;
+            valueObjects[pairing] += encounterValue;
         }
     }
-    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
+            if (encounters_1_1 && !encounters_1_1.done && (_b = encounters_1.return)) _b.call(encounters_1);
         }
-        finally { if (e_2) throw e_2.error; }
-    }
-    if (newMatchUps.length) {
-        tieMatchUps.push.apply(tieMatchUps, __spreadArray([], __read(newMatchUps), false));
-        addMatchUpsNotice({
-            eventId: event === null || event === void 0 ? void 0 : event.eventId,
-            matchUps: newMatchUps,
-            drawDefinition: drawDefinition,
-            tournamentId: tournamentId,
-        });
-    }
-    if (deletedMatchUpIds.length) {
-        deleteMatchUpsNotice({
-            matchUpIds: deletedMatchUpIds,
-            eventId: event === null || event === void 0 ? void 0 : event.eventId,
-            drawDefinition: drawDefinition,
-            tournamentId: tournamentId,
-        });
-    }
-    if (matchUp) {
-        matchUp.tieMatchUps = tieMatchUps;
-        matchUp.tieFormatId = undefined;
-        matchUp.tieFormat = undefined;
-        modifyMatchUpNotice({
-            structureId: structure === null || structure === void 0 ? void 0 : structure.structureId,
-            eventId: event === null || event === void 0 ? void 0 : event.eventId,
-            context: stack,
-            drawDefinition: drawDefinition,
-            tournamentId: tournamentId,
-            matchUp: matchUp,
-        });
+        finally { if (e_1) throw e_1.error; }
     }
-    return __assign(__assign({}, SUCCESS), { newMatchUps: newMatchUps, deletedMatchUpIds: deletedMatchUpIds });
-}
-
-function resetScorecard(params) {
-    var e_1, _a;
-    var _b, _c;
-    var tournamentRecord = params.tournamentRecord, drawDefinition = params.drawDefinition, matchUpId = params.matchUpId, event = params.event;
-    var stack = 'resetScorecard';
-    // Check for missing parameters ---------------------------------------------
-    if (!drawDefinition)
-        return decorateResult({
-            result: { error: MISSING_DRAW_DEFINITION },
-            stack: stack,
-        });
-    if (!matchUpId)
-        return decorateResult({ result: { error: MISSING_MATCHUP_ID }, stack: stack });
-    if (!isString(matchUpId))
-        return decorateResult({
-            result: { error: INVALID_VALUES, matchUpId: matchUpId },
-            stack: stack,
-        });
-    // Get map of all drawMatchUps and inContextDrawMatchUPs ---------------------
-    var matchUpsMap = getMatchUpsMap({ drawDefinition: drawDefinition });
-    var inContextDrawMatchUps = getAllDrawMatchUps({
-        nextMatchUps: true,
-        inContext: true,
-        drawDefinition: drawDefinition,
-        matchUpsMap: matchUpsMap,
-    }).matchUps;
-    // Find target matchUp ------------------------------------------------------
-    var matchUp = matchUpsMap.drawMatchUps.find(function (matchUp) { return matchUp.matchUpId === matchUpId; });
-    var inContextMatchUp = inContextDrawMatchUps === null || inContextDrawMatchUps === void 0 ? void 0 : inContextDrawMatchUps.find(function (matchUp) { return matchUp.matchUpId === matchUpId; });
-    if (!matchUp || !inContextDrawMatchUps)
-        return { error: MATCHUP_NOT_FOUND };
-    // only accept matchUpType: TEAM
-    if (matchUp.matchUpType !== TEAM_EVENT)
-        return { error: INVALID_MATCHUP };
-    // Get winner/loser position targets ----------------------------------------
-    var targetData = positionTargets({
-        inContextDrawMatchUps: inContextDrawMatchUps,
-        drawDefinition: drawDefinition,
-        matchUpId: matchUpId,
-    });
-    var structureId = inContextMatchUp === null || inContextMatchUp === void 0 ? void 0 : inContextMatchUp.structureId;
-    var structure = findStructure({ drawDefinition: drawDefinition, structureId: structureId }).structure;
-    Object.assign(params, {
-        inContextDrawMatchUps: inContextDrawMatchUps,
-        inContextMatchUp: inContextMatchUp,
-        matchUpsMap: matchUpsMap,
-        targetData: targetData,
-        structure: structure,
-        matchUp: matchUp,
+    var teamParticipants = tournamentParticipants === null || tournamentParticipants === void 0 ? void 0 : tournamentParticipants.filter(function (_a) {
+        var participantType = _a.participantType;
+        return participantType === TEAM;
     });
-    // with propagating winningSide changes, activeDownstream only applies to eventType: TEAM
-    var activeDownstream = isActiveDownstream(params);
-    if (activeDownstream)
-        return { error: CANNOT_CHANGE_WINNING_SIDE };
-    if ((_b = matchUp.tieMatchUps) === null || _b === void 0 ? void 0 : _b.length) {
+    if (teamParticipants) {
         try {
-            for (var _d = __values(matchUp.tieMatchUps), _e = _d.next(); !_e.done; _e = _d.next()) {
-                var tieMatchUp = _e.value;
-                var result_1 = setMatchUpState({
-                    matchUpId: tieMatchUp.matchUpId,
-                    matchUpTieId: matchUpId,
-                    winningSide: undefined,
-                    removeScore: true,
-                    tournamentRecord: tournamentRecord,
-                    drawDefinition: drawDefinition,
-                    event: event,
-                });
-                if (result_1.error)
-                    return decorateResult({ result: result_1, stack: stack });
+            // add SAME_TEAM_VALUE for participants who appear on the same team
+            for (var teamParticipants_1 = __values(teamParticipants), teamParticipants_1_1 = teamParticipants_1.next(); !teamParticipants_1_1.done; teamParticipants_1_1 = teamParticipants_1.next()) {
+                var teamParticipant = teamParticipants_1_1.value;
+                var participantIds_1 = (_f = teamParticipant.individualParticipantIds) !== null && _f !== void 0 ? _f : [];
+                var uniquePairings_2 = getPairingsData({ participantIds: participantIds_1 }).uniquePairings;
+                try {
+                    for (var uniquePairings_1 = (e_3 = void 0, __values(uniquePairings_2)), uniquePairings_1_1 = uniquePairings_1.next(); !uniquePairings_1_1.done; uniquePairings_1_1 = uniquePairings_1.next()) {
+                        var pairing = uniquePairings_1_1.value;
+                        if (!valueObjects[pairing])
+                            valueObjects[pairing] = 0;
+                        valueObjects[pairing] += sameTeamValue;
+                    }
+                }
+                catch (e_3_1) { e_3 = { error: e_3_1 }; }
+                finally {
+                    try {
+                        if (uniquePairings_1_1 && !uniquePairings_1_1.done && (_d = uniquePairings_1.return)) _d.call(uniquePairings_1);
+                    }
+                    finally { if (e_3) throw e_3.error; }
+                }
             }
         }
-        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
         finally {
             try {
-                if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+                if (teamParticipants_1_1 && !teamParticipants_1_1.done && (_c = teamParticipants_1.return)) _c.call(teamParticipants_1);
             }
-            finally { if (e_1) throw e_1.error; }
+            finally { if (e_2) throw e_2.error; }
         }
     }
-    var result = updateTieMatchUpScore({
-        event: params.event,
-        removeScore: true,
-        tournamentRecord: tournamentRecord,
+    // deltaObjects contain the difference in ratings between two participants
+    // {
+    //  'P-I-0|P-I-1': 0,
+    //  'P-I-0|P-I-2': 0,
+    //  'P-I-0|P-I-3': 0
+    // }
+    var _m = getPairingsData({
+        participantIds: participantIds,
+    }), uniquePairings = _m.uniquePairings, possiblePairings = _m.possiblePairings, deltaObjects = _m.deltaObjects;
+    var params = {
+        tournamentParticipants: tournamentParticipants,
+        possiblePairings: possiblePairings,
         drawDefinition: drawDefinition,
-        matchUpsMap: matchUpsMap,
-        matchUpId: matchUpId,
-    });
-    if (result.error)
-        return decorateResult({ result: result, stack: stack });
-    if (params.tiebreakReset && !result.tieFormatRemoved) {
-        // check for scenarios where an added "Tiebreaker" collectionDefinition/matchUp has been added
-        var inheritedTieFormat = (_c = resolveTieFormat({
-            drawDefinition: drawDefinition,
-            structure: structure,
-            event: event,
-        })) === null || _c === void 0 ? void 0 : _c.tieFormat;
-        if (matchUp.tieFormat && inheritedTieFormat) {
-            var _f = compareTieFormats({
-                descendant: matchUp.tieFormat,
-                ancestor: inheritedTieFormat,
-            }), matchUpCountDifference = _f.matchUpCountDifference, descendantDifferences = _f.descendantDifferences, ancestorDifferences = _f.ancestorDifferences, valueDifference = _f.valueDifference;
-            if (descendantDifferences.collectionIds.length === 1 &&
-                !ancestorDifferences.collectionIds.length &&
-                !ancestorDifferences.groupsCount &&
-                matchUpCountDifference === 1 &&
-                valueDifference === 1) {
-                var result_2 = resetTieFormat({
-                    tournamentRecord: tournamentRecord,
-                    drawDefinition: drawDefinition,
-                    matchUpId: matchUpId,
-                    event: event,
-                });
-                if (result_2.error)
-                    return result_2;
-            }
-        }
+        participantIds: participantIds,
+        uniquePairings: uniquePairings,
+        maxIterations: maxIterations,
+        adHocRatings: adHocRatings,
+        deltaObjects: deltaObjects,
+        valueObjects: valueObjects,
+        eventType: eventType,
+        scaleName: scaleName,
+        structure: structure,
+        salted: salted,
+    };
+    var _o = getPairings(params), candidatesCount = _o.candidatesCount, participantIdPairings = _o.participantIdPairings, iterations = _o.iterations, candidate = _o.candidate;
+    if (!candidatesCount)
+        return { error: NO_CANDIDATES };
+    var matchUps;
+    if (generateMatchUps) {
+        var result = generateAdHocMatchUps({
+            structureId: structure === null || structure === void 0 ? void 0 : structure.structureId,
+            participantIdPairings: participantIdPairings,
+            newRound: true,
+            drawDefinition: drawDefinition,
+            matchUpIds: matchUpIds,
+            isMock: isMock,
+            event: event,
+        });
+        if (result.error)
+            return result;
+        matchUps = result.matchUps;
     }
-    return __assign({}, SUCCESS);
+    var maxDelta = candidate.maxDelta, maxDiff = candidate.maxDiff;
+    return __assign(__assign({}, SUCCESS), { participantIdPairings: participantIdPairings, candidatesCount: candidatesCount, iterations: iterations, matchUps: matchUps, maxDelta: maxDelta, maxDiff: maxDiff });
 }
 
-function removeSeeding(_a) {
-    var _b, _c;
-    var tournamentRecord = _a.tournamentRecord, drawDefinition = _a.drawDefinition, entryStatuses = _a.entryStatuses, scaleName = _a.scaleName, drawId = _a.drawId, event = _a.event, stage = _a.stage;
-    if (!tournamentRecord)
-        return { error: MISSING_TOURNAMENT_RECORD };
-    if (!event)
-        return { error: MISSING_EVENT };
-    scaleName =
-        scaleName ||
-            ((_b = event.category) === null || _b === void 0 ? void 0 : _b.categoryName) ||
-            ((_c = event.category) === null || _c === void 0 ? void 0 : _c.ageCategoryCode);
-    var scaleAttributes = {
-        eventType: event.eventType,
-        scaleType: SEEDING$1,
-        scaleName: scaleName,
+function drawMatic(_a) {
+    var e_1, _b;
+    var _c, _d, _e, _f, _g;
+    var restrictEntryStatus = _a.restrictEntryStatus, _h = _a.adHocRatings, adHocRatings = _h === void 0 ? {} : _h, generateMatchUps = _a.generateMatchUps, tournamentRecord = _a.tournamentRecord, participantIds = _a.participantIds, encounterValue = _a.encounterValue, sameTeamValue = _a.sameTeamValue, drawDefinition = _a.drawDefinition, scaleAccessor = _a.scaleAccessor, maxIterations = _a.maxIterations, structureId = _a.structureId, matchUpIds = _a.matchUpIds, scaleName = _a.scaleName, // custom rating name to seed dynamic ratings
+    eventType = _a.eventType, isMock = _a.isMock, salted = _a.salted, event = _a.event;
+    if (typeof drawDefinition !== 'object' ||
+        (drawDefinition.drawType && drawDefinition.drawType !== AD_HOC)) {
+        return { error: INVALID_DRAW_DEFINITION };
+    }
+    if (!Array.isArray(drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries) &&
+        participantIds &&
+        !Array.isArray(participantIds)) {
+        return { error: INVALID_VALUES, info: 'Missing Entries' };
+    }
+    eventType = eventType !== null && eventType !== void 0 ? eventType : event === null || event === void 0 ? void 0 : event.eventType;
+    var enteredParticipantIds = (_c = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries) === null || _c === void 0 ? void 0 : _c.filter(function (entry) {
+        var entryStatus = entry.entryStatus;
+        return (!restrictEntryStatus ||
+            STRUCTURE_SELECTED_STATUSES.includes(entryStatus));
+    }).map(getParticipantId);
+    if (participantIds) {
+        // ensure all participantIds are in drawDefinition.entries
+        var invalidParticipantIds = participantIds.filter(function (participantId) { return !(enteredParticipantIds === null || enteredParticipantIds === void 0 ? void 0 : enteredParticipantIds.includes(participantId)); });
+        if (invalidParticipantIds === null || invalidParticipantIds === void 0 ? void 0 : invalidParticipantIds.length)
+            return decorateResult({
+                result: { error: INVALID_PARTICIPANT_ID },
+                info: { invalidParticipantIds: invalidParticipantIds },
+            });
+    }
+    else {
+        participantIds = enteredParticipantIds;
+    }
+    // if no structureId is specified find the latest AD_HOC stage which has matchUps
+    if (!structureId) {
+        var targetStructure = (_e = (_d = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.structures) === null || _d === void 0 ? void 0 : _d.filter(function (structure) { return structure.stageSequence === 1; })) === null || _e === void 0 ? void 0 : _e.reduce(function (targetStructure, structure) {
+            var orderNumber = structure.stage && stageOrder$1[structure.stage];
+            var structureIsAdHoc = isAdHoc({ drawDefinition: drawDefinition, structure: structure });
+            return structureIsAdHoc &&
+                orderNumber > (stageOrder$1[targetStructure === null || targetStructure === void 0 ? void 0 : targetStructure.stage] || 1)
+                ? structure
+                : targetStructure;
+        }, undefined);
+        structureId = targetStructure === null || targetStructure === void 0 ? void 0 : targetStructure.structureId;
+    }
+    var structure = (_f = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.structures) === null || _f === void 0 ? void 0 : _f.find(function (structure) { return structure.structureId === structureId; });
+    if (!structure)
+        return { error: STRUCTURE_NOT_FOUND };
+    // an AD_HOC structure is one that has no child structures and in which no matchUps have roundPosition
+    var structureIsAdHoc = isAdHoc({ drawDefinition: drawDefinition, structure: structure });
+    if (!structureIsAdHoc)
+        return { error: INVALID_DRAW_DEFINITION };
+    var tournamentParticipants = (_g = tournamentRecord.participants) !== null && _g !== void 0 ? _g : [];
+    var _loop_1 = function (participantId) {
+        var participant = tournamentParticipants === null || tournamentParticipants === void 0 ? void 0 : tournamentParticipants.find(function (participant) { return participant.participantId === participantId; });
+        // first see if there is already a dynamic value
+        var scaleValue = getScaleValue({
+            scaleName: "".concat(scaleName, ".").concat(DYNAMIC),
+            scaleAccessor: scaleAccessor,
+            participant: participant,
+            eventType: eventType,
+        });
+        // if no dynamic value found and a seeding scaleValue is provided...
+        if (!scaleValue && scaleName) {
+            scaleValue = getScaleValue({
+                scaleAccessor: scaleAccessor,
+                participant: participant,
+                scaleName: scaleName,
+                eventType: eventType,
+            });
+        }
+        if (scaleValue && !adHocRatings[participantId])
+            adHocRatings[participantId] = scaleValue;
     };
-    return removeScaleValues({
-        tournamentRecord: tournamentRecord,
-        scaleAttributes: scaleAttributes,
+    try {
+        for (var _j = __values(participantIds !== null && participantIds !== void 0 ? participantIds : []), _k = _j.next(); !_k.done; _k = _j.next()) {
+            var participantId = _k.value;
+            _loop_1(participantId);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_k && !_k.done && (_b = _j.return)) _b.call(_j);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    // TODO: update dynamic ratings based on matchUps present from last played round
+    // use scaleEngine.generateDynamicRatings(); see dynamicCalculations.test.ts
+    return generateDrawMaticRound({
+        tournamentParticipants: tournamentParticipants,
+        generateMatchUps: generateMatchUps,
+        participantIds: participantIds,
+        encounterValue: encounterValue,
+        sameTeamValue: sameTeamValue,
         drawDefinition: drawDefinition,
-        entryStatuses: entryStatuses,
-        drawId: drawId,
+        maxIterations: maxIterations,
+        adHocRatings: adHocRatings,
+        matchUpIds: matchUpIds,
+        structure: structure,
+        eventType: eventType,
+        salted: salted,
+        isMock: isMock,
         event: event,
-        stage: stage,
     });
 }
+function getScaleValue(_a) {
+    var _b;
+    var _c = _a.scaleType, scaleType = _c === void 0 ? RATING$2 : _c, scaleAccessor = _a.scaleAccessor, participant = _a.participant, scaleName = _a.scaleName, eventType = _a.eventType;
+    var scaleAttributes = {
+        eventType: eventType !== null && eventType !== void 0 ? eventType : SINGLES_EVENT,
+        scaleType: scaleType,
+        scaleName: scaleName,
+    };
+    var result = participant &&
+        participantScaleItem({
+            scaleAttributes: scaleAttributes,
+            participant: participant,
+        });
+    var scaleValue = (_b = result === null || result === void 0 ? void 0 : result.scaleItem) === null || _b === void 0 ? void 0 : _b.scaleValue;
+    return scaleAccessor && isObject(scaleValue)
+        ? scaleValue[scaleAccessor]
+        : scaleValue;
+}
 
-function generateAdHocMatchUps(_a) {
-    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
-    var participantIdPairings = _a.participantIdPairings, _p = _a.matchUpIds, matchUpIds = _p === void 0 ? [] : _p, drawDefinition = _a.drawDefinition, matchUpsCount = _a.matchUpsCount, roundNumber = _a.roundNumber, structureId = _a.structureId, newRound = _a.newRound;
+function addAdHocMatchUps(_a) {
+    var _b;
+    var _c, _d, _e, _f, _g, _h, _j;
+    var tournamentRecord = _a.tournamentRecord, drawDefinition = _a.drawDefinition, structureId = _a.structureId, matchUps = _a.matchUps;
     if (typeof drawDefinition !== 'object')
         return { error: MISSING_DRAW_DEFINITION };
-    if (!structureId && ((_b = drawDefinition.structures) === null || _b === void 0 ? void 0 : _b.length) === 1)
-        structureId = (_d = (_c = drawDefinition.structures) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.structureId;
+    if (!structureId && ((_c = drawDefinition.structures) === null || _c === void 0 ? void 0 : _c.length) === 1)
+        structureId = (_e = (_d = drawDefinition.structures) === null || _d === void 0 ? void 0 : _d[0]) === null || _e === void 0 ? void 0 : _e.structureId;
     if (typeof structureId !== 'string')
         return { error: MISSING_STRUCTURE_ID };
-    // if drawDefinition and structureId are provided it is possible to infer roundNumber
-    var structure = (_e = drawDefinition.structures) === null || _e === void 0 ? void 0 : _e.find(function (structure) { return structure.structureId === structureId; });
+    if (!validMatchUps(matchUps))
+        return { error: INVALID_VALUES, info: mustBeAnArray('matchUps') };
+    var structure = (_f = drawDefinition.structures) === null || _f === void 0 ? void 0 : _f.find(function (structure) { return structure.structureId === structureId; });
     if (!structure)
         return { error: STRUCTURE_NOT_FOUND };
-    var structureHasRoundPositions;
-    var existingMatchUps = (_f = structure.matchUps) !== null && _f !== void 0 ? _f : [];
-    var lastRoundNumber = existingMatchUps === null || existingMatchUps === void 0 ? void 0 : existingMatchUps.reduce(function (roundNumber, matchUp) {
-        if (matchUp.roundPosition)
-            structureHasRoundPositions = true;
-        return ((matchUp === null || matchUp === void 0 ? void 0 : matchUp.roundNumber) || 0) > roundNumber
-            ? matchUp.roundNumber
-            : roundNumber;
-    }, 0);
-    if (!matchUpsCount) {
-        var selectedEntries = (_h = (_g = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries) === null || _g === void 0 ? void 0 : _g.filter(function (entry) {
-            var entryStatus = entry.entryStatus;
-            return STRUCTURE_SELECTED_STATUSES.includes(entryStatus);
-        })) !== null && _h !== void 0 ? _h : [];
-        var roundMatchUpsCount = Math.floor((selectedEntries === null || selectedEntries === void 0 ? void 0 : selectedEntries.length) / 2) || 1;
-        if (newRound) {
-            matchUpsCount = roundMatchUpsCount;
-        }
-        else {
-            var targetRoundNumber_1 = (_j = roundNumber !== null && roundNumber !== void 0 ? roundNumber : lastRoundNumber) !== null && _j !== void 0 ? _j : 1;
-            var existingRoundMatchUps = (_m = (_l = (_k = structure.matchUps) === null || _k === void 0 ? void 0 : _k.filter(function (matchUp) { return matchUp.roundNumber === targetRoundNumber_1; })) === null || _l === void 0 ? void 0 : _l.length) !== null && _m !== void 0 ? _m : 0;
-            var maxRemaining = roundMatchUpsCount - existingRoundMatchUps;
-            if (maxRemaining > 0)
-                matchUpsCount = maxRemaining;
-        }
-    }
-    if ((participantIdPairings && !Array.isArray(participantIdPairings)) ||
-        (matchUpsCount && !isConvertableInteger(matchUpsCount)) ||
-        (matchUpIds && !Array.isArray(matchUpIds)) ||
-        (!participantIdPairings && !matchUpsCount)) {
-        return { error: INVALID_VALUES, info: 'matchUpsCount or pairings error' };
-    }
-    // structure must not be a container of other structures
-    // structure must not contain matchUps with roundPosition
-    // structure must not determine finishingPosition by ROUND_OUTCOME
+    var existingMatchUps = structure === null || structure === void 0 ? void 0 : structure.matchUps;
+    var structureHasRoundPositions = existingMatchUps.find(function (matchUp) { return !!matchUp.roundPosition; });
     if (structure.structures ||
         structureHasRoundPositions ||
         structure.finishingPosition === ROUND_OUTCOME) {
         return { error: INVALID_STRUCTURE };
     }
-    if (roundNumber && roundNumber - 1 > (lastRoundNumber || 0))
-        return { error: INVALID_VALUES, info: 'roundNumber error' };
-    var nextRoundNumber = roundNumber !== null && roundNumber !== void 0 ? roundNumber : ((newRound && (lastRoundNumber !== null && lastRoundNumber !== void 0 ? lastRoundNumber : 0) + 1) || lastRoundNumber || 1);
-    participantIdPairings =
-        participantIdPairings !== null && participantIdPairings !== void 0 ? participantIdPairings : generateRange(0, matchUpsCount).map(function () { return ({
-            participantIds: [undefined, undefined],
-        }); });
-    var matchUps = participantIdPairings === null || participantIdPairings === void 0 ? void 0 : participantIdPairings.map(function (pairing) {
-        var _a, _b;
-        var idStack = (_a = pairing === null || pairing === void 0 ? void 0 : pairing.participantIds) !== null && _a !== void 0 ? _a : [undefined, undefined];
-        // ensure there are always 2 sides in generated matchUps
-        idStack.push.apply(idStack, [undefined, undefined]);
-        var participantIds = idStack.slice(0, 2);
-        var sides = participantIds.map(function (participantId, i) {
-            return definedAttributes({
-                sideNumber: i + 1,
-                participantId: participantId,
-            });
-        });
+    var existingMatchUpIds = (_j = (_h = (_g = allTournamentMatchUps({
+        tournamentRecord: tournamentRecord,
+        inContext: false,
+    })) === null || _g === void 0 ? void 0 : _g.matchUps) === null || _h === void 0 ? void 0 : _h.map(getMatchUpId)) !== null && _j !== void 0 ? _j : [];
+    var newMatchUpIds = matchUps.map(getMatchUpId);
+    if (overlap(existingMatchUpIds, newMatchUpIds)) {
         return {
-            matchUpId: (_b = matchUpIds.pop()) !== null && _b !== void 0 ? _b : UUID(),
-            roundNumber: nextRoundNumber,
-            matchUpStatus: TO_BE_PLAYED,
-            sides: sides,
+            error: EXISTING_MATCHUP_ID,
+            info: 'One or more matchUpIds already present in tournamentRecord',
         };
+    }
+    (_b = structure.matchUps).push.apply(_b, __spreadArray([], __read(matchUps), false));
+    addMatchUpsNotice({
+        tournamentId: tournamentRecord === null || tournamentRecord === void 0 ? void 0 : tournamentRecord.tournamentId,
+        drawDefinition: drawDefinition,
+        matchUps: matchUps,
     });
-    return __assign({ matchUpsCount: (_o = matchUps === null || matchUps === void 0 ? void 0 : matchUps.length) !== null && _o !== void 0 ? _o : 0, matchUps: matchUps }, SUCCESS);
+    modifyDrawNotice({ drawDefinition: drawDefinition, structureIds: [structureId] });
+    return __assign({}, SUCCESS);
 }
 
-function generateCandidate(_a) {
-    var _b = _a.maxIterations, maxIterations = _b === void 0 ? 4000 : _b, // cap the processing intensity of the candidate generator
-    valueSortedPairings = _a.valueSortedPairings, // pairings sorted by value from low to high
-    pairingValues = _a.pairingValues, valueObjects = _a.valueObjects, deltaObjects = _a.deltaObjects;
-    var pairingValueMap = Object.assign.apply(Object, __spreadArray([{}], __read(valueSortedPairings.map(function (rm) {
-        var _a;
-        return (_a = {}, _a[rm.pairing] = rm.value, _a);
-    })), false));
-    var actors = Object.keys(pairingValues);
-    var proposedCandidates = [];
-    // generate an initial candidate value with no stipulated pairings
-    var initialProposal = roundCandidate({
-        actorsCount: actors.length,
-        valueSortedPairings: valueSortedPairings,
-        pairingValueMap: pairingValueMap,
-        deltaObjects: deltaObjects,
-        valueObjects: valueObjects,
-    });
-    var candidateHashes = [candidateHash(initialProposal)];
-    proposedCandidates.push(initialProposal);
-    var lowCandidateValue = initialProposal.value;
-    var deltaCandidate = initialProposal;
-    // iterations is the number of loops over valueSortedPairings
-    var candidatesCount = 0;
-    var iterations = 0;
-    var opponentCount = actors.length;
-    var calculatedIterations;
-    // calculate the number of opponents to consider for each participantId
-    do {
-        opponentCount -= 1;
-        calculatedIterations = actors.length * pairingValues[actors[0]].length;
-    } while (calculatedIterations > maxIterations && opponentCount > 5);
-    // keep track of proposed pairings
-    var stipulatedPairs = [];
-    // for each actor generate a roundCandidate using opponentCount of pairing values
-    actors.forEach(function (actor) {
-        var participantIdPairings = pairingValues[actor];
-        // opponentCount limits the number of opponents to consider
-        participantIdPairings.slice(0, opponentCount).forEach(function (pairing) {
-            iterations += 1;
-            var stipulatedPair = pairingHash(actor, pairing.opponent);
-            if (!stipulatedPairs.includes(stipulatedPair)) {
-                var proposed = roundCandidate({
-                    // each roundCandidate starts with stipulated pairings
-                    stipulated: [[actor, pairing.opponent]],
-                    actorsCount: actors.length,
-                    valueSortedPairings: valueSortedPairings,
-                    pairingValueMap: pairingValueMap,
-                    deltaObjects: deltaObjects,
-                    valueObjects: valueObjects,
-                });
-                // ensure no duplicate candidates are considered
-                if (!candidateHashes.includes(candidateHash(proposed))) {
-                    candidateHashes.push(candidateHash(proposed));
-                    proposedCandidates.push(proposed);
-                    var maxDelta = proposed.maxDelta, value = proposed.value;
-                    if (maxDelta < deltaCandidate.maxDelta)
-                        deltaCandidate = proposed;
-                    if (value < lowCandidateValue ||
-                        (value === lowCandidateValue && Math.round(Math.random())) // randomize if equivalent values
-                    ) {
-                        lowCandidateValue = value;
-                    }
-                    stipulatedPairs.push(stipulatedPair);
-                    candidatesCount += 1;
-                }
-            }
+function attachFlightProfile(_a) {
+    var _b;
+    var deleteExisting = _a.deleteExisting, event = _a.event, flightProfile = _a.flightProfile;
+    var stack = 'attachFlightProfile';
+    if (!flightProfile)
+        return decorateResult({ result: { error: MISSING_VALUE }, stack: stack });
+    if (!event)
+        return decorateResult({ result: { error: MISSING_EVENT }, stack: stack });
+    var existingFlightProfile = getFlightProfile({ event: event }).flightProfile;
+    if (existingFlightProfile && !deleteExisting)
+        return decorateResult({ result: { error: EXISTING_PROFILE }, stack: stack });
+    if ((_b = event.drawDefinitions) === null || _b === void 0 ? void 0 : _b.length)
+        return decorateResult({
+            result: { error: EXISTING_DRAW_DEFINITIONS },
+            stack: stack,
         });
-        proposedCandidates = proposedCandidates.filter(function (proposed) { return Math.abs(proposed.value - lowCandidateValue) < 5; });
-    });
-    proposedCandidates.sort(function (a, b) { return a.maxDiff - b.maxDiff; });
-    var candidate = randomPop(proposedCandidates);
-    return {
-        candidatesCount: candidatesCount,
-        deltaCandidate: deltaCandidate,
-        maxIterations: maxIterations,
-        iterations: iterations,
-        candidate: candidate,
+    var extension = {
+        name: FLIGHT_PROFILE,
+        value: flightProfile,
     };
+    addEventExtension({ event: event, extension: extension });
+    return __assign({ flightProfile: makeDeepCopy(flightProfile, false, true) }, SUCCESS);
 }
-function candidateHash(candidate) {
-    return candidate.participantIdPairings
-        .map(function (_a) {
-        var participantIds = _a.participantIds;
-        return participantIds.sort().join('|');
-    })
-        .sort()
-        .join('/');
-}
-function roundCandidate(_a) {
-    var valueSortedPairings = _a.valueSortedPairings, _b = _a.stipulated, stipulated = _b === void 0 ? [] : _b, pairingValueMap = _a.pairingValueMap, deltaObjects = _a.deltaObjects, valueObjects = _a.valueObjects, actorsCount = _a.actorsCount;
-    // roundPlayers starts with the stipulated pairing
-    var roundPlayers = [].concat.apply([], __spreadArray([], __read(stipulated), false));
-    // aggregates the pairings generated for a roundCandidate
-    var participantIdPairings = [];
-    // candidateValue is the sum of all participantIdPairings in a roundCandidate
-    // the winning candidate has the LOWEST total value
-    var candidateValue = 0;
-    // candidateValue is initialized with any stipulated pairings
-    stipulated.filter(Boolean).forEach(function (participantIds) {
-        var _a = __read(participantIds, 2), p1 = _a[0], p2 = _a[1];
-        var pairing = pairingHash(p1, p2);
-        var value = pairingValueMap[pairing];
-        participantIdPairings.push({ participantIds: participantIds, value: value });
-        candidateValue += pairingValueMap[pairing];
-    });
-    // valueSortedPairings is an array sorted from lowest value to highest value
-    // introduce random shuffling of chunks of valueSortedPairings
-    var consideredPairings = chunkArray(valueSortedPairings, actorsCount)
-        .map(function (pairings) {
-        return shuffleArray(pairings).map(function (pairing) { return (__assign(__assign({}, pairing), { value: pairing.value + Math.random() * Math.round(Math.random()) })); });
-    })
-        .flat();
-    // go through the valueSortedPairings (of all possible unique pairings)
-    consideredPairings.forEach(function (rankedPairing) {
-        var participantIds = rankedPairing.pairing.split('|');
-        var opponentExists = participantIds.reduce(function (p, c) { return roundPlayers.includes(c) || p; }, false);
-        if (!opponentExists) {
-            roundPlayers.push.apply(roundPlayers, __spreadArray([], __read(participantIds), false));
-            var value = rankedPairing.value;
-            candidateValue += value;
-            participantIdPairings.push({ participantIds: participantIds, value: value });
+
+/**
+ *
+ * @param {object} tournamentRecord - passed automatically if tournamentEngine.setState()
+ * @param {string[]} participantIds
+ * @param {string} scaleAttributes - { scaleType, scaleName, eventType }
+ * @returns {boolean} { success: true } or { error }
+ */
+function removeParticipantsScaleItems(_a) {
+    var _b;
+    var tournamentRecord = _a.tournamentRecord, scaleAttributes = _a.scaleAttributes, participantIds = _a.participantIds;
+    if (!tournamentRecord)
+        return { error: MISSING_TOURNAMENT_RECORD };
+    if (!participantIds)
+        return { error: MISSING_PARTICIPANT_IDS };
+    if (!scaleAttributes)
+        return { error: MISSING_VALUE, info: 'scaleAttributes required' };
+    var scaleType = scaleAttributes.scaleType, eventType = scaleAttributes.eventType, scaleName = scaleAttributes.scaleName;
+    var itemType = [SCALE, scaleType, eventType, scaleName].join('.');
+    (_b = tournamentRecord.participants) === null || _b === void 0 ? void 0 : _b.forEach(function (participant) {
+        if (participantIds.includes(participant.participantId) &&
+            participant.timeItems) {
+            participant.timeItems = participant.timeItems.filter(function (timeItem) {
+                return timeItem && (timeItem === null || timeItem === void 0 ? void 0 : timeItem.itemType) !== itemType;
+            });
         }
     });
-    // sort the candidate's proposed pairings by value
-    participantIdPairings.sort(function (a, b) { return a.value - b.value; });
-    // determine the greatest delta in the candidate's pairings
-    var maxDelta = participantIdPairings.reduce(function (p, c) {
-        var _a = __read(c.participantIds, 2), p1 = _a[0], p2 = _a[1];
-        var hash = pairingHash(p1, p2);
-        var delta = deltaObjects[hash];
-        return delta > p ? delta : p;
-    }, 0);
-    // determine the greatest delta in the candidate's pairings
-    var maxDiff = participantIdPairings.reduce(function (p, c) {
-        var _a = __read(c.participantIds, 2), p1 = _a[0], p2 = _a[1];
-        var hash = pairingHash(p1, p2);
-        var diff = valueObjects[hash];
-        return diff > p ? diff : p;
-    }, 0);
-    return { value: candidateValue, participantIdPairings: participantIdPairings, maxDelta: maxDelta, maxDiff: maxDiff };
-}
-function pairingHash(id1, id2) {
-    return [id1, id2].sort(stringSort).join('|');
+    return __assign({}, SUCCESS);
 }
 
-function getPairingsData(_a) {
-    var participantIds = _a.participantIds;
-    var possiblePairings = {};
-    var uniquePairings = [];
-    participantIds.forEach(function (participantId) {
-        possiblePairings[participantId] = participantIds.filter(function (id) { return id !== participantId; });
-        possiblePairings[participantId].forEach(function (id) {
-            var pairing = pairingHash(id, participantId);
-            if (!uniquePairings.includes(pairing))
-                uniquePairings.push(pairing);
+/**
+ *
+ * @param {object} tournamentRecord - passed automatically if tournamentEngine.setState()
+ * @param {string} eventId - resolves to event
+ * @param {string} drawId - OPTIONAL - resolves drawDefinition - scopes participants to clear to drawDefinition.entries or flightProfile.flight.drawEntries
+ * @param {string} scaleAttributes - { scaleType, scaleName, eventType }
+ * @param {string} stage - OPTIONAL - filter event or draw entries by stage
+ * @returns {boolean} { success: true } or { error }
+ */
+function removeScaleValues(_a) {
+    var _b;
+    var tournamentRecord = _a.tournamentRecord, scaleAttributes = _a.scaleAttributes, drawDefinition = _a.drawDefinition, entryStatuses = _a.entryStatuses, drawId = _a.drawId, event = _a.event, stage = _a.stage;
+    if (!event)
+        return { error: MISSING_EVENT };
+    if (entryStatuses && !Array.isArray(entryStatuses))
+        return decorateResult({
+            result: { error: INVALID_VALUES },
+            info: mustBeAnArray('entryStatus'),
+            stack: 'removeScaleValues',
         });
+    var entries = event.entries;
+    if (drawId) {
+        var flightProfile = getFlightProfile({ event: event }).flightProfile;
+        var flight = (_b = flightProfile === null || flightProfile === void 0 ? void 0 : flightProfile.flights) === null || _b === void 0 ? void 0 : _b.find(function (flight) { return flight.drawId === drawId; });
+        if (flight) {
+            entries = flight.drawEntries;
+        }
+        else {
+            entries = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries;
+        }
+    }
+    var stageEntries = (entries || []).filter(function (entry) {
+        return (!stage || !entry.entryStage || entry.entryStage === stage) &&
+            (!entryStatuses || entryStatuses.includes(entry.entryStatus));
+    });
+    var participantIds = stageEntries.map(getParticipantId);
+    return removeParticipantsScaleItems({
+        tournamentRecord: tournamentRecord,
+        scaleAttributes: scaleAttributes,
+        participantIds: participantIds,
     });
-    var deltaObjects = Object.assign.apply(Object, __spreadArray([{}], __read(uniquePairings.map(function (pairing) {
-        var _a;
-        return (_a = {}, _a[pairing] = 0, _a);
-    })), false));
-    return { uniquePairings: uniquePairings, possiblePairings: possiblePairings, deltaObjects: deltaObjects };
 }
 
-function getEncounters(_a) {
-    var e_1, _b;
-    var matchUps = _a.matchUps;
-    var encounters = [];
+function applyLineUps(_a) {
+    var e_1, _b, e_2, _c, e_3, _d, e_4, _e;
+    var _f, _g, _h, _j;
+    var tournamentRecord = _a.tournamentRecord, drawDefinition = _a.drawDefinition, matchUpId = _a.matchUpId, lineUps = _a.lineUps, event = _a.event;
+    if (!tournamentRecord)
+        return { error: MISSING_TOURNAMENT_RECORD };
+    if (!drawDefinition)
+        return { error: DRAW_DEFINITION_NOT_FOUND };
+    if (typeof matchUpId !== 'string')
+        return { error: INVALID_MATCHUP };
+    if (!Array.isArray(lineUps))
+        return { error: INVALID_VALUES, lineUps: lineUps };
+    var stack = 'applyLineUps';
+    var tournamentParticipants = tournamentRecord.participants || [];
+    var result = findDrawMatchUp({
+        tournamentParticipants: tournamentParticipants,
+        inContext: true,
+        drawDefinition: drawDefinition,
+        matchUpId: matchUpId,
+    });
+    if (result.error)
+        return result;
+    if (!result.matchUp)
+        return { error: MATCHUP_NOT_FOUND };
+    var inContextMatchUp = result.matchUp, structure = result.structure;
+    var drawPositions = inContextMatchUp.drawPositions, matchUpType = inContextMatchUp.matchUpType;
+    if (matchUpType !== TEAM$1)
+        return { error: INVALID_MATCHUP };
+    if (!(drawPositions === null || drawPositions === void 0 ? void 0 : drawPositions.length))
+        return { error: MISSING_DRAW_POSITIONS };
+    var tieFormat = (_f = resolveTieFormat({
+        matchUp: inContextMatchUp,
+        drawDefinition: drawDefinition,
+        structure: structure,
+        event: event,
+    })) === null || _f === void 0 ? void 0 : _f.tieFormat;
+    // verify integrity of lineUps...
+    // 1. all participantIds must be valid individualParticipantIds
+    // 2. there should be at most one participantId for a given collectionPosition in singles
+    // 3. there should be at most two participantIds for a given collectionPosition in doubles
+    var sideAssignments = {};
     try {
-        for (var matchUps_1 = __values(matchUps), matchUps_1_1 = matchUps_1.next(); !matchUps_1_1.done; matchUps_1_1 = matchUps_1.next()) {
-            var matchUp = matchUps_1_1.value;
-            var participantIds = matchUp.sides.map(extractAttributes('participantId'));
-            if (participantIds.length === 2) {
-                var _c = __read(participantIds, 2), p1 = _c[0], p2 = _c[1];
-                var pairing = pairingHash(p1, p2);
-                if (!encounters.includes(pairing))
-                    encounters.push(pairing);
+        for (var lineUps_1 = __values(lineUps), lineUps_1_1 = lineUps_1.next(); !lineUps_1_1.done; lineUps_1_1 = lineUps_1.next()) {
+            var lineUp = lineUps_1_1.value;
+            if (!Array.isArray(lineUp))
+                return { error: INVALID_VALUES, lineUp: lineUp };
+            // maintain mapping of collectionId|collectionPosition to the participantIds assigned
+            var collectionParticipantIds = {};
+            var sideNumbers = [];
+            var _loop_1 = function (lineUpAssignment) {
+                var e_5, _m;
+                if (typeof lineUpAssignment !== 'object')
+                    return { value: { error: INVALID_VALUES, lineUpAssignment: lineUpAssignment } };
+                var participantId = lineUpAssignment.participantId, _o = lineUpAssignment.collectionAssignments, collectionAssignments = _o === void 0 ? [] : _o;
+                if (!Array.isArray(collectionAssignments))
+                    return { value: { error: INVALID_VALUES, collectionAssignments: collectionAssignments } };
+                var participant = tournamentParticipants.find(function (participant) { return participant.participantId === participantId; });
+                if (!participant)
+                    return { value: { error: PARTICIPANT_NOT_FOUND } };
+                if (participant.participantType !== INDIVIDUAL)
+                    return { value: { error: INVALID_PARTICIPANT_TYPE } };
+                var sideNumber_1 = (_h = (_g = inContextMatchUp.sides) === null || _g === void 0 ? void 0 : _g.find(function (side) { var _a, _b; return (_b = (_a = side.participant) === null || _a === void 0 ? void 0 : _a.individualParticipantIds) === null || _b === void 0 ? void 0 : _b.includes(participantId); })) === null || _h === void 0 ? void 0 : _h.sideNumber;
+                if (sideNumber_1)
+                    sideNumbers.push(sideNumber_1);
+                var _loop_3 = function (collectionAssignment) {
+                    if (typeof collectionAssignment !== 'object')
+                        return { value: { error: INVALID_VALUES, collectionAssignment: collectionAssignment } };
+                    var collectionId = collectionAssignment.collectionId, collectionPosition = collectionAssignment.collectionPosition;
+                    var collectionDefinition = (_j = tieFormat === null || tieFormat === void 0 ? void 0 : tieFormat.collectionDefinitions) === null || _j === void 0 ? void 0 : _j.find(function (collectionDefinition) {
+                        return collectionDefinition.collectionId === collectionId;
+                    });
+                    // all collectionIds in the lineUp must be present in the tieFormat collectionDefinitions
+                    if (!collectionDefinition)
+                        return { value: { error: INVALID_VALUES, collectionId: collectionId } };
+                    var aggregator = "".concat(collectionId, "-").concat(collectionPosition);
+                    if (!collectionParticipantIds[aggregator]) {
+                        collectionParticipantIds[aggregator] = [];
+                    }
+                    var participantsCount = collectionParticipantIds[aggregator].length;
+                    if ((collectionDefinition.matchUpType === SINGLES && participantsCount) ||
+                        (collectionDefinition.matchUpType === DOUBLES &&
+                            participantsCount > 1)) {
+                        return { value: {
+                                info: 'Excessive collectionPosition assignments',
+                                error: INVALID_VALUES,
+                            } };
+                    }
+                    collectionParticipantIds[aggregator].push(participantId);
+                };
+                try {
+                    for (var collectionAssignments_1 = (e_5 = void 0, __values(collectionAssignments)), collectionAssignments_1_1 = collectionAssignments_1.next(); !collectionAssignments_1_1.done; collectionAssignments_1_1 = collectionAssignments_1.next()) {
+                        var collectionAssignment = collectionAssignments_1_1.value;
+                        var state_2 = _loop_3(collectionAssignment);
+                        if (typeof state_2 === "object")
+                            return state_2;
+                    }
+                }
+                catch (e_5_1) { e_5 = { error: e_5_1 }; }
+                finally {
+                    try {
+                        if (collectionAssignments_1_1 && !collectionAssignments_1_1.done && (_m = collectionAssignments_1.return)) _m.call(collectionAssignments_1);
+                    }
+                    finally { if (e_5) throw e_5.error; }
+                }
+            };
+            try {
+                for (var lineUp_1 = (e_2 = void 0, __values(lineUp)), lineUp_1_1 = lineUp_1.next(); !lineUp_1_1.done; lineUp_1_1 = lineUp_1.next()) {
+                    var lineUpAssignment = lineUp_1_1.value;
+                    var state_1 = _loop_1(lineUpAssignment);
+                    if (typeof state_1 === "object")
+                        return state_1.value;
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (lineUp_1_1 && !lineUp_1_1.done && (_c = lineUp_1.return)) _c.call(lineUp_1);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+            // ensure that doubles pair participants exist, otherwise create
+            var collectionParticipantIdPairs = Object.values(collectionParticipantIds);
+            try {
+                for (var collectionParticipantIdPairs_1 = (e_3 = void 0, __values(collectionParticipantIdPairs)), collectionParticipantIdPairs_1_1 = collectionParticipantIdPairs_1.next(); !collectionParticipantIdPairs_1_1.done; collectionParticipantIdPairs_1_1 = collectionParticipantIdPairs_1.next()) {
+                    var participantIds = collectionParticipantIdPairs_1_1.value;
+                    if (participantIds.length === 2) {
+                        var pairedParticipant = getPairedParticipant({
+                            tournamentParticipants: tournamentParticipants,
+                            participantIds: participantIds,
+                        }).participant;
+                        if (!pairedParticipant) {
+                            // create pair participant
+                            var newPairParticipant = {
+                                participantType: PAIR,
+                                participantRole: COMPETITOR,
+                                individualParticipantIds: participantIds,
+                            };
+                            var result_1 = addParticipant({
+                                participant: newPairParticipant,
+                                pairOverride: true,
+                                tournamentRecord: tournamentRecord,
+                            });
+                            if (result_1.error)
+                                return result_1;
+                        }
+                    }
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (collectionParticipantIdPairs_1_1 && !collectionParticipantIdPairs_1_1.done && (_d = collectionParticipantIdPairs_1.return)) _d.call(collectionParticipantIdPairs_1);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+            // determine sideNumber based on instances of participants appearing in team participants assigned to sides
+            // allows for some team members to be "borrowed"
+            var instances = instanceCount(sideNumbers);
+            var sideNumber = ((instances[1] || 0) > (instances[2] || 0) && 1) ||
+                ((instances[2] || 0) > (instances[1] || 0) && 2) ||
+                undefined;
+            // if side not previously assigned, map sideNumber to lineUp
+            var sideAssignmentKeys = Object.keys(sideAssignments).map(function (key) {
+                return parseInt(key);
+            });
+            if (sideNumber && !sideAssignmentKeys.includes(sideNumber)) {
+                sideAssignments[sideNumber] = lineUp;
             }
         }
     }
     catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (matchUps_1_1 && !matchUps_1_1.done && (_b = matchUps_1.return)) _b.call(matchUps_1);
+            if (lineUps_1_1 && !lineUps_1_1.done && (_b = lineUps_1.return)) _b.call(lineUps_1);
         }
         finally { if (e_1) throw e_1.error; }
     }
-    return { encounters: encounters };
-}
-
-function getParticipantPairingValues(_a) {
-    var e_1, _b;
-    var possiblePairings = _a.possiblePairings, valueObjects = _a.valueObjects;
-    var pairingValues = {};
-    var _loop_1 = function (participantId) {
-        var participantValues = possiblePairings[participantId].map(function (opponent) {
-            return pairingValue(participantId, opponent);
-        });
-        pairingValues[participantId] = participantValues.sort(function (a, b) { return a.value - b.value; });
+    if (!Object.keys(sideAssignments).length)
+        return { error: VALUE_UNCHANGED };
+    result = findDrawMatchUp({ drawDefinition: drawDefinition, matchUpId: matchUpId });
+    if (result.error)
+        return result;
+    if (!result.matchUp)
+        return { error: MATCHUP_NOT_FOUND };
+    var matchUp = result.matchUp;
+    if (!matchUp.sides)
+        matchUp.sides = [];
+    var _loop_2 = function (sideNumber) {
+        var side = matchUp.sides.find(function (side) { return side.sideNumber === sideNumber; });
+        var assignment = sideAssignments[sideNumber];
+        if (!assignment) {
+            return "continue";
+        }
+        else if (!side) {
+            matchUp.sides.push({ lineUp: assignment, sideNumber: sideNumber });
+        }
+        else {
+            side.lineUp = assignment;
+        }
     };
     try {
-        for (var _c = __values(Object.keys(possiblePairings)), _d = _c.next(); !_d.done; _d = _c.next()) {
-            var participantId = _d.value;
-            _loop_1(participantId);
+        for (var _k = __values([1, 2]), _l = _k.next(); !_l.done; _l = _k.next()) {
+            var sideNumber = _l.value;
+            _loop_2(sideNumber);
         }
     }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
     finally {
         try {
-            if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+            if (_l && !_l.done && (_e = _k.return)) _e.call(_k);
         }
-        finally { if (e_1) throw e_1.error; }
-    }
-    function pairingValue(participantId, opponent) {
-        var key = pairingHash(participantId, opponent);
-        return { opponent: opponent, value: valueObjects[key] };
+        finally { if (e_4) throw e_4.error; }
     }
-    return { pairingValues: pairingValues };
-}
-
-var ELO = 'ELO';
-var NTRP = 'NTRP';
-var TRN = 'TRN';
-var UTR = 'UTR';
-var WTN = 'WTN';
-var ratingConstants = {
-    ELO: ELO,
-    NTRP: NTRP,
-    TRN: TRN,
-    UTR: UTR,
-    WTN: WTN,
-};
-
-var _a$e;
-var ratingsParameters = (_a$e = {},
-    _a$e[ELO] = {
-        defaultInitialization: 1500,
-        decimalsCount: 0,
-        range: [0, 3000],
-        ascending: true,
-    },
-    _a$e[NTRP] = {
-        accessors: ['ntrpRating', 'dntrpRatingHundredths'],
-        attributes: { ustaRatingType: '' },
-        accessor: 'dntrpRatingHundredths',
-        defaultInitialization: 3,
-        decimalsCount: 1,
-        ascending: true,
-        range: [1, 7],
-    },
-    _a$e[UTR] = {
-        defaultInitialization: 6,
-        accessors: ['utrRating'],
-        accessor: 'utrRating',
-        decimalsCount: 2,
-        ascending: true,
-        range: [1, 16],
-    },
-    _a$e[WTN] = {
-        attributes: { confidence: { generator: true, range: [60, 100] } },
-        accessors: ['wtnRating', 'confidence'],
-        defaultInitialization: 23,
-        accessor: 'wtnRating',
-        ascending: false,
-        decimalsCount: 2,
-        range: [40, 1],
-    },
-    _a$e);
-
-var DEFAULT_RATING = 0;
-function getSideRatings(_a) {
-    var _b, _c;
-    var tournamentParticipants = _a.tournamentParticipants, adHocRatings = _a.adHocRatings, eventType = _a.eventType, scaleName = _a.scaleName, pairing = _a.pairing;
-    var defaultRating = (_c = (_b = ratingsParameters[scaleName]) === null || _b === void 0 ? void 0 : _b.defaultInitialization) !== null && _c !== void 0 ? _c : DEFAULT_RATING;
-    return pairing.split('|').map(function (participantId) {
-        var _a;
-        if (eventType === DOUBLES$1) {
-            var individualParticipantIds = (_a = tournamentParticipants === null || tournamentParticipants === void 0 ? void 0 : tournamentParticipants.find(function (participant) { return participant.participantId === participantId; })) === null || _a === void 0 ? void 0 : _a.individualParticipantIds;
-            return !individualParticipantIds
-                ? defaultRating * 2
-                : individualParticipantIds === null || individualParticipantIds === void 0 ? void 0 : individualParticipantIds.map(function (participantId) { return adHocRatings[participantId] || defaultRating; });
-        }
-        else {
-            return adHocRatings[participantId] || defaultRating;
-        }
+    modifyMatchUpNotice({
+        tournamentId: tournamentRecord === null || tournamentRecord === void 0 ? void 0 : tournamentRecord.tournamentId,
+        context: stack,
+        drawDefinition: drawDefinition,
+        matchUp: matchUp,
     });
+    return __assign({}, SUCCESS);
 }
 
-function getPairings(_a) {
-    var tournamentParticipants = _a.tournamentParticipants, _b = _a.adHocRatings, adHocRatings = _b === void 0 ? {} : _b, possiblePairings = _a.possiblePairings, // participant keyed; provides array of possible opponents
-    uniquePairings = _a.uniquePairings, // hashes of all possible participantId pairings
-    maxIterations = _a.maxIterations, deltaObjects = _a.deltaObjects, // difference in rating between paired participants
-    valueObjects = _a.valueObjects, // calculated value of a pairing of participants, used for sorting pairings
-    eventType = _a.eventType, scaleName = _a.scaleName, salted = _a.salted;
-    // modify valueObjects by ratings ratingsDifference squared
-    // update deltaObjects to reflect the current difference between participant's ratings
-    uniquePairings.forEach(function (pairing) {
-        var ratings = getSideRatings({
-            tournamentParticipants: tournamentParticipants,
-            adHocRatings: adHocRatings,
-            scaleName: scaleName,
-            eventType: eventType,
-            pairing: pairing,
+function resetTieFormat(params) {
+    var _a, _b, e_1, _c, e_2, _d;
+    var _e, _f, _g;
+    var stack = 'resetTieFormat';
+    var drawDefinition = params.drawDefinition, event = params.event, uuids = params.uuids;
+    var paramCheck = checkRequiredParameters(params, [(_a = {}, _a[TOURNAMENT_RECORD] = true, _a[MATCHUP_ID] = true, _a)], stack);
+    if (paramCheck.error)
+        return paramCheck;
+    var resolutions = resolveFromParameters(params, [(_b = {}, _b[PARAM] = MATCHUP, _b)]);
+    if (resolutions[ERROR])
+        return resolutions;
+    var tournamentId = (_e = params.tournamentRecord) === null || _e === void 0 ? void 0 : _e.tournamentId;
+    var _h = (_f = resolutions === null || resolutions === void 0 ? void 0 : resolutions.matchUp) !== null && _f !== void 0 ? _f : {}, matchUp = _h.matchUp, structure = _h.structure;
+    if (!(matchUp === null || matchUp === void 0 ? void 0 : matchUp.tieMatchUps))
+        return decorateResult({
+            result: { error: INVALID_MATCHUP },
+            info: 'Must be a TEAM matchUp',
+            stack: stack,
         });
-        var salting = (typeof salted === 'number' && salted) || 0.5;
-        var salt = (salted && (Math.round(Math.random()) ? salting : salting * -1)) || 0;
-        var ratingsDifference = Math.abs(ratings[0] - ratings[1]) + salt;
-        var pairingDelta = Math.abs(ratings[0] - ratings[1]);
-        deltaObjects[pairing] = pairingDelta;
-        if (!valueObjects[pairing])
-            valueObjects[pairing] = 0;
-        valueObjects[pairing] += ratingsDifference
-            ? Math.pow(ratingsDifference, 2)
-            : 0;
-    });
-    /**
-     * valueSortedPairings are uniquePairings sorted by the ratings difference of the pairings, lowest to highest
-     */
-    var valueSortedPairings = uniquePairings
-        .map(function (pairing) { return ({ pairing: pairing, value: valueObjects[pairing] }); })
-        .sort(function (a, b) { return a.value - b.value; });
-    /**
-     * pairingValues is keyed by participantId and provides a value-sorted array of pairings for each participantId
-     * 'actorId': [
-          { opponent: 'potentialId1', value: 1 },
-          { opponent: 'potentialId2', value: 1 },
-     */
-    var pairingValues = getParticipantPairingValues({
-        possiblePairings: possiblePairings,
-        valueObjects: valueObjects,
-    }).pairingValues;
-    var _c = generateCandidate({
-        valueSortedPairings: valueSortedPairings,
-        maxIterations: maxIterations,
-        pairingValues: pairingValues,
-        deltaObjects: deltaObjects,
-        valueObjects: valueObjects,
-    }), candidate = _c.candidate, candidatesCount = _c.candidatesCount, deltaCandidate = _c.deltaCandidate, iterations = _c.iterations;
-    var participantIdPairings = candidate.participantIdPairings;
-    return {
-        participantIdPairings: participantIdPairings,
-        candidatesCount: candidatesCount,
-        deltaCandidate: deltaCandidate,
-        iterations: iterations,
-        candidate: candidate,
+    // if there is no tieFormat there is nothing to do
+    if (!matchUp.tieFormat)
+        return __assign({}, SUCCESS);
+    var tieFormat = (_g = resolveTieFormat({
+        structure: structure,
+        drawDefinition: drawDefinition,
+        event: event,
+    })) === null || _g === void 0 ? void 0 : _g.tieFormat;
+    if (!tieFormat)
+        return decorateResult({
+            result: { error: NOT_FOUND },
+            info: 'No inherited tieFormat',
+            stack: stack,
+        });
+    var deletedMatchUpIds = [];
+    var collectionIds = [];
+    var tieMatchUps = [];
+    var newMatchUps = [];
+    var _loop_1 = function (collectionDefinition) {
+        // delete any matchUp.tieMatchUps that are not found in the ancestor tieFormat collectionDefinitions
+        var matchUpCount = collectionDefinition.matchUpCount, collectionId = collectionDefinition.collectionId;
+        collectionIds.push(collectionId);
+        var existingCollectionMatchUps = (matchUp.tieMatchUps || []).filter(function (matchUp) { return matchUp.collectionId === collectionId; });
+        if (existingCollectionMatchUps.length > matchUpCount) {
+            // sort by matchUpStatus to prioritize active or completed matchUpsA
+            existingCollectionMatchUps.sort(function (a, b) {
+                return (a.matchUpStatus === TO_BE_PLAYED ? 1 : 0) -
+                    (b.matchUpStatus === TO_BE_PLAYED ? 1 : 0);
+            });
+            tieMatchUps.push.apply(tieMatchUps, __spreadArray([], __read(existingCollectionMatchUps.slice(0, matchUpCount)), false));
+            deletedMatchUpIds.push.apply(deletedMatchUpIds, __spreadArray([], __read(existingCollectionMatchUps.slice(3).map(getMatchUpId)), false));
+        }
+        else {
+            tieMatchUps.push.apply(tieMatchUps, __spreadArray([], __read(existingCollectionMatchUps), false));
+            if (existingCollectionMatchUps.length < matchUpCount) {
+                var matchUpsLimit = matchUpCount - existingCollectionMatchUps.length;
+                var matchUps = generateCollectionMatchUps({
+                    collectionDefinition: collectionDefinition,
+                    matchUpsLimit: matchUpsLimit,
+                    uuids: uuids,
+                });
+                newMatchUps.push.apply(newMatchUps, __spreadArray([], __read(matchUps), false));
+            }
+        }
     };
-}
-
-// this should be in policyDefinitions
-var ENCOUNTER_VALUE = 100;
-var SAME_TEAM_VALUE = 100;
-var MAX_ITERATIONS = 4000;
-function generateDrawMaticRound(_a) {
-    var e_1, _b, e_2, _c, e_3, _d;
-    var _e, _f;
-    var _g = _a.encounterValue, encounterValue = _g === void 0 ? ENCOUNTER_VALUE : _g, _h = _a.sameTeamValue, sameTeamValue = _h === void 0 ? SAME_TEAM_VALUE : _h, _j = _a.maxIterations, maxIterations = _j === void 0 ? MAX_ITERATIONS : _j, _k = _a.generateMatchUps, generateMatchUps = _k === void 0 ? true : _k, tournamentParticipants = _a.tournamentParticipants, participantIds = _a.participantIds, drawDefinition = _a.drawDefinition, adHocRatings = _a.adHocRatings, structureId = _a.structureId, _l = _a.salted, salted = _l === void 0 ? 0.5 : _l, matchUpIds = _a.matchUpIds, eventType = _a.eventType, structure = _a.structure, scaleName = _a.scaleName;
-    if (!drawDefinition)
-        return { error: MISSING_DRAW_DEFINITION };
-    if (!structure && !structureId)
-        return { error: STRUCTURE_NOT_FOUND };
-    if (!structure) {
-        structure = findStructure({ drawDefinition: drawDefinition, structureId: structureId }).structure;
-    }
-    if (!isObject(structure))
-        return { error: MISSING_STRUCTURE };
-    if (!(participantIds === null || participantIds === void 0 ? void 0 : participantIds.length)) {
-        return { error: MISSING_PARTICIPANT_IDS };
-    }
-    // create valueObject for each previous encounter within the structure
-    var encounters = getEncounters({ matchUps: (_e = structure === null || structure === void 0 ? void 0 : structure.matchUps) !== null && _e !== void 0 ? _e : [] }).encounters;
-    // valueObjects provide "weighting" to each possible pairing of participants
-    // {
-    //  'P-I-0|P-I-1': 1,
-    //  'P-I-0|P-I-2': 1,
-    //  'P-I-0|P-I-3': 1
-    // }
-    var valueObjects = {};
     try {
-        for (var encounters_1 = __values(encounters), encounters_1_1 = encounters_1.next(); !encounters_1_1.done; encounters_1_1 = encounters_1.next()) {
-            var pairing = encounters_1_1.value;
-            if (!valueObjects[pairing])
-                valueObjects[pairing] = 0;
-            valueObjects[pairing] += encounterValue;
+        for (var _j = __values(tieFormat.collectionDefinitions), _k = _j.next(); !_k.done; _k = _j.next()) {
+            var collectionDefinition = _k.value;
+            _loop_1(collectionDefinition);
         }
     }
     catch (e_1_1) { e_1 = { error: e_1_1 }; }
     finally {
         try {
-            if (encounters_1_1 && !encounters_1_1.done && (_b = encounters_1.return)) _b.call(encounters_1);
+            if (_k && !_k.done && (_c = _j.return)) _c.call(_j);
         }
         finally { if (e_1) throw e_1.error; }
     }
-    var teamParticipants = tournamentParticipants === null || tournamentParticipants === void 0 ? void 0 : tournamentParticipants.filter(function (_a) {
-        var participantType = _a.participantType;
-        return participantType === TEAM;
-    });
-    if (teamParticipants) {
-        try {
-            // add SAME_TEAM_VALUE for participants who appear on the same team
-            for (var teamParticipants_1 = __values(teamParticipants), teamParticipants_1_1 = teamParticipants_1.next(); !teamParticipants_1_1.done; teamParticipants_1_1 = teamParticipants_1.next()) {
-                var teamParticipant = teamParticipants_1_1.value;
-                var participantIds_1 = (_f = teamParticipant.individualParticipantIds) !== null && _f !== void 0 ? _f : [];
-                var uniquePairings_2 = getPairingsData({ participantIds: participantIds_1 }).uniquePairings;
-                try {
-                    for (var uniquePairings_1 = (e_3 = void 0, __values(uniquePairings_2)), uniquePairings_1_1 = uniquePairings_1.next(); !uniquePairings_1_1.done; uniquePairings_1_1 = uniquePairings_1.next()) {
-                        var pairing = uniquePairings_1_1.value;
-                        if (!valueObjects[pairing])
-                            valueObjects[pairing] = 0;
-                        valueObjects[pairing] += sameTeamValue;
-                    }
-                }
-                catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                finally {
-                    try {
-                        if (uniquePairings_1_1 && !uniquePairings_1_1.done && (_d = uniquePairings_1.return)) _d.call(uniquePairings_1);
-                    }
-                    finally { if (e_3) throw e_3.error; }
-                }
-            }
+    try {
+        for (var _l = __values((matchUp === null || matchUp === void 0 ? void 0 : matchUp.tieMatchUps) || []), _m = _l.next(); !_m.done; _m = _l.next()) {
+            var tieMatchUp = _m.value;
+            if (tieMatchUp.collectionId &&
+                !collectionIds.includes(tieMatchUp.collectionId))
+                deletedMatchUpIds.push(tieMatchUp.matchUpId);
         }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-        finally {
-            try {
-                if (teamParticipants_1_1 && !teamParticipants_1_1.done && (_c = teamParticipants_1.return)) _c.call(teamParticipants_1);
-            }
-            finally { if (e_2) throw e_2.error; }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (_m && !_m.done && (_d = _l.return)) _d.call(_l);
         }
+        finally { if (e_2) throw e_2.error; }
     }
-    // deltaObjects contain the difference in ratings between two participants
-    // {
-    //  'P-I-0|P-I-1': 0,
-    //  'P-I-0|P-I-2': 0,
-    //  'P-I-0|P-I-3': 0
-    // }
-    var _m = getPairingsData({
-        participantIds: participantIds,
-    }), uniquePairings = _m.uniquePairings, possiblePairings = _m.possiblePairings, deltaObjects = _m.deltaObjects;
-    var params = {
-        tournamentParticipants: tournamentParticipants,
-        possiblePairings: possiblePairings,
-        drawDefinition: drawDefinition,
-        participantIds: participantIds,
-        uniquePairings: uniquePairings,
-        maxIterations: maxIterations,
-        adHocRatings: adHocRatings,
-        deltaObjects: deltaObjects,
-        valueObjects: valueObjects,
-        eventType: eventType,
-        scaleName: scaleName,
-        structure: structure,
-        salted: salted,
-    };
-    var _o = getPairings(params), candidatesCount = _o.candidatesCount, participantIdPairings = _o.participantIdPairings, iterations = _o.iterations, candidate = _o.candidate;
-    if (!candidatesCount)
-        return { error: NO_CANDIDATES };
-    var matchUps;
-    if (generateMatchUps) {
-        var result = generateAdHocMatchUps({
+    if (newMatchUps.length) {
+        tieMatchUps.push.apply(tieMatchUps, __spreadArray([], __read(newMatchUps), false));
+        addMatchUpsNotice({
+            eventId: event === null || event === void 0 ? void 0 : event.eventId,
+            matchUps: newMatchUps,
+            drawDefinition: drawDefinition,
+            tournamentId: tournamentId,
+        });
+    }
+    if (deletedMatchUpIds.length) {
+        deleteMatchUpsNotice({
+            matchUpIds: deletedMatchUpIds,
+            eventId: event === null || event === void 0 ? void 0 : event.eventId,
+            drawDefinition: drawDefinition,
+            tournamentId: tournamentId,
+        });
+    }
+    if (matchUp) {
+        matchUp.tieMatchUps = tieMatchUps;
+        matchUp.tieFormatId = undefined;
+        matchUp.tieFormat = undefined;
+        modifyMatchUpNotice({
             structureId: structure === null || structure === void 0 ? void 0 : structure.structureId,
-            participantIdPairings: participantIdPairings,
-            newRound: true,
+            eventId: event === null || event === void 0 ? void 0 : event.eventId,
+            context: stack,
             drawDefinition: drawDefinition,
-            matchUpIds: matchUpIds,
+            tournamentId: tournamentId,
+            matchUp: matchUp,
         });
-        if (result.error)
-            return result;
-        matchUps = result.matchUps;
     }
-    var maxDelta = candidate.maxDelta, maxDiff = candidate.maxDiff;
-    return __assign(__assign({}, SUCCESS), { participantIdPairings: participantIdPairings, candidatesCount: candidatesCount, iterations: iterations, matchUps: matchUps, maxDelta: maxDelta, maxDiff: maxDiff });
+    return __assign(__assign({}, SUCCESS), { newMatchUps: newMatchUps, deletedMatchUpIds: deletedMatchUpIds });
 }
 
-function drawMatic$1(_a) {
-    var e_1, _b;
-    var _c, _d, _e, _f, _g;
-    var tournamentParticipants = _a.tournamentParticipants, restrictEntryStatus = _a.restrictEntryStatus, _h = _a.adHocRatings, adHocRatings = _h === void 0 ? {} : _h, generateMatchUps = _a.generateMatchUps, tournamentRecord = _a.tournamentRecord, participantIds = _a.participantIds, encounterValue = _a.encounterValue, sameTeamValue = _a.sameTeamValue, drawDefinition = _a.drawDefinition, scaleAccessor = _a.scaleAccessor, maxIterations = _a.maxIterations, structureId = _a.structureId, matchUpIds = _a.matchUpIds, scaleName = _a.scaleName, // custom rating name to seed dynamic ratings
-    eventType = _a.eventType, salted = _a.salted, event = _a.event;
-    if (typeof drawDefinition !== 'object' ||
-        (drawDefinition.drawType && drawDefinition.drawType !== AD_HOC)) {
-        return { error: INVALID_DRAW_DEFINITION };
-    }
-    if (!Array.isArray(drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries) &&
-        participantIds &&
-        !Array.isArray(participantIds)) {
-        return { error: INVALID_VALUES, info: 'Missing Entries' };
-    }
-    eventType = eventType !== null && eventType !== void 0 ? eventType : event === null || event === void 0 ? void 0 : event.eventType;
-    var enteredParticipantIds = (_c = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.entries) === null || _c === void 0 ? void 0 : _c.filter(function (entry) {
-        var entryStatus = entry.entryStatus;
-        return (!restrictEntryStatus ||
-            STRUCTURE_SELECTED_STATUSES.includes(entryStatus));
-    }).map(getParticipantId);
-    if (participantIds) {
-        // ensure all participantIds are in drawDefinition.entries
-        var invalidParticipantIds = participantIds.filter(function (participantId) { return !(enteredParticipantIds === null || enteredParticipantIds === void 0 ? void 0 : enteredParticipantIds.includes(participantId)); });
-        if (invalidParticipantIds === null || invalidParticipantIds === void 0 ? void 0 : invalidParticipantIds.length)
-            return decorateResult({
-                result: { error: INVALID_PARTICIPANT_ID },
-                info: { invalidParticipantIds: invalidParticipantIds },
-            });
-    }
-    else {
-        participantIds = enteredParticipantIds;
-    }
-    // if no structureId is specified find the latest AD_HOC stage which has matchUps
-    if (!structureId) {
-        var targetStructure = (_e = (_d = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.structures) === null || _d === void 0 ? void 0 : _d.filter(function (structure) { return structure.stageSequence === 1; })) === null || _e === void 0 ? void 0 : _e.reduce(function (targetStructure, structure) {
-            var orderNumber = structure.stage && stageOrder$1[structure.stage];
-            var structureIsAdHoc = isAdHoc({ drawDefinition: drawDefinition, structure: structure });
-            return structureIsAdHoc &&
-                orderNumber > (stageOrder$1[targetStructure === null || targetStructure === void 0 ? void 0 : targetStructure.stage] || 1)
-                ? structure
-                : targetStructure;
-        }, undefined);
-        structureId = targetStructure === null || targetStructure === void 0 ? void 0 : targetStructure.structureId;
-    }
-    var structure = (_f = drawDefinition === null || drawDefinition === void 0 ? void 0 : drawDefinition.structures) === null || _f === void 0 ? void 0 : _f.find(function (structure) { return structure.structureId === structureId; });
-    if (!structure)
-        return { error: STRUCTURE_NOT_FOUND };
-    // an AD_HOC structure is one that has no child structures and in which no matchUps have roundPosition
-    var structureIsAdHoc = isAdHoc({ drawDefinition: drawDefinition, structure: structure });
-    if (!structureIsAdHoc)
-        return { error: INVALID_DRAW_DEFINITION };
-    tournamentParticipants =
-        (_g = tournamentParticipants !== null && tournamentParticipants !== void 0 ? tournamentParticipants : tournamentRecord.participants) !== null && _g !== void 0 ? _g : [];
-    var _loop_1 = function (participantId) {
-        var participant = tournamentParticipants === null || tournamentParticipants === void 0 ? void 0 : tournamentParticipants.find(function (participant) { return participant.participantId === participantId; });
-        // first see if there is already a dynamic value
-        var scaleValue = getScaleValue({
-            scaleName: "".concat(scaleName, ".").concat(DYNAMIC),
-            scaleAccessor: scaleAccessor,
-            participant: participant,
-            eventType: eventType,
+function resetScorecard(params) {
+    var e_1, _a;
+    var _b, _c;
+    var tournamentRecord = params.tournamentRecord, drawDefinition = params.drawDefinition, matchUpId = params.matchUpId, event = params.event;
+    var stack = 'resetScorecard';
+    // Check for missing parameters ---------------------------------------------
+    if (!drawDefinition)
+        return decorateResult({
+            result: { error: MISSING_DRAW_DEFINITION },
+            stack: stack,
         });
-        // if no dynamic value found and a seeding scaleValue is provided...
-        if (!scaleValue && scaleName) {
-            scaleValue = getScaleValue({
-                scaleAccessor: scaleAccessor,
-                participant: participant,
-                scaleName: scaleName,
-                eventType: eventType,
-            });
-        }
-        if (scaleValue && !adHocRatings[participantId])
-            adHocRatings[participantId] = scaleValue;
-    };
-    try {
-        for (var _j = __values(participantIds !== null && participantIds !== void 0 ? participantIds : []), _k = _j.next(); !_k.done; _k = _j.next()) {
-            var participantId = _k.value;
-            _loop_1(participantId);
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
+    if (!matchUpId)
+        return decorateResult({ result: { error: MISSING_MATCHUP_ID }, stack: stack });
+    if (!isString(matchUpId))
+        return decorateResult({
+            result: { error: INVALID_VALUES, matchUpId: matchUpId },
+            stack: stack,
+        });
+    // Get map of all drawMatchUps and inContextDrawMatchUPs ---------------------
+    var matchUpsMap = getMatchUpsMap({ drawDefinition: drawDefinition });
+    var inContextDrawMatchUps = getAllDrawMatchUps({
+        nextMatchUps: true,
+        inContext: true,
+        drawDefinition: drawDefinition,
+        matchUpsMap: matchUpsMap,
+    }).matchUps;
+    // Find target matchUp ------------------------------------------------------
+    var matchUp = matchUpsMap.drawMatchUps.find(function (matchUp) { return matchUp.matchUpId === matchUpId; });
+    var inContextMatchUp = inContextDrawMatchUps === null || inContextDrawMatchUps === void 0 ? void 0 : inContextDrawMatchUps.find(function (matchUp) { return matchUp.matchUpId === matchUpId; });
+    if (!matchUp || !inContextDrawMatchUps)
+        return { error: MATCHUP_NOT_FOUND };
+    // only accept matchUpType: TEAM
+    if (matchUp.matchUpType !== TEAM_EVENT)
+        return { error: INVALID_MATCHUP };
+    // Get winner/loser position targets ----------------------------------------
+    var targetData = positionTargets({
+        inContextDrawMatchUps: inContextDrawMatchUps,
+        drawDefinition: drawDefinition,
+        matchUpId: matchUpId,
+    });
+    var structureId = inContextMatchUp === null || inContextMatchUp === void 0 ? void 0 : inContextMatchUp.structureId;
+    var structure = findStructure({ drawDefinition: drawDefinition, structureId: structureId }).structure;
+    Object.assign(params, {
+        inContextDrawMatchUps: inContextDrawMatchUps,
+        inContextMatchUp: inContextMatchUp,
+        matchUpsMap: matchUpsMap,
+        targetData: targetData,
+        structure: structure,
+        matchUp: matchUp,
+    });
+    // with propagating winningSide changes, activeDownstream only applies to eventType: TEAM
+    var activeDownstream = isActiveDownstream(params);
+    if (activeDownstream)
+        return { error: CANNOT_CHANGE_WINNING_SIDE };
+    if ((_b = matchUp.tieMatchUps) === null || _b === void 0 ? void 0 : _b.length) {
         try {
-            if (_k && !_k.done && (_b = _j.return)) _b.call(_j);
+            for (var _d = __values(matchUp.tieMatchUps), _e = _d.next(); !_e.done; _e = _d.next()) {
+                var tieMatchUp = _e.value;
+                var result_1 = setMatchUpState({
+                    matchUpId: tieMatchUp.matchUpId,
+                    matchUpTieId: matchUpId,
+                    winningSide: undefined,
+                    removeScore: true,
+                    tournamentRecord: tournamentRecord,
+                    drawDefinition: drawDefinition,
+                    event: event,
+                });
+                if (result_1.error)
+                    return decorateResult({ result: result_1, stack: stack });
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+            }
+            finally { if (e_1) throw e_1.error; }
         }
-        finally { if (e_1) throw e_1.error; }
     }
-    // TODO: update dynamic ratings based on matchUps present from last played round
-    // use scaleEngine.generateDynamicRatings(); see dynamicCalculations.test.ts
-    return generateDrawMaticRound({
-        tournamentParticipants: tournamentParticipants,
-        generateMatchUps: generateMatchUps,
-        participantIds: participantIds,
-        encounterValue: encounterValue,
-        sameTeamValue: sameTeamValue,
+    var result = updateTieMatchUpScore({
+        event: params.event,
+        removeScore: true,
+        tournamentRecord: tournamentRecord,
         drawDefinition: drawDefinition,
-        maxIterations: maxIterations,
-        adHocRatings: adHocRatings,
-        matchUpIds: matchUpIds,
-        structure: structure,
-        eventType: eventType,
-        salted: salted,
+        matchUpsMap: matchUpsMap,
+        matchUpId: matchUpId,
     });
+    if (result.error)
+        return decorateResult({ result: result, stack: stack });
+    if (params.tiebreakReset && !result.tieFormatRemoved) {
+        // check for scenarios where an added "Tiebreaker" collectionDefinition/matchUp has been added
+        var inheritedTieFormat = (_c = resolveTieFormat({
+            drawDefinition: drawDefinition,
+            structure: structure,
+            event: event,
+        })) === null || _c === void 0 ? void 0 : _c.tieFormat;
+        if (matchUp.tieFormat && inheritedTieFormat) {
+            var _f = compareTieFormats({
+                descendant: matchUp.tieFormat,
+                ancestor: inheritedTieFormat,
+            }), matchUpCountDifference = _f.matchUpCountDifference, descendantDifferences = _f.descendantDifferences, ancestorDifferences = _f.ancestorDifferences, valueDifference = _f.valueDifference;
+            if (descendantDifferences.collectionIds.length === 1 &&
+                !ancestorDifferences.collectionIds.length &&
+                !ancestorDifferences.groupsCount &&
+                matchUpCountDifference === 1 &&
+                valueDifference === 1) {
+                var result_2 = resetTieFormat({
+                    tournamentRecord: tournamentRecord,
+                    drawDefinition: drawDefinition,
+                    matchUpId: matchUpId,
+                    event: event,
+                });
+                if (result_2.error)
+                    return result_2;
+            }
+        }
+    }
+    return __assign({}, SUCCESS);
 }
-function getScaleValue(_a) {
-    var _b;
-    var _c = _a.scaleType, scaleType = _c === void 0 ? RATING$2 : _c, scaleAccessor = _a.scaleAccessor, participant = _a.participant, scaleName = _a.scaleName, eventType = _a.eventType;
+
+function removeSeeding(_a) {
+    var _b, _c;
+    var tournamentRecord = _a.tournamentRecord, drawDefinition = _a.drawDefinition, entryStatuses = _a.entryStatuses, scaleName = _a.scaleName, drawId = _a.drawId, event = _a.event, stage = _a.stage;
+    if (!tournamentRecord)
+        return { error: MISSING_TOURNAMENT_RECORD };
+    if (!event)
+        return { error: MISSING_EVENT };
+    scaleName =
+        scaleName ||
+            ((_b = event.category) === null || _b === void 0 ? void 0 : _b.categoryName) ||
+            ((_c = event.category) === null || _c === void 0 ? void 0 : _c.ageCategoryCode);
     var scaleAttributes = {
-        eventType: eventType !== null && eventType !== void 0 ? eventType : SINGLES_EVENT,
-        scaleType: scaleType,
+        eventType: event.eventType,
+        scaleType: SEEDING$1,
         scaleName: scaleName,
     };
-    var result = participant &&
-        participantScaleItem({
-            scaleAttributes: scaleAttributes,
-            participant: participant,
-        });
-    var scaleValue = (_b = result === null || result === void 0 ? void 0 : result.scaleItem) === null || _b === void 0 ? void 0 : _b.scaleValue;
-    return scaleAccessor && isObject(scaleValue)
-        ? scaleValue[scaleAccessor]
-        : scaleValue;
-}
-
-function drawMatic(params) {
-    var _a;
-    var tournamentParticipants = (_a = params.tournamentRecord) === null || _a === void 0 ? void 0 : _a.participants;
-    Object.assign(params, { tournamentParticipants: tournamentParticipants });
-    return drawMatic$1(params);
+    return removeScaleValues({
+        tournamentRecord: tournamentRecord,
+        scaleAttributes: scaleAttributes,
+        drawDefinition: drawDefinition,
+        entryStatuses: entryStatuses,
+        drawId: drawId,
+        event: event,
+        stage: stage,
+    });
 }
 
 function setSubOrder(_a) {
@@ -42596,7 +42601,7 @@ function generateDrawDefinition(params) {
                 var _a, _b, _c;
                 if (params.automated) {
                     var _d = (_a = params.drawMatic) !== null && _a !== void 0 ? _a : {}, restrictEntryStatus = _d.restrictEntryStatus, generateMatchUps = _d.generateMatchUps, structureId_1 = _d.structureId, matchUpIds = _d.matchUpIds, scaleName = _d.scaleName;
-                    var matchUps = drawMatic$1({
+                    var matchUps = drawMatic({
                         eventType: (_c = (_b = params.drawMatic) === null || _b === void 0 ? void 0 : _b.eventType) !== null && _c !== void 0 ? _c : matchUpType,
                         generateMatchUps: generateMatchUps !== null && generateMatchUps !== void 0 ? generateMatchUps : true,
                         restrictEntryStatus: restrictEntryStatus,
@@ -42605,7 +42610,8 @@ function generateDrawDefinition(params) {
                         drawDefinition: drawDefinition,
                         structureId: structureId_1,
                         matchUpIds: matchUpIds,
-                        scaleName: scaleName,
+                        scaleName: scaleName, // custom rating name to seed dynamic ratings
+                        event: event,
                     }).matchUps;
                     addAdHocMatchUps({
                         tournamentRecord: tournamentRecord,
@@ -42619,6 +42625,7 @@ function generateDrawDefinition(params) {
                         newRound: true,
                         drawDefinition: drawDefinition,
                         matchUpsCount: matchUpsCount_1,
+                        event: event,
                     }).matchUps;
                     addAdHocMatchUps({
                         tournamentRecord: tournamentRecord,
@@ -52549,7 +52556,6 @@ var publishingGovernor = {
     getDrawData: getDrawData,
     getEventData: getEventData,
     getPublishState: getPublishState,
-    getTournamentInfo: getTournamentInfo,
     getVenueData: getVenueData,
     publishEvent: publishEvent,
     publishEventSeeding: publishEventSeeding,
@@ -54126,6 +54132,53 @@ function getParticipantMembership(_a) {
     }, {});
 }
 
+/**
+ *
+ * @param {object[]} outcomes - array of outcomes to be applied to matchUps, relevent attributes: { eventId: string; drawId: string; }
+ *
+ */
+function bulkUpdatePublishedEventIds(_a) {
+    var _b;
+    var tournamentRecord = _a.tournamentRecord, outcomes = _a.outcomes;
+    if (!tournamentRecord)
+        return { error: MISSING_TOURNAMENT_RECORD };
+    if (!(outcomes === null || outcomes === void 0 ? void 0 : outcomes.length))
+        return { error: MISSING_VALUE, info: 'Missing outcomes' };
+    var eventIdsMap = outcomes.reduce(function (eventIdsMap, outcome) {
+        var drawId = outcome.drawId, eventId = outcome.eventId;
+        if (eventId && drawId) {
+            if (!eventIdsMap[eventId]) {
+                eventIdsMap[eventId] = [drawId];
+            }
+            else if (!eventIdsMap[eventId].includes(drawId)) {
+                eventIdsMap[eventId].push(drawId);
+            }
+        }
+        return eventIdsMap;
+    }, {});
+    var relevantEventsIds = Object.keys(eventIdsMap);
+    var relevantEvents = (_b = tournamentRecord.events) === null || _b === void 0 ? void 0 : _b.filter(function (event) {
+        return relevantEventsIds.includes(event.eventId);
+    });
+    var publishedEventIds = relevantEvents
+        .filter(function (event) {
+        var pubStatus = getEventPublishStatus({ event: event });
+        var _a = pubStatus !== null && pubStatus !== void 0 ? pubStatus : {}, drawDetails = _a.drawDetails, drawIds = _a.drawIds;
+        var eventId = event.eventId;
+        var publishedDrawIds = eventIdsMap[eventId].filter(function (drawId) {
+            var keyedDrawIds = drawDetails
+                ? Object.keys(pubStatus.drawDetails).filter(function (drawId) {
+                    return getDrawPublishStatus({ drawId: drawId, drawDetails: drawDetails });
+                })
+                : [];
+            return (drawIds === null || drawIds === void 0 ? void 0 : drawIds.includes(drawId)) || keyedDrawIds.includes(drawId);
+        });
+        return publishedDrawIds.length;
+    })
+        .map(function (event) { return event.eventId; });
+    return { publishedEventIds: publishedEventIds, eventIdPublishedDrawIdsMap: eventIdsMap };
+}
+
 function getSourceStructureIdsAndRelevantLinks(_a) {
     var targetRoundNumber = _a.targetRoundNumber, finishingPosition = _a.finishingPosition, drawDefinition = _a.drawDefinition, structureId = _a.structureId, // structure for which source and target links are to be found
     linkType = _a.linkType;
@@ -56463,53 +56516,6 @@ function getMatchUpFormat(params) {
     };
 }
 
-/**
- *
- * @param {object[]} outcomes - array of outcomes to be applied to matchUps, relevent attributes: { eventId: string; drawId: string; }
- *
- */
-function bulkUpdatePublishedEventIds(_a) {
-    var _b;
-    var tournamentRecord = _a.tournamentRecord, outcomes = _a.outcomes;
-    if (!tournamentRecord)
-        return { error: MISSING_TOURNAMENT_RECORD };
-    if (!(outcomes === null || outcomes === void 0 ? void 0 : outcomes.length))
-        return { error: MISSING_VALUE, info: 'Missing outcomes' };
-    var eventIdsMap = outcomes.reduce(function (eventIdsMap, outcome) {
-        var drawId = outcome.drawId, eventId = outcome.eventId;
-        if (eventId && drawId) {
-            if (!eventIdsMap[eventId]) {
-                eventIdsMap[eventId] = [drawId];
-            }
-            else if (!eventIdsMap[eventId].includes(drawId)) {
-                eventIdsMap[eventId].push(drawId);
-            }
-        }
-        return eventIdsMap;
-    }, {});
-    var relevantEventsIds = Object.keys(eventIdsMap);
-    var relevantEvents = (_b = tournamentRecord.events) === null || _b === void 0 ? void 0 : _b.filter(function (event) {
-        return relevantEventsIds.includes(event.eventId);
-    });
-    var publishedEventIds = relevantEvents
-        .filter(function (event) {
-        var pubStatus = getEventPublishStatus({ event: event });
-        var _a = pubStatus !== null && pubStatus !== void 0 ? pubStatus : {}, drawDetails = _a.drawDetails, drawIds = _a.drawIds;
-        var eventId = event.eventId;
-        var publishedDrawIds = eventIdsMap[eventId].filter(function (drawId) {
-            var keyedDrawIds = drawDetails
-                ? Object.keys(pubStatus.drawDetails).filter(function (drawId) {
-                    return getDrawPublishStatus({ drawId: drawId, drawDetails: drawDetails });
-                })
-                : [];
-            return (drawIds === null || drawIds === void 0 ? void 0 : drawIds.includes(drawId)) || keyedDrawIds.includes(drawId);
-        });
-        return publishedDrawIds.length;
-    })
-        .map(function (event) { return event.eventId; });
-    return { publishedEventIds: publishedEventIds, eventIdPublishedDrawIdsMap: eventIdsMap };
-}
-
 function publicFindParticipant(params) {
     var _a, e_1, _b;
     var tournamentRecord = params.tournamentRecord, policyDefinitions = params.policyDefinitions, contextProfile = params.contextProfile, participantId = params.participantId, personId = params.personId;
@@ -57656,6 +57662,7 @@ var queryGovernor = {
     getTeamLineUp: getTeamLineUp,
     getTieFormat: getTieFormat,
     getTournamentIds: getTournamentIds,
+    getTournamentInfo: getTournamentInfo,
     getTournamentPenalties: getTournamentPenalties,
     getTournamentPersons: getTournamentPersons,
     getTournamentStructures: getTournamentStructures,
@@ -66043,7 +66050,7 @@ function asyncExecutionQueue(engine, directives, rollbackOnError) {
         var e_1, _a;
         return __generator(this, function (_b) {
             if (!Array.isArray(directives))
-                return [2 /*return*/, { error: INVALID_VALUES }];
+                return [2 /*return*/, { error: INVALID_VALUES, message: 'directives must be an array' }];
             methods = getMethods();
             start = Date.now();
             snapshot = rollbackOnError && makeDeepCopy(getTournamentRecords(), false, true);
@@ -66052,7 +66059,7 @@ function asyncExecutionQueue(engine, directives, rollbackOnError) {
                 for (directives_1 = __values(directives), directives_1_1 = directives_1.next(); !directives_1_1.done; directives_1_1 = directives_1.next()) {
                     directive = directives_1_1.value;
                     if (typeof directive !== 'object')
-                        return [2 /*return*/, { error: INVALID_VALUES }];
+                        return [2 /*return*/, { error: INVALID_VALUES, message: 'directive must be an object' }];
                     methodName = directive.method, params = directive.params;
                     if (!methods[methodName])
                         return [2 /*return*/, logMethodNotFound({ methodName: methodName, start: start, params: params })];
@@ -66090,15 +66097,18 @@ function asyncEngineInvoke(engine, args) {
             switch (_d.label) {
                 case 0:
                     if (!isObject(args))
-                        return [2 /*return*/, { error: INVALID_VALUES }];
+                        return [2 /*return*/, { error: INVALID_VALUES, message: 'args must be an object' }];
                     methodsCount = Object.values(args).filter(isFunction).length;
                     if (methodsCount > 1)
-                        return [2 /*return*/, { error: INVALID_VALUES }];
+                        return [2 /*return*/, {
+                                message: 'there must be only one arg with typeof function',
+                                error: INVALID_VALUES,
+                            }];
                     methodName = methodsCount
                         ? Object.keys(args).find(function (key) { return isFunction(args[key]); })
                         : isString(args.method) && args.method;
                     if (!methodName)
-                        return [2 /*return*/, { error: INVALID_VALUES }];
+                        return [2 /*return*/, { error: METHOD_NOT_FOUND }];
                     _b = args, _c = methodName, passedMethod = _b[_c], remainingArgs = __rest(_b, [typeof _c === "symbol" ? _c : _c + ""]);
                     params = (args === null || args === void 0 ? void 0 : args.params) || __assign({}, remainingArgs);
                     snapshot = params.rollbackOnError && makeDeepCopy(getTournamentRecords(), false, true);
@@ -66253,15 +66263,18 @@ function asyncEngine(test) {
 
 function askInvoke(engine, args) {
     if (!isObject(args))
-        return { error: INVALID_VALUES };
+        return { error: INVALID_VALUES, message: 'args must be an object' };
     var methodsCount = Object.values(args).filter(isFunction).length;
     if (methodsCount > 1)
-        return { error: INVALID_VALUES };
+        return {
+            message: 'there must be only one arg with typeof function',
+            error: INVALID_VALUES,
+        };
     var methodName = methodsCount
         ? Object.keys(args).find(function (key) { return isFunction(args[key]); })
         : isString(args.method) && args.method;
     if (!methodName)
-        return { error: INVALID_VALUES };
+        return { error: METHOD_NOT_FOUND };
     var _a = args, _b = methodName, passedMethod = _a[_b], remainingArgs = __rest(_a, [typeof _b === "symbol" ? _b : _b + ""]);
     var params = (args === null || args === void 0 ? void 0 : args.params) || __assign({}, remainingArgs);
     var method = passedMethod || engine[methodName] || getMethods$1()[methodName];
@@ -66281,7 +66294,7 @@ var askEngine = (function () {
 function executionQueue(engine, directives, rollbackOnError) {
     var e_1, _a;
     if (!Array.isArray(directives))
-        return { error: INVALID_VALUES };
+        return { error: INVALID_VALUES, message: 'directives must be an array' };
     var methods = getMethods();
     var start = Date.now();
     var snapshot = rollbackOnError && makeDeepCopy(getTournamentRecords(), false, true);
@@ -66290,7 +66303,7 @@ function executionQueue(engine, directives, rollbackOnError) {
         for (var directives_1 = __values(directives), directives_1_1 = directives_1.next(); !directives_1_1.done; directives_1_1 = directives_1.next()) {
             var directive = directives_1_1.value;
             if (typeof directive !== 'object')
-                return { error: INVALID_VALUES };
+                return { error: INVALID_VALUES, message: 'directive must be an object' };
             var methodName = directive.method, params = directive.params;
             if (!methods[methodName])
                 return logMethodNotFound({ methodName: methodName, start: start, params: params });
@@ -66321,15 +66334,18 @@ function executionQueue(engine, directives, rollbackOnError) {
 function engineInvoke(engine, args) {
     var _a;
     if (!isObject(args))
-        return { error: INVALID_VALUES };
+        return { error: INVALID_VALUES, message: 'args must be an object' };
     var methodsCount = Object.values(args).filter(isFunction).length;
     if (methodsCount > 1)
-        return { error: INVALID_VALUES };
+        return {
+            message: 'there must be only one arg with typeof function',
+            error: INVALID_VALUES,
+        };
     var methodName = methodsCount
         ? Object.keys(args).find(function (key) { return isFunction(args[key]); })
         : isString(args.method) && args.method;
     if (!methodName)
-        return { error: INVALID_VALUES };
+        return { error: METHOD_NOT_FOUND };
     var _b = args, _c = methodName, passedMethod = _b[_c], remainingArgs = __rest(_b, [typeof _c === "symbol" ? _c : _c + ""]);
     var params = (args === null || args === void 0 ? void 0 : args.params) || __assign({}, remainingArgs);
     var snapshot = params.rollbackOnError && makeDeepCopy(getTournamentRecords(), false, true);