tods-competition-factory 7.2.0 → 7.4.0

package/README.md

@@ -142,7 +142,7 @@ Full documentation with interactive examples: **[courthive.github.io/competition
 
 ## Testing
 
-**13,000+ tests** covering draw generation and exit propagation, scheduling, scoring, participants and entries, team competition, publishing and embargo, ranking points and ratings, officiating and sanctioning.
+**13,700+ tests** covering draw generation and exit propagation, scheduling, scoring, participants and entries, team competition, publishing and embargo, ranking points and ratings, officiating and sanctioning.
 
 Beyond conventional unit and integration tests, the suite includes relational property suites (do/undo, idempotence, monotonicity), agreement oracles, and an at-scale randomized sweep with delta-debugging for exit propagation — added because full branch coverage of a propagation guard proved compatible with hundreds of wrong answers.
 

package/dist/esm/assemblies/generators/mocks/processLeagueProfiles.mjs

@@ -6,13 +6,14 @@ import { isNumeric } from '../../../tools/math.mjs';
 import { ANY, MALE, OTHER, MIXED, FEMALE } from '../../../constants/genderConstants.mjs';
 import tieFormatDefaults from '../templates/tieFormatDefaults.mjs';
 import { AD_HOC, DOUBLE_ROUND_ROBIN, MAIN } from '../../../constants/drawDefinitionConstants.mjs';
+import '../../../helpers/keyValueScore/constants.mjs';
 import '../../../mutate/matchUps/schedule/byeScheduling.mjs';
 import { TEAM } from '../../../constants/participantConstants.mjs';
 import { DIRECT_ACCEPTANCE } from '../../../constants/entryStatusValues.mjs';
 import { UUID } from '../../../tools/UUID.mjs';
-import '../../../helpers/keyValueScore/constants.mjs';
 import { COMPETITOR } from '../../../constants/participantRoleValues.mjs';
 import '../../../types/tournamentTypes.mjs';
+import '../../../mutate/matchUps/matchUpStatus/sideStatusCodes.mjs';
 import '../../../query/drawDefinition/predictDrawCompetitiveBands.mjs';
 import { generateDrawDefinition } from '../drawDefinitions/generateDrawDefinition/generateDrawDefinition.mjs';
 import { addParticipants } from '../../../mutate/participants/addParticipants.mjs';

package/dist/esm/assemblies/governors/scoreGovernor/index.mjs

@@ -23,9 +23,9 @@ export { deduceMatchUpFormat } from '../../../query/scoring/deduceMatchUpFormat.
 export { generateScoreString } from '../../generators/matchUps/generateScoreString.mjs';
 export { generateTieMatchUpScore } from '../../generators/tieMatchUpScore/generateTieMatchUpScore.mjs';
 export { getEpisodes } from '../../../query/scoring/getEpisodes.mjs';
+export { getMaxSetScore, getSetComplement, getTiebreakComplement } from '../../../query/matchUp/getComplement.mjs';
 export { getScore } from '../../../query/scoring/getScore.mjs';
 export { getScoreboard } from '../../../query/scoring/getScoreboard.mjs';
-export { getSetComplement, getTiebreakComplement } from '../../../query/matchUp/getComplement.mjs';
 export { getWinner } from '../../../query/scoring/getWinner.mjs';
 export { inferServeSide } from '../../../mutate/scoring/serveSideCalculator.mjs';
 export { isComplete } from '../../../query/scoring/isComplete.mjs';
@@ -34,6 +34,7 @@ export { keyValueScore } from '../../../helpers/keyValueScore/keyValueScore.mjs'
 export { parse as parseMatchUpFormat } from '../../../helpers/matchUpFormatCode/parse.mjs';
 export { parseScoreString } from '../../../tools/parseScoreString.mjs';
 export { resolvePointValue } from '../../../mutate/scoring/resolvePointValue.mjs';
+export { retainScoreForFormat } from '../../../query/matchUp/retainScoreForFormat.mjs';
 export { reverseScore } from '../../generators/score/reverseScore.mjs';
 export { stringify as stringifyMatchUpFormat } from '../../../helpers/matchUpFormatCode/stringify.mjs';
 export { toStatObjects } from '../../../query/scoring/statistics/toStatObjects.mjs';

package/dist/esm/assemblies/governors/scoreGovernor/query.mjs

@@ -2,7 +2,8 @@ export { validateMatchUpScore, validateSetScore } from '../../../validators/vali
 export { isValidMatchUpFormat } from '../../../validators/isValidMatchUpFormat.mjs';
 export { validateTieFormat } from '../../../validators/validateTieFormat.mjs';
 export { validateScore } from '../../../validators/validateScore.mjs';
-export { getSetComplement, getTiebreakComplement } from '../../../query/matchUp/getComplement.mjs';
+export { getMaxSetScore, getSetComplement, getTiebreakComplement } from '../../../query/matchUp/getComplement.mjs';
+export { retainScoreForFormat } from '../../../query/matchUp/retainScoreForFormat.mjs';
 export { checkScoreHasValue } from '../../../query/matchUp/checkScoreHasValue.mjs';
 export { checkSetIsComplete } from '../../../query/matchUp/checkSetIsComplete.mjs';
 export { analyzeScore } from '../../../query/matchUp/analyzeScore.mjs';

package/dist/esm/constants/matchUpStatusConstants.mjs

@@ -1,4 +1,4 @@
-import { CANCELLED, ABANDONED, COMPLETED, DEAD_RUBBER, DEFAULTED, DOUBLE_WALKOVER, DOUBLE_DEFAULT, RETIRED, WALKOVER, TO_BE_PLAYED, SUSPENDED, NOT_PLAYED, INCOMPLETE, IN_PROGRESS, CHALLENGED, BYE, AWAITING_RESULT } from './matchUpStatusValues.mjs';
+import { ABANDONED, AWAITING_RESULT, CANCELLED, CHALLENGED, DEAD_RUBBER, IN_PROGRESS, INCOMPLETE, NOT_PLAYED, SUSPENDED, TO_BE_PLAYED, COMPLETED, DEFAULTED, DOUBLE_WALKOVER, DOUBLE_DEFAULT, RETIRED, WALKOVER, BYE } from './matchUpStatusValues.mjs';
 
 const recoveryTimeRequiredMatchUpStatuses = [
     AWAITING_RESULT,

package/dist/esm/fixtures/policies/POLICY_PROGRESSION_DEFAULT.mjs

@@ -2,7 +2,7 @@ import { POLICY_TYPE_PROGRESSION } from '../../constants/policyConstants.mjs';
 
 const POLICY_PROGRESSION_DEFAULT = {
     [POLICY_TYPE_PROGRESSION]: {
-        doubleExitPropagateBye: false,
+        doubleExitPropagateBye: true,
         autoPlaceQualifiers: false,
         autoReplaceQualifiers: false,
         autoRemoveQualifiers: false,

package/dist/esm/mutate/drawDefinitions/matchUpGovernor/noDownstreamDependencies.mjs

@@ -8,6 +8,7 @@ import { checkConnectedStructures } from './checkConnectedStructures.mjs';
 import { attemptToSetWinningSide } from './attemptToSetWinningSide.mjs';
 import { decorateResult } from '../../../functions/global/decorateResult.mjs';
 import { attemptToModifyScore } from './attemptToModifyScore.mjs';
+import { unwindDualDoubleExit } from './unwindDualDoubleExit.mjs';
 import { pushGlobalLog } from '../../../functions/global/globalLog.mjs';
 import { isExit, isDoubleExit } from '../../../validators/isExit.mjs';
 import { removeDoubleExit } from './removeDoubleExit.mjs';
@@ -25,6 +26,9 @@ function noDownstreamDependencies(params) {
         if (result.error)
             return decorateResult({ result, stack });
     }
+    const dualUnwound = unwindDualDoubleExit(params);
+    if (dualUnwound.error)
+        return decorateResult({ result: dualUnwound, stack });
     const doubleExit = isDoubleExit(matchUpStatus);
     const preserveScoreStatuses = [IN_PROGRESS, SUSPENDED, CANCELLED, ABANDONED, INCOMPLETE];
     const scoreWithNoWinningSide = checkScoreHasValue({ score }) &&

package/dist/esm/mutate/drawDefinitions/matchUpGovernor/{matchUpStatusCodes.mjs → recordSourceSideProvenance.mjs}

@@ -1,9 +1,9 @@
-import { producedExitStatus, mergeSideExitProvenance } from '../../matchUps/matchUpStatus/sideExitProvenance.mjs';
+import { mergeSideExitProvenance, producedExitStatus } from '../../matchUps/matchUpStatus/sideExitProvenance.mjs';
 import { getPairedPreviousMatchUp } from '../../../query/matchUps/getPairedPreviousMatchup.mjs';
 import { definedAttributes } from '../../../tools/definedAttributes.mjs';
 import { TO_BE_PLAYED } from '../../../constants/matchUpStatusValues.mjs';
 
-function updateMatchUpStatusCodes({ inContextDrawMatchUps, sourceMatchUpStatus, sourceMatchUpId, matchUpsMap, matchUp, }) {
+function recordSourceSideProvenance({ inContextDrawMatchUps, sourceMatchUpStatus, sourceMatchUpId, matchUpsMap, matchUp, }) {
     const sourceMatchUp = inContextDrawMatchUps.find((matchUp) => matchUp.matchUpId === sourceMatchUpId);
     const { pairedPreviousMatchUp } = getPairedPreviousMatchUp({
         structureId: sourceMatchUp?.structureId,
@@ -18,17 +18,6 @@ function updateMatchUpStatusCodes({ inContextDrawMatchUps, sourceMatchUpStatus,
                 (sourceMatchUp?.roundPosition < pairedMatchUp?.roundPosition && 1) || 2
             :
                 (sourceMatchUp.structureId === pairedMatchUp?.structureId && 2) || 1;
-        matchUp.matchUpStatusCodes = (matchUp.matchUpStatusCodes ?? []).map((code) => {
-            const value = typeof code === 'object' && code !== null ? code : { code: code ?? undefined };
-            if (value.sideNumber === sourceSideNumber) {
-                return {
-                    ...value,
-                    matchUpStatus: producedExitStatus(sourceMatchUpStatus),
-                    previousMatchUpStatus: sourceMatchUpStatus,
-                };
-            }
-            return value;
-        });
         if (sourceMatchUpStatus && sourceMatchUpStatus !== TO_BE_PLAYED) {
             mergeSideExitProvenance({
                 matchUp,
@@ -44,4 +33,4 @@ function updateMatchUpStatusCodes({ inContextDrawMatchUps, sourceMatchUpStatus,
     }
 }
 
-export { updateMatchUpStatusCodes };
+export { recordSourceSideProvenance };

package/dist/esm/mutate/drawDefinitions/matchUpGovernor/removeDoubleExit.mjs

@@ -1,17 +1,17 @@
-import { withdrawByeClaim, withdrawByeClaimsFrom, byeClaimSurvives, getNativeSideExitProvenance, projectExitStatusCodes, setSideExitProvenance, retainForeignProvenance, deriveExitStateFromProvenance } from '../../matchUps/matchUpStatus/sideExitProvenance.mjs';
 import { removeDirectedBye, removeDirectedWinner } from '../../matchUps/drawPositions/removeDirectedParticipants.mjs';
+import { propagatesByeOnDoubleExit } from '../../matchUps/drawPositions/propagatesByeOnDoubleExit.mjs';
 import { getPairedPreviousMatchUp } from '../../../query/matchUps/getPairedPreviousMatchup.mjs';
 import { modifyMatchUpScore } from '../../matchUps/score/modifyMatchUpScore.mjs';
 import { decorateResult } from '../../../functions/global/decorateResult.mjs';
-import { chunkArray, intersection, overlap } from '../../../tools/arrays.mjs';
 import { positionTargets } from '../../../query/matchUp/positionTargets.mjs';
 import { pushGlobalLog } from '../../../functions/global/globalLog.mjs';
 import { findStructure } from '../../../acquire/findStructure.mjs';
+import { intersection, overlap } from '../../../tools/arrays.mjs';
 import { isDoubleExit } from '../../../validators/isExit.mjs';
-import { FIRST_MATCHUP } from '../../../constants/drawDefinitionConstants.mjs';
+import { withdrawByeClaim, withdrawByeClaimsFrom, byeClaimSurvives, getSideExitProvenance, retainPolicyCodes, setSideExitProvenance, retainForeignProvenance, deriveExitStateFromProvenance } from '../../matchUps/matchUpStatus/sideExitProvenance.mjs';
 import { SUCCESS } from '../../../constants/resultConstants.mjs';
 import { completedMatchUpStatuses } from '../../../constants/matchUpStatusConstants.mjs';
-import { BYE, DOUBLE_DEFAULT, DOUBLE_WALKOVER, DEFAULTED, WALKOVER, TO_BE_PLAYED } from '../../../constants/matchUpStatusValues.mjs';
+import { BYE, DOUBLE_WALKOVER, DOUBLE_DEFAULT, DEFAULTED, WALKOVER, TO_BE_PLAYED } from '../../../constants/matchUpStatusValues.mjs';
 
 const keyColors = {
     drawPositionToRemove: 'green',
@@ -60,19 +60,6 @@ function removeDoubleExit(params) {
     const claimSideNumber = (rawLoserMatchUp?.drawPositions ?? []).indexOf(loserTargetDrawPosition) + 1 || 1;
     withdrawByeClaim({ matchUp: rawLoserMatchUp, sideNumber: claimSideNumber, claimantMatchUpId: matchUpId });
     withdrawByeClaimsFrom({ matchUps: matchUpsMap?.drawMatchUps, claimantMatchUpId: matchUpId });
-    const isFMLC = targetData?.targetLinks?.loserTargetLink?.linkCondition === FIRST_MATCHUP;
-    if (byePropagatedToLoserMatchUp && isFMLC) {
-        const roundMatchUps = inContextDrawMatchUps.filter(({ roundNumber, structureId }) => structureId === matchUp.structureId && roundNumber === 1);
-        const roundPositions = roundMatchUps.map(({ roundPosition }) => roundPosition);
-        const pairedPositions = chunkArray(roundPositions.toSorted((a, b) => a - b), 2).find((chunk) => chunk.includes(matchUp.roundPosition));
-        const pairedMatchUpStatuses = roundMatchUps
-            .filter(({ roundPosition }) => pairedPositions.includes(roundPosition))
-            ?.map(({ matchUpStatus }) => matchUpStatus);
-        const pairedMatchUpIsDoubleExit = pairedMatchUpStatuses.every((matchUpStatus) => [DOUBLE_DEFAULT, DOUBLE_WALKOVER].includes(matchUpStatus));
-        if (pairedMatchUpIsDoubleExit) {
-            return decorateResult({ result: { ...SUCCESS }, stack });
-        }
-    }
     if (loserMatchUp && (loserMatchUp.matchUpStatus !== BYE || byePropagatedToLoserMatchUp)) {
         const inContextLoserMatchUp = inContextDrawMatchUps.find(({ matchUpId }) => matchUpId === loserMatchUp.matchUpId);
         const { structure: loserStructure } = findStructure({
@@ -98,7 +85,7 @@ function removeDoubleExit(params) {
         if (anotherClaimSurvives) {
             return decorateResult({ result: { ...SUCCESS }, stack });
         }
-        if (appliedPolicies?.progression?.doubleExitPropagateBye || byePropagatedToLoserMatchUp) {
+        if (propagatesByeOnDoubleExit(appliedPolicies) || byePropagatedToLoserMatchUp) {
             removeDirectedBye({
                 drawPosition: loserTargetDrawPosition,
                 targetLink: loserTargetLink,
@@ -133,7 +120,7 @@ function removeDoubleExit(params) {
     return decorateResult({ result: { ...SUCCESS }, stack });
 }
 function carriesWithdrawnOrigin(matchUp, withdrawnSourceIds) {
-    const provenance = getNativeSideExitProvenance({ matchUp });
+    const provenance = getSideExitProvenance({ matchUp });
     if (!provenance)
         return false;
     return [1, 2].some((sideNumber) => {
@@ -170,7 +157,7 @@ function withdrawExitFromByeChain({ inContextDrawMatchUps, withdrawnSourceIds, d
         keyColors,
     });
     const result = modifyMatchUpScore({
-        matchUpStatusCodes: unwound.provenance ? projectExitStatusCodes(unwound.provenance) : [],
+        matchUpStatusCodes: retainPolicyCodes(noContextTargetMatchUp),
         removeWinningSide: unwound.winningSide === undefined,
         matchUpStatus: unwound.matchUpStatus,
         matchUpId: fromMatchUp.matchUpId,
@@ -308,7 +295,7 @@ function conditionallyRemoveDrawPosition(params) {
     if (result.error)
         return decorateResult({ result, stack });
     const carriesSomethingOfThisCascade = carriesWithdrawnOrigin(noContextTargetMatchUp, withdrawnSourceIds);
-    const holdsProvenance = !!getNativeSideExitProvenance({ matchUp: noContextTargetMatchUp });
+    const holdsProvenance = !!getSideExitProvenance({ matchUp: noContextTargetMatchUp });
     if (holdsProvenance && !carriesSomethingOfThisCascade) {
         pushGlobalLog({
             method: stack,
@@ -329,7 +316,7 @@ function conditionallyRemoveDrawPosition(params) {
     const removeScore = !pairedPreviousDoubleExit;
     result = modifyMatchUpScore({
         ...params,
-        matchUpStatusCodes: unwound.provenance ? projectExitStatusCodes(unwound.provenance) : [],
+        matchUpStatusCodes: retainPolicyCodes(noContextTargetMatchUp),
         removeWinningSide: unwound.winningSide === undefined,
         matchUpId: targetMatchUp.matchUpId,
         matchUp: noContextTargetMatchUp,
@@ -384,10 +371,10 @@ function getUnwoundState({ pairedPreviousDoubleExit, noContextTargetMatchUp, wit
     if (noContextTargetMatchUp.matchUpStatus === BYE) {
         return {
             matchUpStatus: BYE,
-            provenance: retainForeignProvenance(getNativeSideExitProvenance({ matchUp: noContextTargetMatchUp }), withdrawnSourceIds),
+            provenance: retainForeignProvenance(getSideExitProvenance({ matchUp: noContextTargetMatchUp }), withdrawnSourceIds),
         };
     }
-    const retained = retainForeignProvenance(getNativeSideExitProvenance({ matchUp: noContextTargetMatchUp }), withdrawnSourceIds);
+    const retained = retainForeignProvenance(getSideExitProvenance({ matchUp: noContextTargetMatchUp }), withdrawnSourceIds);
     if (pairedPreviousDoubleExit) {
         return {
             matchUpStatus: [DOUBLE_DEFAULT, DEFAULTED].includes(noContextTargetMatchUp?.matchUpStatus) ? DEFAULTED : WALKOVER,
@@ -397,7 +384,7 @@ function getUnwoundState({ pairedPreviousDoubleExit, noContextTargetMatchUp, wit
     if (targetDrawPositionIsBye({ drawDefinition, noContextTargetMatchUp, targetMatchUp })) {
         return {
             matchUpStatus: BYE,
-            provenance: retainForeignProvenance(getNativeSideExitProvenance({ matchUp: noContextTargetMatchUp }), withdrawnSourceIds),
+            provenance: retainForeignProvenance(getSideExitProvenance({ matchUp: noContextTargetMatchUp }), withdrawnSourceIds),
         };
     }
     if (isDoubleExit(noContextTargetMatchUp?.matchUpStatus)) {

package/dist/esm/mutate/drawDefinitions/matchUpGovernor/unwindDualDoubleExit.mjs

@@ -0,0 +1,13 @@
+import { removeDoubleExit } from './removeDoubleExit.mjs';
+import { isDoubleExit } from '../../../validators/isExit.mjs';
+import { SUCCESS } from '../../../constants/resultConstants.mjs';
+
+function unwindDualDoubleExit(params) {
+    const { isCollectionMatchUp, dualMatchUp, matchUpsMap } = params;
+    if (!isCollectionMatchUp || !isDoubleExit(dualMatchUp?.matchUpStatus))
+        return { ...SUCCESS };
+    const rawDual = matchUpsMap?.drawMatchUps?.find((candidate) => candidate.matchUpId === dualMatchUp.matchUpId) ?? dualMatchUp;
+    return removeDoubleExit({ ...params, matchUp: rawDual });
+}
+
+export { unwindDualDoubleExit };