Function transformSuperBlock

curriculum/src/build-superblock.ts:475–527

(
  superblockData: {
    blocks?: string[];
    chapters?: Chapter[];
  },
  { showComingSoon } = { showComingSoon: false }
)

 * @returns {object[]} Array of block objects with dashedName, chapter, and module properties
 */
export function transformSuperBlock(
  superblockData: {
    blocks?: string[];
    chapters?: Chapter[];
  },
  { showComingSoon } = { showComingSoon: false }
) {
  let blocks: BlockInfo[] = [];
  const shouldAllowEmptyBlocks =
    !showComingSoon &&
    superblockData.chapters?.every(chapter => chapter.comingSoon);

  // Handle simple blocks array format
  if (superblockData.blocks) {
    blocks = superblockData.blocks.map(dashedName => ({
      dashedName
    }));
  }
  // Handle nested chapters/modules/blocks format
  else if (superblockData.chapters) {
    for (const chapter of superblockData.chapters) {
      if (chapter.comingSoon && !showComingSoon) {
        continue;
      }

      if (chapter.modules) {
        for (const module of chapter.modules) {
          if (module.comingSoon && !showComingSoon) {
            continue;
          }

          if (module.blocks) {
            for (const block of module.blocks) {
              blocks.push({
                dashedName: block,
                chapter: chapter.dashedName,
                module: module.dashedName
              });
            }
          }
        }
      }
    }
  }

  if (isEmpty(blocks) && !shouldAllowEmptyBlocks) {
    throw Error(`No blocks found in superblock data`);
  }

  const blockNames = blocks.map(block => block.dashedName);
  log(`Found ${blocks.length} blocks: ${blockNames.join(', ')}`);
  return blocks;
}