tods-competition-factory 1.7.7 → 1.7.9

package/dist/index.mjs

@@ -333,7 +333,7 @@ const matchUpFormatCode = {
 };
 
 function factoryVersion() {
-  return "1.7.7";
+  return "1.7.9";
 }
 
 function getObjectTieFormat(obj) {
@@ -1727,119 +1727,6 @@ function handleCaughtError({
   });
 }
 
-function isString(obj) {
-  return typeof obj === "string";
-}
-function isObject(obj) {
-  return typeof obj === "object";
-}
-const hasAttributeValues = (a) => (o) => Object.keys(a).every((key) => o[key] === a[key]);
-const extractAttributes = (atz) => (o) => !atz || typeof o !== "object" ? void 0 : Array.isArray(atz) && atz.map((a) => ({ [a]: o[a] })) || typeof atz === "object" && Object.keys(atz).map((key) => ({ [key]: o[key] })) || typeof atz === "string" && getAttr(o, atz);
-function getAttr(o, attr) {
-  const attrs = attr.split(".");
-  for (const a of attrs) {
-    o = o?.[a];
-    if (!o)
-      return;
-  }
-  return o;
-}
-function definedAttributes(obj, ignoreFalse, ignoreEmptyArrays, shallow) {
-  if (typeof obj !== "object" || obj === null)
-    return obj;
-  const deepCopy = deepCopyEnabled();
-  if (!deepCopy?.enabled)
-    shallow = true;
-  const ignoreValues = ["", void 0, null];
-  if (ignoreFalse)
-    ignoreValues.push(false);
-  const definedKeys = Object.keys(obj).filter(
-    (key) => !ignoreValues.includes(obj[key]) && (!ignoreEmptyArrays || (Array.isArray(obj[key]) ? obj[key].length : true))
-  );
-  return Object.assign(
-    {},
-    ...definedKeys.map((key) => {
-      return Array.isArray(obj[key]) ? {
-        [key]: shallow ? obj[key] : obj[key].map((m) => definedAttributes(m))
-      } : { [key]: shallow ? obj[key] : definedAttributes(obj[key]) };
-    })
-  );
-}
-function countKeys(o) {
-  if (Array.isArray(o)) {
-    return o.length + o.map(countKeys).reduce((a, b) => a + b, 0);
-  } else if (typeof o === "object" && o !== null) {
-    return Object.keys(o).length + Object.keys(o).map((k) => countKeys(o[k])).reduce((a, b) => a + b, 0);
-  }
-  return 0;
-}
-function generateHashCode(o) {
-  if (o === null || typeof o !== "object")
-    return void 0;
-  const str = JSON.stringify(o);
-  const keyCount = countKeys(o);
-  const charSum = str.split("").reduce((a, b) => a + b.charCodeAt(0), 0);
-  return [str.length, keyCount, charSum].map((e) => e.toString(36)).join("");
-}
-
-function attributeFilter(params) {
-  if (params === null)
-    return {};
-  const { source, template } = params || {};
-  if (!template)
-    return source;
-  const target = {};
-  attributeCopy(source, template, target);
-  return target;
-  function attributeCopy(valuesObject, templateObject, outputObject) {
-    if (!valuesObject || !templateObject)
-      return void 0;
-    const vKeys = Object.keys(valuesObject);
-    const oKeys = Object.keys(templateObject);
-    const orMap = Object.assign(
-      {},
-      ...oKeys.filter((key) => key.indexOf("||")).map((key) => key.split("||").map((or) => ({ [or]: key }))).flat()
-    );
-    const allKeys = oKeys.concat(...Object.keys(orMap));
-    const wildcard = allKeys.includes("*");
-    for (const vKey of vKeys) {
-      if (allKeys.indexOf(vKey) >= 0 || wildcard) {
-        const templateKey = orMap[vKey] || vKey;
-        const tobj = templateObject[templateKey] || wildcard;
-        const vobj = valuesObject[vKey];
-        if (typeof tobj === "object" && typeof vobj !== "function" && !Array.isArray(tobj)) {
-          if (Array.isArray(vobj)) {
-            const mappedElements = vobj.map((arrayMember) => {
-              const target2 = {};
-              const result = attributeCopy(arrayMember, tobj, target2);
-              return result !== false ? target2 : void 0;
-            }).filter(Boolean);
-            outputObject[vKey] = mappedElements;
-          } else if (vobj) {
-            outputObject[vKey] = {};
-            attributeCopy(vobj, tobj, outputObject[vKey]);
-          }
-        } else {
-          const value = valuesObject[vKey];
-          const exclude = Array.isArray(tobj) && !tobj.includes(value);
-          if (exclude)
-            return false;
-          if (templateObject[vKey] || wildcard && templateObject[vKey] !== false) {
-            outputObject[vKey] = value;
-          }
-        }
-      }
-    }
-    return void 0;
-  }
-}
-
-function generateTimeCode(index = 0) {
-  const uidate = /* @__PURE__ */ new Date();
-  uidate.setHours(uidate.getHours() + index);
-  return uidate.getTime().toString(36).slice(-6).toUpperCase();
-}
-
 const validDateString = /^[\d]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][\d]|3[0-1])$/;
 const validTimeString = /^((0[\d]|1[\d]|2[0-3]):[0-5][\d](:[0-5][\d])?)([.,][0-9]{3})?$/;
 const dateValidation = /^([\d]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][\d]|3[0-1]))([ T](0[\d]|1[\d]|2[0-3]):[0-5][\d](:[0-5][\d])?)?([.,][\d]{3})?Z?$/;
