// site/src/utils/referenceSlugMap.ts
// CRITICAL FIX: Use the SAME slug generation logic that's used in index.astro
// This ensures the key used for lookup matches the key created here
// We use the normalized entry.id as the key, which matches how index.astro generates slugs
const slug = getReferenceSlug(entry.id, entry.data.slug);
map[slug] = filenameNoExt;

// site/src/utils/referenceSlugMap.ts
export function getReferenceSlug(filename: string, frontmatterSlug?: string): string {
  // Match getStaticPaths: use frontmatter slug if present, else slugify the filename
  return frontmatterSlug || slugify(filename);
}

export function getOriginalFilenameMap(
  entries: { id: string; data: { slug?: string } }[],
  collectionDir: string
): Record<string, string> {
  // DEBUG: Print collectionDir and files
  console.log('[getOriginalFilenameMap] collectionDir:', collectionDir);
  const files = getAllMarkdownFiles(collectionDir, collectionDir);
  console.log('[getOriginalFilenameMap] files:', files);

  // Aggressively comment: This function guarantees slug -> true original filename (with correct casing)
  // by reading ALL .md filenames directly from the filesystem, recursively.
  // This supports concepts in nested folders (e.g., CARBS/Explainers for AI/ etc).
  // Do not trust Astro's id or slug for casing!
  const map: Record<string, string> = {};
  
  // DEBUG: Enhanced logging
  console.log(`[getOriginalFilenameMap] Processing ${entries.length} entries against ${files.length} files`);
  
  for (const entry of entries) {
    // DEBUG: Print entry.id and entry.data.slug
    console.log('\n[getOriginalFilenameMap] Processing entry.id:', entry.id);
    console.log('[getOriginalFilenameMap] entry.data.slug:', entry.data.slug);

    // Astro's entry.id is relative to the content root (e.g., concepts/Explainers for AI/AI Hallucinations.md)
    // Remove the collectionDir prefix, then remove .md and lowercase for matching.
    // Robust normalization: lowercase, replace spaces/dashes with dashes, strip .md
    // This allows matching between Astro's slugified id and the original filesystem path
    const normalize = (s: string) => {
      const result = s
        .replace(/\.md$/, '')
        .toLowerCase()
        .replace(/[\s_]+/g, '-')
        .replace(/-+/g, '-');
      return result;
    };
    
    const entryNorm = normalize(entry.id);
    // DEBUG: Print entryNorm
    console.log('[getOriginalFilenameMap] entryNorm:', entryNorm);
    
    // DEBUG: Show all normalized files for comparison
    console.log('[getOriginalFilenameMap] Looking for match among normalized files:');
    const normalizedFiles = files.map(f => ({ original: f, normalized: normalize(f) }));
    normalizedFiles.forEach(nf => {
      const isMatch = nf.normalized === entryNorm;
      console.log(`  ${isMatch ? '✓' : '✗'} ${nf.normalized} (from ${nf.original})`);
    });
    
    // Find the real file from the filesystem list by matching normalized path
    const realFile = files.find(f => normalize(f) === entryNorm);
    // DEBUG: Print realFile
    console.log('[getOriginalFilenameMap] realFile found:', realFile);
    
    if (realFile) {
      // Extract only the filename (no directory, no extension, original casing) for the map value
      // Example: 'Explainers for AI/World Foundation Models.md' -> 'World Foundation Models'
      const filenameNoExt = path.basename(realFile, '.md');
      
      // CRITICAL FIX: Use the SAME slug generation logic that's used in index.astro
      // This ensures the key used for lookup matches the key created here
      // We use the normalized entry.id as the key, which matches how index.astro generates slugs
      const slug = getReferenceSlug(entry.id, entry.data.slug);
      console.log(`[getOriginalFilenameMap] Using entry.id for slug key: ${slug}`);
      map[slug] = filenameNoExt;
      // DEBUG: Print the final mapping for this slug
      console.log(`[getOriginalFilenameMap] ADDED TO MAP: map[${slug}] = ${filenameNoExt}`);
    } else {
      console.log(`[getOriginalFilenameMap] ⚠️ NO MATCH FOUND for entry.id: ${entry.id}`);
      console.log(`[getOriginalFilenameMap] This entry will have undefined originalFilename`);
    }
  }
  
  // DEBUG: Show final map contents
  console.log('\n[getOriginalFilenameMap] Final map contents:');
  Object.entries(map).forEach(([k, v]) => {
    console.log(`  map[${k}] = ${v}`);
  });
  
  return map;
}

// Always use the absolute path to the true content directories (not site/src/content!)
// This guarantees correct casing on all platforms
const vocabularyDir = path.join(process.cwd(), 'src/generated-content/vocabulary');
const conceptsDir = path.join(process.cwd(), 'src/generated-content/concepts');

const vocabularySlugToOriginal = getOriginalFilenameMap(processedVocabularyEntries, vocabularyDir);
const conceptSlugToOriginal = getOriginalFilenameMap(processedConceptsEntries, conceptsDir);

// Correct assignment: use full relative path (minus .md) for slug generation and lookup
const vocabularyItems: ReferenceItem[] = processedVocabularyEntries.map(entry => {
  const filename = entry.id.replace(/\.md$/, ''); // full relative path, no extension
  const slug = getReferenceSlug(filename, entry.data.slug);
  // ...
});

<!-- site/src/components/markdown/TableOfContents.astro -->
{tocMap && (
  <ul>
    {tocMap.children.map((itemNode, idx) => {
      // First level rendering logic
      return (
        <li class={`toc-depth-1`}>
          {link && <a href={link.url}>{link.children && link.children[0]?.value}</a>}
          {nestedList && (
            <ul>
              {/* Second level rendering logic */}
            </ul>
          )}
        </li>
      );
    })}
  </ul>
)}

.toc-depth-1 {
  font-size: 1.05em;
  font-weight: 500;
  margin-left: 0;
}
.toc-depth-2 {
  font-size: 1em;
  font-weight: 400;
  margin-left: 1.25em;
}

// Use the filename as the fallback title, preserving original casing
// - Replace dashes/underscores with spaces
// - Collapse multiple spaces
// - DO NOT change the case of any letters (e.g., 'API' stays 'API')
title = filename
  .replace(/[-_]/g, ' ')
  .replace(/\s+/g, ' ')
  .trim();

// Type assertion to ensure TypeScript recognizes these as strings
const titleA = (a.data as EssayFrontmatter).title || '';
const titleB = (b.data as EssayFrontmatter).title || '';
return titleA.localeCompare(titleB);