tods-competition-factory 1.8.1 → 1.8.3

package/dist/index.mjs

@@ -333,7 +333,7 @@ const matchUpFormatCode = {
 };
 
 function factoryVersion() {
-  return "1.8.1";
+  return "1.8.3";
 }
 
 function getObjectTieFormat(obj) {
@@ -6441,20 +6441,20 @@ const ROUND_ROBIN_WITH_PLAYOFF = "ROUND_ROBIN_WITH_PLAYOFF";
 const DECIDER = "DECIDER";
 const BACKDRAW = "BACKDRAW";
 const COMPASS_ATTRIBUTES = {
-  0: { name: "EAST", abbreviation: "E" },
-  "0-1": { name: "WEST", abbreviation: "W" },
-  "0-2": { name: "NORTH", abbreviation: "N" },
-  "0-3": { name: "NORTHEAST", abbreviation: "NE" },
-  "0-1-1": { name: "SOUTH", abbreviation: "S" },
-  "0-1-2": { name: "SOUTHWEST", abbreviation: "SW" },
-  "0-2-1": { name: "NORTHWEST", abbreviation: "NW" },
-  "0-1-1-1": { name: "SOUTHEAST", abbreviation: "SE" }
+  0: { name: "East", abbreviation: "E" },
+  "0-1": { name: "West", abbreviation: "W" },
+  "0-2": { name: "North", abbreviation: "N" },
+  "0-3": { name: "Northeast", abbreviation: "NE" },
+  "0-1-1": { name: "South", abbreviation: "S" },
+  "0-1-2": { name: "Southwest", abbreviation: "SW" },
+  "0-2-1": { name: "Northwest", abbreviation: "NW" },
+  "0-1-1-1": { name: "Southeast", abbreviation: "SE" }
 };
 const OLYMPIC_ATTRIBUTES = {
-  0: { name: "EAST", abbreviation: "E" },
-  "0-1": { name: "WEST", abbreviation: "W" },
-  "0-2": { name: "NORTH", abbreviation: "N" },
-  "0-1-1": { name: "SOUTH", abbreviation: "S" }
+  0: { name: "East", abbreviation: "E" },
+  "0-1": { name: "West", abbreviation: "W" },
+  "0-2": { name: "North", abbreviation: "N" },
+  "0-1-1": { name: "South", abbreviation: "S" }
 };
 const WIN_RATIO = "WIN_RATIO";
 const ROUND_OUTCOME = "ROUND_OUTCOME";
@@ -15183,6 +15183,144 @@ const fixtures = {
   flagIOC
 };
 
+const logColors = {
+  reset: "\x1B[0m",
+  bright: "\x1B[1m",
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  brightred: "\x1B[91m",
+  green: "\x1B[32m",
+  brightgreen: "\x1B[92m",
+  yellow: "\x1B[33m",
+  brightyellow: "\x1B[93m",
+  blue: "\x1B[34m",
+  brightblue: "\x1B[94m",
+  lightblue: "\x1B[105m",
+  magenta: "\x1B[35m",
+  brightmagenta: "\x1B[95m",
+  cyan: "\x1B[36m",
+  brightcyan: "\x1B[96m",
+  white: "\x1B[37m",
+  brightwhite: "\x1B[97m"
+};
+
+const globalLog = [];
+function pushGlobalLog(value, devContextOverride) {
+  if (typeof value === "string")
+    value = { method: value };
+  if (devContextOverride || getDevContext())
+    globalLog.push(value);
+}
+function getGlobalLog(purge) {
+  const globalLogCopy = globalLog.slice();
+  if (purge) {
+    globalLog.length = 0;
+  }
+  return globalLogCopy;
+}
+function printGlobalLog(purge) {
+  const globalLogCopy = getGlobalLog(purge);
+  const modifiedText = globalLogCopy.map((line) => {
+    const { color, keyColors, method, newline } = line;
+    const methodColor = Object.keys(logColors).includes(color) ? logColors[color] : logColors.cyan;
+    const bodyKeys = Object.keys(line).filter(
+      (key) => !["color", "keyColors", "method", "newline"].includes(key)
+    );
+    const body = bodyKeys.map((key) => {
+      const keyColor = keyColors && Object.keys(keyColors).includes(key) && logColors[keyColors[key]] ? logColors[keyColors[key]] : logColors.brightwhite;
+      return `${logColors.white}${key}: ${keyColor}${line[key]}`;
+    }).join(", ");
+    const tabs = method?.length < 15 ? `		` : "	";
+    return [
+      newline ? "\n" : "",
+      methodColor,
+      method,
+      tabs,
+      logColors.white,
+      body,
+      logColors.reset,
+      "\n"
+    ].join("");
+  });
+  if (modifiedText?.length)
+    console.log(...modifiedText);
+}
+function purgeGlobalLog() {
+  globalLog.length = 0;
+}
+
+function visualizeScheduledMatchUps({
+  scheduledMatchUps,
+  showGlobalLog
+}) {
+  purgeGlobalLog();
+  const structureIds = scheduledMatchUps?.reduce(
+    (structureIds2, { structureId }) => structureIds2.includes(structureId) ? structureIds2 : structureIds2.concat(structureId),
+    []
+  );
+  const structureNames = Object.assign(
+    {},
+    ...(structureIds || []).map((structureId) => {
+      const { structureName, matchUpType } = scheduledMatchUps.find(
+        (matchUp) => matchUp.structureId === structureId
+      );
+      return {
+        [structureId]: `${structureName} ${matchUpType}`
+      };
+    })
+  );
+  structureIds?.forEach((structureId) => {
+    pushGlobalLog(
+      {
+        color: "blue",
+        method: "draw",
+        structure: structureNames[structureId],
+        keyColors: {
+          structure: "magenta"
+        }
+      },
+      true
+    );
+    const structureMatchUps = scheduledMatchUps.filter(
+      (matchUp) => matchUp.structureId === structureId
+    );
+    const roundMatchUps = getRoundMatchUps$1({
+      matchUps: structureMatchUps
+    })?.roundMatchUps || [];
+    Object.keys(roundMatchUps).forEach((roundNumber) => {
+      pushGlobalLog(
+        {
+          roundNumber,
+          keyColors: {
+            roundNumber: "brightcyan"
+          }
+        },
+        true
+      );
+      roundMatchUps[roundNumber].forEach(({ matchUpId, schedule }) => {
+        const scheduledTime = extractTime(schedule.scheduledTime);
+        pushGlobalLog(
+          {
+            matchUpId,
+            time: scheduledTime,
+            date: schedule.scheduledDate,
+            venue: schedule.venueId,
+            keyColors: {
+              time: "brightcyan",
+              date: "brightcyan",
+              matchUpId: "yellow",
+              venue: "magenta"
+            }
+          },
+          true
+        );
+      });
+    });
+  });
+  if (showGlobalLog)
+    printGlobalLog();
+}
+
 function calculateWinCriteria({
   collectionDefinitions = [],
   collectionGroups = []
@@ -20660,11 +20798,6 @@ function getStructureDrawPositionProfiles(params) {
   };
 }
 
-function pushGlobalLog(value, devContextOverride) {
-  if (devContextOverride || getDevContext())
-    ;
-}
-
 function clearDrawPosition(params) {
   let { inContextDrawMatchUps, participantId, drawPosition } = params;
   const { tournamentRecord, drawDefinition, structureId, matchUpsMap, event } = params;
@@ -20968,7 +21101,11 @@ function removeDrawPosition({
   const noChange = initialDrawPositions?.includes(drawPosition) && initialMatchUpStatus === targetMatchUp.matchUpStatus && initialWinningSide === targetMatchUp.winningSide;
   if (!noChange) {
     if (removedDrawPosition) {
-      pushGlobalLog();
+      pushGlobalLog({
+        method: stack,
+        color: "brightyellow",
+        removedDrawPosition
+      });
     }
     modifyMatchUpNotice({
       tournamentId: tournamentRecord?.tournamentId,
@@ -21012,7 +21149,11 @@ function removeDrawPosition({
         matchUps: loserStructureMatchUps
       });
       if (initialRoundNumber2 === 1) {
-        pushGlobalLog();
+        pushGlobalLog({
+          method: stack,
+          color: "brightyellow",
+          loserMatchUpDrawPosition
+        });
         drawPositionRemovals({
           structureId: loserMatchUp.structureId,
           drawPosition: loserMatchUpDrawPosition,
@@ -21461,7 +21602,7 @@ function assignDrawPositionBye$1({
   if (!structureId)
     ({ structureId } = structure);
   const stack = "assignDrawPositionBye";
-  pushGlobalLog();
+  pushGlobalLog({ method: stack, color: "cyan", drawPosition });
   if (!matchUpsMap) {
     matchUpsMap = getMatchUpsMap({ drawDefinition });
   }
@@ -21645,7 +21786,8 @@ function advanceDrawPosition({
   matchUpId,
   event
 }) {
-  pushGlobalLog();
+  const stack = "advanceDrawPosition";
+  pushGlobalLog({ method: stack, color: "cyan", drawPositionToAdvance });
   const matchUp = matchUpsMap.drawMatchUps.find(
     (matchUp2) => matchUp2.matchUpId === matchUpId
   );
@@ -21788,10 +21930,16 @@ function advanceWinner({
     winningSide: void 0,
     drawPositions
   });
-  noContextWinnerMatchUp.drawPositions.find(
+  const changedDrawPosition = noContextWinnerMatchUp.drawPositions.find(
     (position) => !twoDrawPositions.includes(position)
   );
-  pushGlobalLog();
+  pushGlobalLog({
+    method: stack,
+    color: "brightyellow",
+    changedDrawPosition,
+    pairedDrawPositionIsBye,
+    drawPositionIsBye
+  });
   modifyMatchUpNotice({
     tournamentId: tournamentRecord?.tournamentId,
     matchUp: noContextWinnerMatchUp,
@@ -21855,7 +22003,8 @@ function assignFedDrawPositionBye({
   event
 }) {
   const { roundNumber } = loserMatchUp;
-  pushGlobalLog();
+  const stack = "assignFedDrawPositionBye";
+  pushGlobalLog({ method: stack, color: "cyan", loserTargetDrawPosition });
   const mappedMatchUps = matchUpsMap?.mappedMatchUps || {};
   const loserStructureMatchUps = mappedMatchUps[loserMatchUp.structureId].matchUps;
   const { initialRoundNumber } = getInitialRoundNumber({
@@ -22961,6 +23110,7 @@ const structureTemplate = ({
 
 function generateRoundRobin({
   structureName = constantToString(MAIN),
+  groupNameBase = "Group",
   stageSequence = 1,
   structureOptions,
   appliedPolicies,
@@ -22994,7 +23144,7 @@ function generateRoundRobin({
       ...matchUps.map(({ roundNumber }) => roundNumber)
     );
     return structureTemplate({
-      structureName: `Group ${structureOrder}`,
+      structureName: `${groupNameBase} ${structureOrder}`,
       structureId: uuids?.pop(),
       structureType: ITEM,
       finishingPosition,
@@ -24844,6 +24994,12 @@ function attemptToSetWinningSide(params) {
   });
 }
 
+const keyColors = {
+  drawPositionToRemove: "green",
+  iteration: "brightred",
+  winner: "green",
+  loser: "brightred"
+};
 function removeDoubleExit(params) {
   const {
     inContextDrawMatchUps,
@@ -24856,13 +25012,25 @@ function removeDoubleExit(params) {
   let { iteration = 0 } = params;
   iteration += 1;
   const stack = "removeDoubleExit";
-  pushGlobalLog();
+  pushGlobalLog({
+    method: stack,
+    color: "brightyellow",
+    iteration,
+    keyColors
+  });
   const {
     targetLinks: { loserTargetLink },
     targetMatchUps: { loserMatchUp, winnerMatchUp, loserTargetDrawPosition }
   } = targetData;
   if (winnerMatchUp && winnerMatchUp.matchUpStatus !== BYE) {
-    pushGlobalLog();
+    const { stage, roundNumber, roundPosition } = winnerMatchUp;
+    pushGlobalLog({
+      winner: "winner",
+      stage,
+      roundNumber,
+      roundPosition,
+      keyColors
+    });
     conditionallyRemoveDrawPosition({
       ...params,
       targetMatchUp: winnerMatchUp,
@@ -24878,7 +25046,15 @@ function removeDoubleExit(params) {
       drawDefinition,
       structureId: inContextLoserMatchUp.structureId
     });
-    pushGlobalLog();
+    const { stage, roundNumber, roundPosition, feedRound } = loserMatchUp;
+    pushGlobalLog({
+      loser: "loser",
+      stage,
+      roundNumber,
+      roundPosition,
+      keyColors,
+      feedRound
+    });
     if (appliedPolicies?.progression?.doubleExitPropagateBye) {
       removeDirectedBye({
         drawPosition: loserTargetDrawPosition,
@@ -24912,7 +25088,7 @@ function conditionallyRemoveDrawPosition(params) {
     iteration
   } = params;
   const stack = "conditionallyRemoveDrawPosition";
-  pushGlobalLog();
+  pushGlobalLog({ method: stack });
   const nextTargetData = positionTargets({
     matchUpId: targetMatchUp.matchUpId,
     inContextDrawMatchUps,
@@ -24968,7 +25144,16 @@ function conditionallyRemoveDrawPosition(params) {
     }
   }
   if (nextWinnerMatchUp && drawPositionToRemove) {
-    pushGlobalLog();
+    const { stage, roundNumber, roundPosition } = nextWinnerMatchUp;
+    pushGlobalLog({
+      method: "removeDirectedWinner",
+      drawPositionToRemove,
+      keyColors,
+      color: "brightgreen",
+      stage,
+      roundNumber,
+      roundPosition
+    });
     removeDirectedWinner({
       winningDrawPosition: drawPositionToRemove,
       winnerMatchUp: nextWinnerMatchUp,
@@ -25493,7 +25678,12 @@ function setMatchUpStatus$2(params) {
     return swapWinnerLoser(params);
   }
   const matchUpWinner = winningSide && !matchUpTieId || params.projectedWinningSide;
-  pushGlobalLog();
+  pushGlobalLog({
+    method: stack,
+    activeDownstream,
+    matchUpWinner,
+    winningSide
+  });
   const result = !activeDownstream && noDownstreamDependencies(params) || matchUpWinner && winningSideWithDownstreamDependencies(params) || directingMatchUpStatus && applyMatchUpValues(params) || {
     error: NO_VALID_ACTIONS
   };
@@ -32970,14 +33160,16 @@ function getMatchUpsToSchedule({
   scheduleCompletedMatchUps,
   dateScheduledMatchUpIds,
   matchUpNotBeforeTimes,
+  matchUpScheduleTimes,
   orderedMatchUpIds,
   clearDate,
   matchUps
 }) {
+  const alreadyScheduledMatchUpIds = Object.keys(matchUpScheduleTimes);
   const matchUpsToSchedule = orderedMatchUpIds.map(
     (matchUpId) => matchUps.find((matchUp) => matchUp.matchUpId === matchUpId)
   ).filter(Boolean).filter((matchUp) => {
-    const alreadyScheduled = !clearDate && dateScheduledMatchUpIds.includes(matchUp.matchUpId);
+    const alreadyScheduled = !clearDate && (dateScheduledMatchUpIds.includes(matchUp.matchUpId) || alreadyScheduledMatchUpIds.includes(matchUp.matchUpId));
     const doNotSchedule = [
       BYE,
       DEFAULTED,
@@ -33229,6 +33421,7 @@ function getVenueSchedulingDetails({
       scheduleCompletedMatchUps,
       dateScheduledMatchUpIds,
       matchUpNotBeforeTimes,
+      matchUpScheduleTimes,
       orderedMatchUpIds,
       clearDate,
       matchUps
@@ -39038,7 +39231,7 @@ function competitionEngineAsync(test) {
 }
 
 function addVoluntaryConsolationStructure$1({
-  structureName = VOLUNTARY_CONSOLATION,
+  structureName = constantToString(VOLUNTARY_CONSOLATION),
   structureAbbreviation,
   drawDefinition,
   matchUpType,
@@ -39266,7 +39459,9 @@ function generateQualifyingStructures({
       }
       const roundTargetName = qualifyingProfiles.length > 1 ? `${roundTarget}-` : "";
       const stageSequenceName = structureProfiles.length > 1 || roundTargetName ? stageSequence : "";
-      const qualifyingStructureName = structureName || (roundTargetName || stageSequenceName ? `${QUALIFYING} ${roundTargetName}${stageSequenceName}` : QUALIFYING);
+      const qualifyingStructureName = structureName || (roundTargetName || stageSequenceName ? `${constantToString(
+        QUALIFYING
+      )} ${roundTargetName}${stageSequenceName}` : constantToString(QUALIFYING));
       if (drawType === ROUND_ROBIN) {
         const {
           structures: structures2,
@@ -39912,6 +40107,7 @@ function roundMatchCounts({ drawSize }) {
 function firstRoundLoserConsolation(params) {
   const {
     finishingPositionOffset = 0,
+    playoffAttributes,
     stageSequence = 1,
     staggeredEntry,
     structureName,
@@ -39933,7 +40129,7 @@ function firstRoundLoserConsolation(params) {
   };
   const { matchUps } = staggeredEntry ? feedInMatchUps(mainParams) : treeMatchUps(mainParams);
   const mainStructure = structureTemplate({
-    structureName: structureName || constantToString(MAIN),
+    structureName: structureName || playoffAttributes?.["0"]?.name || constantToString(MAIN),
     structureId: structureId || uuids?.pop(),
     stageSequence,
     matchUpType,
@@ -39952,7 +40148,7 @@ function firstRoundLoserConsolation(params) {
       isMock
     });
     const consolation = constantToString(CONSOLATION);
-    const consolationStructureName = params.consolationStructureName || (structureName ? `${structureName} ${consolation}` : consolation);
+    const consolationStructureName = playoffAttributes?.["0-1"]?.name ?? params.consolationStructureName ?? (structureName ? `${structureName} ${consolation}` : consolation);
     const consolationStructure = structureTemplate({
       structureName: consolationStructureName,
       matchUps: consolationMatchUps,
@@ -40030,10 +40226,10 @@ function feedInLinks({
 
 function generateCurtisConsolation(params) {
   const {
-    structureName = constantToString(MAIN),
     playoffStructureNameBase,
     finishingPositionOffset,
     stageSequence = 1,
+    playoffAttributes,
     structureNameMap,
     staggeredEntry,
     stage = MAIN,
@@ -40053,6 +40249,7 @@ function generateCurtisConsolation(params) {
     uuids
   };
   const { matchUps, roundsCount: mainDrawRoundsCount } = staggeredEntry ? feedInMatchUps(mainParams) : treeMatchUps(mainParams);
+  const structureName = params.structureName ?? playoffAttributes?.["0"]?.name ?? constantToString(MAIN);
   const mainStructure = structureTemplate({
     structureId: structureId || uuids?.pop(),
     structureName,
@@ -40071,6 +40268,7 @@ function generateCurtisConsolation(params) {
         idPrefix: idPrefix && `${idPrefix}-c${index}`,
         structureId: uuids?.pop(),
         playoffStructureNameBase,
+        playoffAttributes,
         structureNameMap,
         stageSequence: stageSequence2,
         roundOffset,
@@ -40099,7 +40297,7 @@ function generateCurtisConsolation(params) {
         matchUpType,
         isMock
       });
-      const defaultName = constantToString(PLAY_OFF);
+      const defaultName = playoffAttributes?.["3-4"]?.name ?? constantToString(PLAY_OFF);
       const mappedStructureName = structureNameMap?.[defaultName] || defaultName;
       const structureName2 = playoffStructureNameBase ? `${playoffStructureNameBase} ${mappedStructureName}` : mappedStructureName;
       const playoffStructure = structureTemplate({
@@ -40131,6 +40329,7 @@ function generateCurtisConsolation(params) {
 function consolationFeedStructure({
   playoffStructureNameBase,
   stageSequence = 1,
+  playoffAttributes,
   structureNameMap,
   roundOffset = 0,
   matchUpType,
@@ -40152,7 +40351,8 @@ function consolationFeedStructure({
     isMock,
     uuids
   });
-  const defaultName = `${constantToString(CONSOLATION)} ${index + 1}`;
+  const indexedStructureName = index === 0 && playoffAttributes?.["0-1"]?.name || index === 1 && playoffAttributes?.["0-3"]?.name;
+  const defaultName = indexedStructureName || `${constantToString(CONSOLATION)} ${index + 1}`;
   const mappedStructureName = structureNameMap?.[defaultName] || defaultName;
   const structureName = playoffStructureNameBase ? `${playoffStructureNameBase} ${mappedStructureName}` : mappedStructureName;
   const consolationStructure = structureTemplate({
@@ -40202,7 +40402,7 @@ function generatePlayoffStructures(params) {
   const finishingPositionRange = `${finishingPositionsFrom}-${finishingPositionsTo}`;
   const attributeProfile = playoffAttributes?.[exitProfile];
   const base = playoffStructureNameBase && `${playoffStructureNameBase} ` || "";
-  const customNaming = finishingPositionNaming?.[finishingPositionRange];
+  const customNaming = playoffAttributes?.[finishingPositionRange] ?? finishingPositionNaming?.[finishingPositionRange];
   const structureName = customNaming?.name || attributeProfile?.name && (addNameBaseToAttributeName ? `${base}${attributeProfile?.name}` : attributeProfile.name) || `${base}${finishingPositionRange}`;
   const structureAbbreviation = customNaming?.abbreviation || attributeProfile?.abbreviation;
   const mainParams = {
@@ -40307,6 +40507,7 @@ function feedInChampionship(params) {
   const {
     finishingPositionOffset,
     stageSequence = 1,
+    playoffAttributes,
     policyDefinitions,
     feedsFromFinal,
     staggeredEntry,
@@ -40334,7 +40535,7 @@ function feedInChampionship(params) {
   };
   const { matchUps } = staggeredEntry ? feedInMatchUps(mainParams) : treeMatchUps(mainParams);
   const mainStructure = structureTemplate({
-    structureName: structureName || constantToString(MAIN),
+    structureName: structureName || playoffAttributes?.["0"]?.name || constantToString(MAIN),
     structureId: structureId || uuids?.pop(),
     stageSequence,
     matchUpType,
@@ -40359,7 +40560,7 @@ function feedInChampionship(params) {
   });
   if (drawSize > 2) {
     const consolationStructure = structureTemplate({
-      structureName: constantToString(CONSOLATION),
+      structureName: playoffAttributes?.["0-1"]?.name ?? constantToString(CONSOLATION),
       matchUps: consolationMatchUps,
       structureId: uuids?.pop(),
       stage: CONSOLATION,
@@ -40384,10 +40585,9 @@ function feedInChampionship(params) {
 }
 
 function processPlayoffGroups({
-  compassAttributes = COMPASS_ATTRIBUTES,
-  olympicAttributes = OLYMPIC_ATTRIBUTES,
   requireSequential = true,
   playoffMatchUpFormat,
+  playoffAttributes,
   sourceStructureId,
   policyDefinitions,
   stageSequence,
@@ -40436,6 +40636,8 @@ function processPlayoffGroups({
     if (positionsPlayedOff) {
       finishingPositionOffset = Math.min(...positionsPlayedOff) - 1;
     }
+    const finishingPositionRange = positionsPlayedOff && `${Math.min(...positionsPlayedOff)}-${Math.max(...positionsPlayedOff)}`;
+    const structureName = playoffGroup.structureName || finishingPositionRange && playoffGroup.playoffAttributes?.[finishingPositionRange]?.name || playoffGroup.playoffAttributes?.["0"]?.name;
     const playoffGroupParams = {
       addNameBaseToAttributeName: playoffGroup.addNameBaseToAttributeName,
       playoffStructureNameBase: playoffGroup.playoffStructureNameBase,
@@ -40444,8 +40646,8 @@ function processPlayoffGroups({
       structureId: playoffGroup.structureId ?? uuids?.pop(),
       playoffAttributes: playoffGroup.playoffAttributes,
       structureNameMap: playoffGroup.structureNameMap,
-      structureName: playoffGroup.structureName,
-      sequenceLimit: playoffGroup.sequenceLimit
+      sequenceLimit: playoffGroup.sequenceLimit,
+      structureName
     };
     const params = {
       ...playoffGroupParams,
@@ -40487,9 +40689,9 @@ function processPlayoffGroups({
       });
       const playoffStructure = structureTemplate({
         structureId: playoffGroup.structureId ?? uuids?.pop(),
-        structureName: playoffGroup.structureName,
         matchUpFormat: playoffMatchUpFormat,
         stage: PLAY_OFF,
+        structureName,
         stageSequence,
         matchUps
       });
@@ -40506,8 +40708,8 @@ function processPlayoffGroups({
         finishingPositions
       });
     } else if ([COMPASS, OLYMPIC, PLAY_OFF].includes(playoffDrawType)) {
-      const { structureName } = playoffGroup;
       const params2 = {
+        playoffAttributes: playoffGroup.playoffAttributes ?? playoffAttributes,
         structureId: playoffGroup.structureId ?? uuids?.pop(),
         playoffStructureNameBase: structureName,
         idPrefix: idPrefix && `${idPrefix}-po`,
@@ -40522,12 +40724,12 @@ function processPlayoffGroups({
       };
       if (playoffDrawType === COMPASS) {
         Object.assign(params2, {
-          playoffAttributes: compassAttributes,
+          playoffAttributes: playoffGroup?.playoffAttributes ?? playoffAttributes ?? COMPASS_ATTRIBUTES,
           roundOffsetLimit: 3
         });
       } else if (playoffDrawType === OLYMPIC) {
         Object.assign(params2, {
-          playoffAttributes: olympicAttributes,
+          playoffAttributes: playoffGroup?.playoffAttributes ?? playoffAttributes ?? OLYMPIC_ATTRIBUTES,
           roundOffsetLimit: 2
         });
       }
@@ -40563,11 +40765,11 @@ function processPlayoffGroups({
       const uuidsFMLC = [uuids?.pop(), uuids?.pop()];
       const params2 = {
         structureId: playoffGroup.structureId ?? uuids?.pop(),
-        structureName: playoffGroup.structureName,
         idPrefix: idPrefix && `${idPrefix}-po`,
         finishingPositionOffset,
         uuids: uuidsFMLC,
         stage: PLAY_OFF,
+        structureName,
         matchUpType,
         feedPolicy,
         drawSize,
@@ -40919,10 +41121,8 @@ function luckyRoundProfiles(drawSize) {
 
 function getGenerators(params) {
   const {
-    compassAttributes = COMPASS_ATTRIBUTES,
-    olympicAttributes = OLYMPIC_ATTRIBUTES,
+    playoffAttributes,
     stageSequence = 1,
-    structureName,
     structureId,
     stage = MAIN,
     matchUpType,
@@ -40932,13 +41132,13 @@ function getGenerators(params) {
   const { appliedPolicies } = getAppliedPolicies(params);
   const feedPolicy = params.policyDefinitions?.[POLICY_TYPE_FEED_IN] || appliedPolicies?.[POLICY_TYPE_FEED_IN];
   params.skipRounds = params.skipRounds || drawSize <= 4 && (feedPolicy?.feedMainFinal ? 0 : 1) || 0;
-  const main = constantToString(MAIN);
+  const structureName = params.structureName ?? playoffAttributes?.["0"]?.name ?? constantToString(MAIN);
   const singleElimination = () => {
     const { matchUps } = treeMatchUps(params);
     const structure = structureTemplate({
       structureId: structureId || uuids?.pop(),
-      structureName: structureName || main,
       stageSequence,
+      structureName,
       matchUpType,
       matchUps,
       stage
@@ -40949,9 +41149,9 @@ function getGenerators(params) {
     [AD_HOC]: () => {
       const structure = structureTemplate({
         structureId: structureId || uuids?.pop(),
-        structureName: structureName || main,
         finishingPosition: WIN_RATIO,
         stageSequence,
+        structureName,
         matchUps: [],
         matchUpType,
         stage
@@ -40962,8 +41162,8 @@ function getGenerators(params) {
       const { matchUps } = luckyDraw(params);
       const structure = structureTemplate({
         structureId: structureId || uuids?.pop(),
-        structureName: structureName || main,
         stageSequence,
+        structureName,
         matchUpType,
         matchUps,
         stage
@@ -40975,12 +41175,12 @@ function getGenerators(params) {
     [COMPASS]: () => generatePlayoffStructures({
       ...params,
       roundOffsetLimit: 3,
-      playoffAttributes: compassAttributes
+      playoffAttributes: playoffAttributes ?? COMPASS_ATTRIBUTES
     }),
     [OLYMPIC]: () => generatePlayoffStructures({
       ...params,
       roundOffsetLimit: 2,
-      playoffAttributes: olympicAttributes
+      playoffAttributes: playoffAttributes ?? OLYMPIC_ATTRIBUTES
     }),
     [PLAY_OFF]: () => {
       return generatePlayoffStructures(params);
@@ -40989,8 +41189,8 @@ function getGenerators(params) {
       const { matchUps } = feedInMatchUps({ drawSize, uuids, matchUpType });
       const structure = structureTemplate({
         structureId: structureId || uuids?.pop(),
-        structureName: structureName || main,
         stageSequence,
+        structureName,
         matchUpType,
         stage: MAIN,
         matchUps
@@ -44029,7 +44229,7 @@ function generateQualifyingStructure$1(params) {
   }
   const roundTargetName = roundTarget ? `${roundTarget}-` : "";
   const stageSequenceName = `${stageSequence}`;
-  const qualifyingStructureName = structureName || (roundTargetName || stageSequenceName ? `${QUALIFYING} ${roundTargetName}${stageSequenceName}` : QUALIFYING);
+  const qualifyingStructureName = structureName || (roundTargetName || stageSequenceName ? `${constantToString(QUALIFYING)} ${roundTargetName}${stageSequenceName}` : constantToString(QUALIFYING));
   if (drawType === ROUND_ROBIN) {
     const { maxRoundNumber, structures, groupCount } = generateRoundRobin({
       structureName: structureName || qualifyingStructureName,
@@ -63933,7 +64133,8 @@ const utilities = {
   unique,
   UUID,
   UUIDS,
-  validateTieFormat
+  validateTieFormat,
+  visualizeScheduledMatchUps
 };
 
 export { EntryStatusEnum, competitionEngine, competitionEngineAsync, deleteNotices, drawDefinitionConstants, drawEngine, drawEngineAsync, entryStatusConstants, errorConditionConstants, eventConstants, factoryConstants, fixtures, flightConstants, genderConstants, getNotices, keyValueConstants, matchUpActionConstants, matchUpEngine, matchUpEngineAsync, matchUpFormatCode, matchUpStatusConstants, matchUpTypes, mocksEngine, participantConstants, participantRoles, participantTypes, penaltyConstants, policyConstants, positionActionConstants, resultConstants, scaleConstants, scaleEngine, scaleEngineAsync, scoreGovernor, setDeepCopy, setDevContext, setStateProvider, setSubscriptions, surfaceConstants, timeItemConstants, tournamentEngine, tournamentEngineAsync, utilities, venueConstants, factoryVersion as version };