@@ -2209,6 +2096,182 @@ function extensionsToAttributes(extensions) {
   }).filter(Boolean);
 }
 
+function getAccessorValue({ element, accessor }) {
+  if (typeof accessor !== "string")
+    return { values: [] };
+  const targetElement = makeDeepCopy(element);
+  const attributes = accessor.split(".");
+  const values = [];
+  let value;
+  processKeys({ targetElement, attributes });
+  const result = { value };
+  if (values.length)
+    result.values = values;
+  return result;
+  function processKeys({
+    targetElement: targetElement2,
+    attributes: attributes2 = [],
+    significantCharacters
+  }) {
+    for (const [index, attribute] of attributes2.entries()) {
+      if (targetElement2?.[attribute]) {
+        const remainingKeys = attributes2.slice(index + 1);
+        if (!remainingKeys.length) {
+          if (!value)
+            value = targetElement2[attribute];
+          if (!values.includes(targetElement2[attribute])) {
+            values.push(targetElement2[attribute]);
+          }
+        } else if (Array.isArray(targetElement2[attribute])) {
+          const values2 = targetElement2[attribute];
+          values2.forEach(
+            (nestedTarget) => processKeys({
+              targetElement: nestedTarget,
+              attributes: remainingKeys
+            })
+          );
+        } else {
+          targetElement2 = targetElement2[attribute];
+          checkValue({ targetElement: targetElement2, index });
+        }
+      }
+    }
+    function checkValue({ targetElement: targetElement3, index }) {
+      if (targetElement3 && index === attributes2.length - 1 && ["string", "number"].includes(typeof targetElement3)) {
+        const extractedValue = significantCharacters ? targetElement3.slice(0, significantCharacters) : targetElement3;
+        if (value) {
+          if (!values.includes(extractedValue)) {
+            values.push(extractedValue);
+          }
+        } else {
+          value = extractedValue;
+          values.push(extractedValue);
+        }
+      }
+    }
+  }
+}
+
+function isString(obj) {
+  return typeof obj === "string";
+}
+function isObject(obj) {
+  return typeof obj === "object";
+}
+function createMap(objectArray, attribute) {
+  if (!Array.isArray(objectArray))
+    return {};
+  return Object.assign(
+    {},
+    ...(objectArray ?? []).filter(isObject).map((obj) => {
+      return obj[attribute] && {
+        [obj[attribute]]: obj
+      };
+    }).filter(Boolean)
+  );
+}
+const hasAttributeValues = (a) => (o) => Object.keys(a).every((key) => o[key] === a[key]);
+const extractAttributes = (accessor) => (element) => !accessor || typeof element !== "object" ? void 0 : Array.isArray(accessor) && accessor.map((a) => ({
+  [a]: getAccessorValue({ element, accessor: a })?.value
+})) || typeof accessor === "object" && Object.keys(accessor).map((key) => ({
+  [key]: getAccessorValue({ element, accessor: key })?.value
+})) || (typeof accessor === "string" && getAccessorValue({ element, accessor }))?.value;
+function definedAttributes(obj, ignoreFalse, ignoreEmptyArrays, shallow) {
+  if (typeof obj !== "object" || obj === null)
+    return obj;
+  const deepCopy = deepCopyEnabled();
+  if (!deepCopy?.enabled)
+    shallow = true;
+  const ignoreValues = ["", void 0, null];
+  if (ignoreFalse)
+    ignoreValues.push(false);
+  const definedKeys = Object.keys(obj).filter(
+    (key) => !ignoreValues.includes(obj[key]) && (!ignoreEmptyArrays || (Array.isArray(obj[key]) ? obj[key].length : true))
+  );
+  return Object.assign(
+    {},
+    ...definedKeys.map((key) => {
+      return Array.isArray(obj[key]) ? {
+        [key]: shallow ? obj[key] : obj[key].map((m) => definedAttributes(m))
+      } : { [key]: shallow ? obj[key] : definedAttributes(obj[key]) };
+    })
+  );
+}
+function countKeys(o) {
+  if (Array.isArray(o)) {
+    return o.length + o.map(countKeys).reduce((a, b) => a + b, 0);
+  } else if (typeof o === "object" && o !== null) {
+    return Object.keys(o).length + Object.keys(o).map((k) => countKeys(o[k])).reduce((a, b) => a + b, 0);
+  }
+  return 0;
+}
+function generateHashCode(o) {
+  if (o === null || typeof o !== "object")
+    return void 0;
+  const str = JSON.stringify(o);
+  const keyCount = countKeys(o);
+  const charSum = str.split("").reduce((a, b) => a + b.charCodeAt(0), 0);
+  return [str.length, keyCount, charSum].map((e) => e.toString(36)).join("");
+}
+
+function attributeFilter(params) {
+  if (params === null)
+    return {};
+  const { source, template } = params || {};
+  if (!template)
+    return source;
+  const target = {};
+  attributeCopy(source, template, target);
+  return target;
+  function attributeCopy(valuesObject, templateObject, outputObject) {
+    if (!valuesObject || !templateObject)
+      return void 0;
+    const vKeys = Object.keys(valuesObject);
+    const oKeys = Object.keys(templateObject);
+    const orMap = Object.assign(
+      {},
+      ...oKeys.filter((key) => key.indexOf("||")).map((key) => key.split("||").map((or) => ({ [or]: key }))).flat()
+    );
+    const allKeys = oKeys.concat(...Object.keys(orMap));
+    const wildcard = allKeys.includes("*");
+    for (const vKey of vKeys) {
+      if (allKeys.indexOf(vKey) >= 0 || wildcard) {
+        const templateKey = orMap[vKey] || vKey;
+        const tobj = templateObject[templateKey] || wildcard;
+        const vobj = valuesObject[vKey];
+        if (typeof tobj === "object" && typeof vobj !== "function" && !Array.isArray(tobj)) {
+          if (Array.isArray(vobj)) {
+            const mappedElements = vobj.map((arrayMember) => {
+              const target2 = {};
+              const result = attributeCopy(arrayMember, tobj, target2);
+              return result !== false ? target2 : void 0;
+            }).filter(Boolean);
+            outputObject[vKey] = mappedElements;
+          } else if (vobj) {
+            outputObject[vKey] = {};
+            attributeCopy(vobj, tobj, outputObject[vKey]);
+          }
+        } else {
+          const value = valuesObject[vKey];
+          const exclude = Array.isArray(tobj) && !tobj.includes(value);
+          if (exclude)
+            return false;
+          if (templateObject[vKey] || wildcard && templateObject[vKey] !== false) {
+            outputObject[vKey] = value;
+          }
+        }
+      }
+    }
+    return void 0;
+  }
+}
+
+function generateTimeCode(index = 0) {
+  const uidate = /* @__PURE__ */ new Date();
+  uidate.setHours(uidate.getHours() + index);
+  return uidate.getTime().toString(36).slice(-6).toUpperCase();
+}
+
 function numericSort(a, b) {
   return a - b;
 }
