Function appendMissingEntries

scripts/sync-sidebar.js:301–334

(block, missingFiles, fallbackGroup)

}

function appendMissingEntries(block, missingFiles, fallbackGroup) {
  const warnings = [];
  const entries = missingFiles.map((file) => file.entry);
  const fallback = fallbackGroup ? findFallbackChildren(block, fallbackGroup) : null;

  if (fallback) {
    const childrenBlock = block.slice(fallback.start, fallback.end + 1);
    const indent = detectChildIndent(childrenBlock, "        ");
    const insertion = entries.map((entry) => `${indent}"${entry}",`).join("\n");
    const insertAt = findLineStart(block, fallback.end);
    const prefix = block.slice(0, insertAt);
    const suffix = block.slice(insertAt);
    const separator = prefix.endsWith("\n") ? "" : "\n";
    return {
      block: `${prefix}${separator}${insertion}\n${suffix}`,
      added: entries,
      warnings,
    };
  }

  warnings.push(`Fallback group "${fallbackGroup}" not found; appended new refs at route root.`);
  const indent = detectChildIndent(block, "    ");
  const insertAt = findLineStart(block, block.length - 1);
  const insertion = entries.map((entry) => `${indent}"${entry}",`).join("\n");
  const prefix = block.slice(0, insertAt);
  const suffix = block.slice(insertAt);
  const separator = prefix.endsWith("\n") ? "" : "\n";

  return {
    block: `${prefix}${separator}${insertion}\n${suffix}`,
    added: entries,
    warnings,
  };
}

function detectChildIndent(block, fallback) {
  const lines = block.split(/\r?\n/).reverse();