Function collectExpectedSlugs

document/script/checkDocRefs.js:176–198

(dir, prefix = '')

// - 子目录若有自己的 meta，则父级只需引用目录名，不下钻
// - 子目录若无 meta，则父级须以 `subdir/file` 形式列出每个文件
function collectExpectedSlugs(dir, prefix = '') {
  const out = new Set();
  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
    if (entry.name.startsWith('.')) continue;
    if (isMetaFile(entry.name)) continue;

    const full = path.join(dir, entry.name);
    if (entry.isFile()) {
      if (!/\.mdx?$/i.test(entry.name)) continue;
      if (isIndexFile(entry.name)) continue;
      const slug = slugFromFile(entry.name);
      out.add(prefix ? `${prefix}/${slug}` : slug);
    } else if (entry.isDirectory()) {
      const childPrefix = prefix ? `${prefix}/${entry.name}` : entry.name;
      if (dirHasMeta(full)) {
        out.add(childPrefix);
      } else {
        for (const s of collectExpectedSlugs(full, childPrefix)) out.add(s);
      }
    }
  }
  return out;
}

function checkMetaCoverage() {
  const errors = [];