@@ -7605,7 +7668,7 @@ function isAdHoc({ drawDefinition, structure }) {
   const hasDrawPosition = matchUps?.find(
     (matchUp) => matchUp?.drawPositions?.length
   );
-  return !structure?.structures && !(drawDefinition?.drawType && drawDefinition.drawType !== AD_HOC) && !hasRoundPosition && !hasDrawPosition;
+  return !structure?.structures && structure?.stage !== VOLUNTARY_CONSOLATION && !(drawDefinition?.drawType && drawDefinition.drawType !== AD_HOC) && !hasRoundPosition && !hasDrawPosition;
 }
 
 const POLICY_ROUND_NAMING_DEFAULT = {
@@ -22701,6 +22764,15 @@ function getNumericSeedValue(seedValue) {
   return Infinity;
 }
 
+function capitalizeFirst(str) {
+  return !isString(str) ? str : str.split(" ").map(
+    (name) => name.split("").map((c, i) => i ? c.toLowerCase() : c.toUpperCase()).join("")
+  ).join(" ");
+}
+function constantToString(str) {
+  return !isString(str) ? str : capitalizeFirst(str.replace(/_/g, " "));
+}
+
 const structureTemplate = ({
   finishingPosition = ROUND_OUTCOME,
   qualifyingRoundNumber,
@@ -22764,7 +22836,7 @@ const structureTemplate = ({
 };
 
 function generateRoundRobin({
-  structureName = MAIN,
+  structureName = constantToString(MAIN),
   stageSequence = 1,
   structureOptions,
   appliedPolicies,
@@ -26141,56 +26213,6 @@ function getEventPublishStatuses({ event }) {
   return void 0;
 }
 
-function getAccessorValue({ element, accessor }) {
-  if (typeof accessor !== "string")
-    return { values: [] };
-  const targetElement = makeDeepCopy(element);
-  const attributes = accessor.split(".");
-  const values = [];
-  let value;
-  processKeys({ targetElement, attributes });
-  const result = { value };
-  if (values.length)
-    result.values = values;
-  return result;
-  function processKeys({
-    targetElement: targetElement2,
-    attributes: attributes2 = [],
-    significantCharacters
-  }) {
-    for (const [index, attribute] of attributes2.entries()) {
-      if (targetElement2?.[attribute]) {
-        if (Array.isArray(targetElement2[attribute])) {
-          const values2 = targetElement2[attribute];
-          const remainingKeys = attributes2.slice(index);
-          values2.forEach(
-            (nestedTarget) => processKeys({
-              targetElement: nestedTarget,
-              attributes: remainingKeys
-            })
-          );
-        } else {
-          targetElement2 = targetElement2[attribute];
-          checkValue({ targetElement: targetElement2, index });
-        }
-      }
-    }
-    function checkValue({ targetElement: targetElement3, index }) {
-      if (targetElement3 && index === attributes2.length - 1 && ["string", "number"].includes(typeof targetElement3)) {
-        const extractedValue = significantCharacters ? targetElement3.slice(0, significantCharacters) : targetElement3;
-        if (value) {
-          if (!values.includes(extractedValue)) {
-            values.push(extractedValue);
-          }
-        } else {
-          value = extractedValue;
-          values.push(extractedValue);
-        }
-      }
-    }
-  }
-}
-
 function participantScaleItem({
   requireTimeStamp,
   scaleAttributes,
@@ -28742,10 +28764,12 @@ function getParticipantEntries(params) {
               seedAssignments[MAIN] = mainSeeding;
             if (seedAssignments && qualifyingSeeding)
               seedAssignments[QUALIFYING] = mainSeeding;
-            if (withEvents || withRankingProfile) {
+            if ((withEvents || withRankingProfile) && participantMap[id] && eventId) {
+              if (!participantMap[id].events[eventId])
+                participantMap[id].events[eventId] = {};
               if (includeSeeding) {
                 participantMap[id].events[eventId].seedValue = mainSeeding || qualifyingSeeding;
-              } else if (participantMap[id].events[eventId]?.seedValue) {
+              } else if (participantMap[id].events[eventId].seedValue) {
                 participantMap[id].events[eventId].seedValue = void 0;
               }
             }
@@ -39584,8 +39608,8 @@ function firstRoundLoserConsolation(params) {
   };
   const { matchUps } = staggeredEntry ? feedInMatchUps(mainParams) : treeMatchUps(mainParams);
   const mainStructure = structureTemplate({
+    structureName: structureName || constantToString(MAIN),
     structureId: structureId || uuids?.pop(),
-    structureName: structureName || MAIN,
     stageSequence,
     matchUpType,
     matchUps,
@@ -39602,7 +39626,8 @@ function firstRoundLoserConsolation(params) {
       matchUpType,
       isMock
     });
-    const consolationStructureName = params.consolationStructureName || (structureName ? `${structureName} ${CONSOLATION}` : CONSOLATION);
+    const consolation = constantToString(CONSOLATION);
+    const consolationStructureName = params.consolationStructureName || (structureName ? `${structureName} ${consolation}` : consolation);
     const consolationStructure = structureTemplate({
       structureName: consolationStructureName,
       matchUps: consolationMatchUps,
@@ -39680,8 +39705,9 @@ function feedInLinks({
 
 function generateCurtisConsolation(params) {
   const {
+    structureName = constantToString(MAIN),
+    playoffStructureNameBase,
     finishingPositionOffset,
-    structureName = MAIN,
     stageSequence = 1,
     structureNameMap,
     staggeredEntry,
@@ -39719,6 +39745,7 @@ function generateCurtisConsolation(params) {
       const { consolationStructure } = consolationFeedStructure({
         idPrefix: idPrefix && `${idPrefix}-c${index}`,
         structureId: uuids?.pop(),
+        playoffStructureNameBase,
         structureNameMap,
         stageSequence: stageSequence2,
         roundOffset,
@@ -39747,12 +39774,15 @@ function generateCurtisConsolation(params) {
         matchUpType,
         isMock
       });
+      const defaultName = constantToString(PLAY_OFF);
+      const mappedStructureName = structureNameMap?.[defaultName] || defaultName;
+      const structureName2 = playoffStructureNameBase ? `${playoffStructureNameBase} ${mappedStructureName}` : mappedStructureName;
       const playoffStructure = structureTemplate({
-        structureName: structureNameMap?.[PLAY_OFF] || PLAY_OFF,
         structureId: uuids?.pop(),
         matchUps: playoffMatchUps,
         stageSequence: 2,
         stage: PLAY_OFF,
+        structureName: structureName2,
         matchUpType
       });
       const playoffLink = {
@@ -39774,6 +39804,7 @@ function generateCurtisConsolation(params) {
   return { structures, links, ...SUCCESS };
 }
 function consolationFeedStructure({
+  playoffStructureNameBase,
   stageSequence = 1,
   structureNameMap,
   roundOffset = 0,
@@ -39796,8 +39827,9 @@ function consolationFeedStructure({
     isMock,
     uuids
   });
-  const defaultName = `${CONSOLATION} ${index + 1}`;
-  const structureName = structureNameMap?.[defaultName] || defaultName;
+  const defaultName = `${constantToString(CONSOLATION)} ${index + 1}`;
+  const mappedStructureName = structureNameMap?.[defaultName] || defaultName;
+  const structureName = playoffStructureNameBase ? `${playoffStructureNameBase} ${mappedStructureName}` : mappedStructureName;
   const consolationStructure = structureTemplate({
     matchUps: consolationMatchUps,
     stage: CONSOLATION,
@@ -39810,7 +39842,6 @@ function consolationFeedStructure({
 }
 
 function generatePlayoffStructures(params) {
-  let { matchUpType } = params;
   const {
     finishingPositionOffset = 0,
     addNameBaseToAttributeName,
@@ -39840,7 +39871,7 @@ function generatePlayoffStructures(params) {
   const allMatchUps = [];
   const structures = [];
   const links = [];
-  matchUpType = matchUpType || drawDefinition?.matchUpType;
+  const matchUpType = params.matchUpType || drawDefinition?.matchUpType;
   const finishingPositionsFrom = finishingPositionOffset + 1;
   const finishingPositionsTo = finishingPositionOffset + drawSize;
   const finishingPositionRange = `${finishingPositionsFrom}-${finishingPositionsTo}`;
@@ -39890,7 +39921,7 @@ function generatePlayoffStructures(params) {
     if (playoffDrawPositions < 2)
       return;
     const childFinishingPositionOffset = drawSize / Math.pow(2, roundNumber) + finishingPositionOffset;
-    if (childFinishingPositionOffset + 1 > finishingPositionLimit)
+    if (finishingPositionLimit && childFinishingPositionOffset + 1 > finishingPositionLimit)
       return;
     const {
       structures: childStructures,
@@ -39978,8 +40009,8 @@ function feedInChampionship(params) {
   };
   const { matchUps } = staggeredEntry ? feedInMatchUps(mainParams) : treeMatchUps(mainParams);
   const mainStructure = structureTemplate({
+    structureName: structureName || constantToString(MAIN),
     structureId: structureId || uuids?.pop(),
-    structureName: structureName || MAIN,
     stageSequence,
     matchUpType,
     matchUps,
@@ -40003,9 +40034,9 @@ function feedInChampionship(params) {
   });
   if (drawSize > 2) {
     const consolationStructure = structureTemplate({
+      structureName: constantToString(CONSOLATION),
       matchUps: consolationMatchUps,
       structureId: uuids?.pop(),
-      structureName: CONSOLATION,
       stage: CONSOLATION,
       stageSequence: 1,
       matchUpType
@@ -40080,10 +40111,19 @@ function processPlayoffGroups({
     if (positionsPlayedOff) {
       finishingPositionOffset = Math.min(...positionsPlayedOff) - 1;
     }
-    const params = {
+    const playoffGroupParams = {
+      addNameBaseToAttributeName: playoffGroup.addNameBaseToAttributeName,
+      playoffStructureNameBase: playoffGroup.playoffStructureNameBase,
+      finishingPositionNaming: playoffGroup.finishingPositionNaming,
+      finishingPositionLimit: playoffGroup.finishingPositionLimit,
       structureId: playoffGroup.structureId ?? uuids?.pop(),
+      playoffAttributes: playoffGroup.playoffAttributes,
       structureNameMap: playoffGroup.structureNameMap,
       structureName: playoffGroup.structureName,
+      sequenceLimit: playoffGroup.sequenceLimit
+    };
+    const params = {
+      ...playoffGroupParams,
       idPrefix: idPrefix && `${idPrefix}-po`,
       appliedPolicies: policyDefinitions,
       finishingPositionOffset,
@@ -40281,13 +40321,17 @@ function generatePlayoffLink({
 
 function generateRoundRobinWithPlayOff(params) {
   const { drawDefinition, structureOptions, requireSequential } = params;
-  const mainDrawProperties = { structureName: MAIN, ...params, stage: MAIN };
+  const mainDrawProperties = {
+    structureName: constantToString(MAIN),
+    ...params,
+    stage: MAIN
+  };
   const { structures, groupCount, groupSize } = generateRoundRobin(mainDrawProperties);
   if (groupCount < 1) {
     console.log(INVALID_CONFIGURATION);
   }
   const playoffGroups = structureOptions?.playoffGroups || [
-    { finishingPositions: [1], structureName: PLAY_OFF }
+    { finishingPositions: [1], structureName: constantToString(PLAY_OFF) }
   ];
   const [mainStructure] = structures;
   const { structures: playoffStructures, links } = processPlayoffGroups({
@@ -40405,7 +40449,7 @@ function generateDoubleElimination({
     isMock
   });
   const mainStructure = structureTemplate({
-    structureName: structureName || MAIN,
+    structureName: structureName || constantToString(MAIN),
     structureId: uuids?.pop(),
     stageSequence: 1,
     stage: MAIN,
@@ -40424,9 +40468,9 @@ function generateDoubleElimination({
     uuids
   });
   const consolationStructure = structureTemplate({
+    structureName: constantToString(BACKDRAW),
     matchUps: consolationMatchUps,
     structureId: uuids?.pop(),
-    structureName: BACKDRAW,
     stage: CONSOLATION,
     stageSequence: 2,
     matchUpType
@@ -40439,9 +40483,9 @@ function generateDoubleElimination({
     isMock
   });
   const deciderStructure = structureTemplate({
+    structureName: constantToString(DECIDER),
     matchUps: deciderMatchUps,
     structureId: uuids?.pop(),
-    structureName: DECIDER,
     stageSequence: 3,
     stage: PLAY_OFF,
     matchUpType
@@ -40563,11 +40607,12 @@ 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 singleElimination = () => {
     const { matchUps } = treeMatchUps(params);
     const structure = structureTemplate({
-      structureName: structureName || MAIN,
       structureId: structureId || uuids?.pop(),
+      structureName: structureName || main,
       stageSequence,
       matchUpType,
       matchUps,
@@ -40578,8 +40623,8 @@ function getGenerators(params) {
   const generators = {
     [AD_HOC]: () => {
       const structure = structureTemplate({
-        structureName: structureName || MAIN,
         structureId: structureId || uuids?.pop(),
+        structureName: structureName || main,
         finishingPosition: WIN_RATIO,
         stageSequence,
         matchUps: [],
@@ -40591,8 +40636,8 @@ function getGenerators(params) {
     [LUCKY_DRAW]: () => {
       const { matchUps } = luckyDraw(params);
       const structure = structureTemplate({
-        structureName: structureName || MAIN,
         structureId: structureId || uuids?.pop(),
+        structureName: structureName || main,
         stageSequence,
         matchUpType,
         matchUps,
@@ -40618,8 +40663,8 @@ function getGenerators(params) {
     [FEED_IN$1]: () => {
       const { matchUps } = feedInMatchUps({ drawSize, uuids, matchUpType });
       const structure = structureTemplate({
-        structureName: structureName || MAIN,
         structureId: structureId || uuids?.pop(),
+        structureName: structureName || main,
         stageSequence,
         matchUpType,
         stage: MAIN,
@@ -43176,8 +43221,11 @@ function generateAndPopulatePlayoffStructures(params) {
     structureId: sourceStructureId,
     addNameBaseToAttributeName,
     playoffStructureNameBase,
+    finishingPositionNaming,
+    finishingPositionLimit,
     playoffAttributes,
     playoffPositions,
+    roundOffsetLimit,
     tournamentRecord,
     exitProfileLimit,
     roundProfiles,
@@ -43282,7 +43330,10 @@ function generateAndPopulatePlayoffStructures(params) {
       drawSize,
       idPrefix,
       isMock,
-      uuids
+      uuids,
+      finishingPositionNaming,
+      finishingPositionLimit,
+      roundOffsetLimit
     });
     if (result.error)
       return decorateResult({ result, stack });
@@ -43490,9 +43541,9 @@ function generateVoluntaryConsolation$1(params) {
       return result2;
   }
   tieFormat = copyTieFormat(
-    tieFormat || resolveTieFormat({ drawDefinition })?.tieFormat
+    tieFormat ?? resolveTieFormat({ drawDefinition })?.tieFormat
   );
-  matchUpType = matchUpType || drawDefinition.matchUpType || TypeEnum.Singles;
+  matchUpType = matchUpType ?? drawDefinition.matchUpType ?? TypeEnum.Singles;
   const { structures: stageStructures } = getDrawStructures({
     stageSequence: 1,
     drawDefinition,
@@ -43500,14 +43551,14 @@ function generateVoluntaryConsolation$1(params) {
   });
   const structureCount = stageStructures.length;
   if (structureCount > 1)
-    return { error: INVALID_STRUCTURE };
+    return { error: STAGE_SEQUENCE_LIMIT };
   if (stageStructures?.[0]?.matchUps?.length)
-    return { error: INVALID_STRUCTURE };
+    return { error: EXISTING_STRUCTURE };
   const structureId = stageStructures?.[0]?.structureId;
   Object.assign(
     params,
     definedAttributes({
-      structureName: params.structureName || VOLUNTARY_CONSOLATION,
+      structureName: params.structureName ?? constantToString(VOLUNTARY_CONSOLATION),
       structureId,
       matchUpType,
       tieFormat,
@@ -50604,6 +50655,90 @@ function modifyParticipantOtherName({
   return { ...SUCCESS };
 }
 
+function formatPersonName({
+  personFormat,
+  person
+}) {
+  const alpha = (str) => str.replace(/\W/g, "");
+  const allLowerCase = (str) => /^[a-z]*$/.test(alpha(str));
+  const allUpperCase = (str) => /^[A-Z]*$/.test(alpha(str));
+  const lastUpperCase = (str) => /^[LAST]{4}/.test(alpha(str));
+  const lastFirst = (str) => str.toLowerCase().indexOf("l") < str.toLowerCase().indexOf("f");
+  const commaSeparated = (str) => str.indexOf(",") >= 0;
+  const firstInital = (str) => str.toLowerCase().indexOf("f.") >= 0;
+  const lastNameOnly = (str) => str.toLowerCase().indexOf("f") < 0;
+  const hasSpacing = (str) => str.indexOf(" ") > 0;
+  if (!person)
+    return;
+  const spacer = hasSpacing(personFormat) ? " " : "";
+  let firstName = capitalizeFirst(person?.standardGivenName ?? "");
+  let lastName = capitalizeFirst(person?.standardFamilyName ?? "");
+  if (!personFormat)
+    return `${firstName}${spacer}${lastName}`;
+  if (firstInital(personFormat) && !commaSeparated(personFormat) && !lastFirst(personFormat)) {
+    firstName = `${firstName[0]}.`;
+  }
+  if (allLowerCase(personFormat)) {
+    firstName = firstName.toLowerCase();
+    lastName = lastName.toLowerCase();
+  } else if (allUpperCase(personFormat)) {
+    firstName = firstName.toUpperCase();
+    lastName = lastName.toUpperCase();
+  } else if (lastUpperCase(personFormat)) {
+    lastName = lastName.toUpperCase();
+  }
+  let participantName = `${firstName}${spacer}${lastName}`;
+  if (lastNameOnly(personFormat)) {
+    participantName = lastName;
+  } else if (lastFirst(personFormat)) {
+    if (commaSeparated(personFormat)) {
+      participantName = `${lastName},${spacer}${firstName}`;
+    } else {
+      participantName = `${lastName}${spacer}${firstName}`;
+    }
+  }
+  return participantName;
+}
+
+function formatParticipantName({
+  participantMap,
+  participant,
+  formats
+}) {
+  const { participantType, individualParticipantIds, person } = participant;
+  const format = participantType && formats[participantType];
+  if (participantType === TEAM_PARTICIPANT)
+    return;
+  if (format) {
+    const { personFormat, doublesJoiner } = format;
+    if (participantType === INDIVIDUAL) {
+      participant.participantName = formatPersonName({ person, personFormat });
+    }
+    if (participantType === PAIR) {
+      participant.participantName = individualParticipantIds?.map((id) => {
+        const person2 = participantMap[id]?.person;
+        return formatPersonName({ person: person2, personFormat });
+      }).filter(Boolean).join(doublesJoiner ?? "/");
+    }
+  }
+}
+
+function regenerateParticipantNames({
+  tournamentRecord,
+  formats
+}) {
+  if (!tournamentRecord)
+    return { error: MISSING_TOURNAMENT_RECORD };
+  if (!isObject(formats))
+    return { error: MISSING_VALUE };
+  const participants = tournamentRecord.participants ?? [];
+  const participantMap = createMap(participants, "participantId");
+  for (const participant of participants) {
+    formatParticipantName({ participant, participantMap, formats });
+  }
+  return { ...SUCCESS };
+}
+
 function getTournamentPersons({ tournamentRecord, participantFilters }) {
   if (!tournamentRecord)
     return { error: MISSING_TOURNAMENT_RECORD };
@@ -51097,6 +51232,7 @@ const participantGovernor = {
   removeParticipantIdsFromAllTeams,
   getParticipantMembership,
   generateTeamsFromParticipantAttribute,
+  regenerateParticipantNames,
   getParticipantIdFinishingPositions,
   modifyParticipant,
   modifyParticipantName,
@@ -58037,7 +58173,7 @@ function generateDrawDefinition(params) {
     }
   } else if (structureId && generateQualifyingPlaceholder) {
     const qualifyingStructure = structureTemplate({
-      structureName: QUALIFYING,
+      structureName: constantToString(QUALIFYING),
       stage: QUALIFYING
     });
     const { link } = generateQualifyingLink({
@@ -60402,7 +60538,7 @@ function generatePersons(params) {
         return false;
       if (typeof person.lastName !== "string")
         return false;
-      if (![MALE, FEMALE].includes(person.sex))
+      if (person.sex && ![MALE, FEMALE].includes(person.sex))
         return false;
       if (person.nationalityCode && (typeof person.nationalityCode !== "string" || person.nationalityCode.length > 3 || !countries.find(
         ({ iso, ioc }) => [iso, ioc].includes(person.nationalityCode)
@@ -60418,7 +60554,7 @@ function generatePersons(params) {
       return { error: INVALID_VALUES };
     }
   }
-  const shuffledPersons = shuffleArray(validPersonData);
+  const shuffledPersons = personData ? validPersonData : shuffleArray(validPersonData);
   if (shuffledPersons.length < count) {
     const {
       maleFirstNames,
@@ -63291,6 +63427,7 @@ const utilities = {
   structureSort,
   matchUpSort,
   tidyScore,
+  createMap,
   generateScoreString,
   calculateWinCriteria,
   compareTieFormats,