add notion to mdx converter

.gitignore

@@ -11,6 +11,8 @@ build/
 *.egg
 .idea/
 .vscode/
+.astro/
+.claude/
 *.swp
 .DS_Store
 # Node

app/scripts/notion-to-mdx/.cursorignore

@@ -0,0 +1 @@
+.env

app/scripts/notion-to-mdx/.notion-to-md/media/27877f1c-9c9d-804d-9c82-f7b3905578ff_media.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c282e7bcb40ee2caafda422b3614d996d6023dbb4bbe10f96521348ee151aeb0
+size 36969

app/scripts/notion-to-mdx/README.md

@@ -0,0 +1,261 @@
+# Notion to MDX Toolkit
+
+Complete Notion to MDX (Markdown + JSX) conversion optimized for Astro with advanced media handling, interactive components, and seamless integration.
+
+## 🚀 Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Setup environment variables
+cp env.example .env
+# Edit .env with your Notion token
+
+# Complete Notion → MDX conversion with all features
+node index.mjs
+
+# For step-by-step debugging
+node notion-converter.mjs    # Notion → Markdown
+node mdx-converter.mjs       # Markdown → MDX
+```
+
+## 📁 Structure
+
+```
+notion-to-mdx/
+├── index.mjs                    # Complete Notion → MDX pipeline
+├── notion-converter.mjs         # Notion → Markdown with notion-to-md v4
+├── mdx-converter.mjs           # Markdown → MDX with Astro components
+├── post-processor.mjs          # Markdown post-processing
+├── package.json                # Dependencies and scripts
+├── env.example                 # Environment variables template
+├── input/                      # Configuration
+│   └── pages.json             # Notion pages to convert
+└── output/                     # Results
+    ├── *.md                   # Intermediate Markdown
+    ├── *.mdx                  # Final MDX for Astro
+    └── media/                 # Downloaded media files
+```
+
+## ✨ Key Features
+
+### 🎯 **Advanced Media Handling**
+- **Local download**: Automatic download of all Notion media (images, files, PDFs)
+- **Path transformation**: Smart path conversion for web accessibility
+- **Figure components**: Automatic conversion to Astro `Figure` components with zoom/download
+- **Media organization**: Structured media storage by page ID
+
+### 🧮 **Interactive Components**
+- **Callouts → Notes**: Notion callouts converted to Astro `Note` components
+- **Enhanced tables**: Tables wrapped in styled containers
+- **Code blocks**: Enhanced with copy functionality
+- **Automatic imports**: Smart component and image import generation
+
+### 🎨 **Smart Formatting**  
+- **Link fixing**: Notion internal links converted to relative links
+- **Artifact cleanup**: Removal of Notion-specific formatting artifacts
+- **Frontmatter generation**: Automatic YAML frontmatter from Notion properties
+- **Astro compatibility**: Full compatibility with Astro MDX processing
+
+### 🔧 **Robust Pipeline**
+- **Notion preprocessing**: Advanced page configuration and media strategy
+- **Post-processing**: Markdown cleanup and optimization
+- **MDX conversion**: Final transformation with Astro components
+- **Auto-copy**: Automatic copying to Astro content directory
+
+## 📊 Example Workflow
+
+```bash
+# 1. Configure your Notion pages
+# Edit input/pages.json with your page IDs
+
+# 2. Complete automatic conversion
+NOTION_TOKEN=your_token node index.mjs --clean
+
+# 3. Generated results
+ls output/
+# → getting-started.md (Intermediate Markdown)  
+# → getting-started.mdx (Final MDX for Astro)
+# → media/ (downloaded images and files)
+```
+
+### 📋 Conversion Result
+
+The pipeline generates MDX files optimized for Astro with:
+
+```mdx
+---
+title: "Getting Started with Notion"
+published: "2024-01-15"
+tableOfContentsAutoCollapse: true
+---
+
+import Figure from '../components/Figure.astro';
+import Note from '../components/Note.astro';
+import gettingStartedImage from './media/getting-started/image1.png';
+
+## Introduction
+
+Here is some content with a callout:
+
+<Note type="info" title="Important">
+This is a converted Notion callout.
+</Note>
+
+And an image:
+
+<Figure
+  src={gettingStartedImage}
+  alt="Getting started screenshot"
+  zoomable
+  downloadable
+  layout="fixed"
+/>
+```
+
+## ⚙️ Required Astro Configuration
+
+To use the generated MDX files, ensure your Astro project has the required components:
+
+```astro
+// src/components/Figure.astro
+---
+export interface Props {
+  src: any;
+  alt?: string;
+  caption?: string;
+  zoomable?: boolean;
+  downloadable?: boolean;
+  layout?: string;
+  id?: string;
+}
+
+const { src, alt, caption, zoomable, downloadable, layout, id } = Astro.props;
+---
+
+<figure {id} class="figure">
+  <img src={src} alt={alt} />
+  {caption && <figcaption>{caption}</figcaption>}
+</figure>
+```
+
+## 🛠️ Prerequisites
+
+- **Node.js** with ESM support
+- **Notion Integration**: Set up an integration in your Notion workspace
+- **Notion Token**: Copy the "Internal Integration Token"
+- **Shared Pages**: Share the specific Notion page(s) with your integration
+- **Astro** to use the generated MDX
+
+## 🎯 Technical Architecture
+
+### 4-Stage Pipeline
+
+1. **Notion Preprocessing** (`notion-converter.mjs`)
+   - Configuration loading from `pages.json`
+   - Notion API client initialization
+   - Media download strategy configuration
+
+2. **Notion-to-Markdown** (notion-to-md v4)
+   - Page conversion with `NotionConverter`
+   - Media downloading with `downloadMediaTo()`
+   - File export with `DefaultExporter`
+
+3. **Markdown Post-processing** (`post-processor.mjs`)
+   - Notion artifact cleanup
+   - Link fixing and optimization
+   - Table and code block enhancement
+
+4. **MDX Conversion** (`mdx-converter.mjs`)
+   - Component transformation (Figure, Note)
+   - Automatic import generation
+   - Frontmatter enhancement
+   - Astro compatibility optimization
+
+## 📊 Configuration Options
+
+### Pages Configuration (`input/pages.json`)
+
+```json
+{
+  "pages": [
+    {
+      "id": "your-notion-page-id",
+      "title": "Page Title",
+      "slug": "page-slug"
+    }
+  ]
+}
+```
+
+### Environment Variables
+
+Copy `env.example` to `.env` and configure:
+
+```bash
+cp env.example .env
+# Edit .env with your actual Notion token
+```
+
+Required variables:
+```bash
+NOTION_TOKEN=secret_your_notion_integration_token_here
+```
+
+### Command Line Options
+
+```bash
+# Full workflow
+node index.mjs --clean --token=your_token
+
+# Notion to Markdown only
+node index.mjs --notion-only
+
+# Markdown to MDX only  
+node index.mjs --mdx-only
+
+# Custom paths
+node index.mjs --input=my-pages.json --output=converted/
+```
+
+## 📊 Conversion Statistics
+
+For a typical Notion page:
+- **Media files** automatically downloaded and organized
+- **Callouts** converted to interactive Note components
+- **Images** transformed to Figure components with zoom/download
+- **Tables** enhanced with proper styling containers
+- **Code blocks** enhanced with copy functionality
+- **Links** fixed for proper internal navigation
+
+## ✅ Project Status
+
+### 🎉 **Complete Features**
+- ✅ **Notion → MDX Pipeline**: Full end-to-end functional conversion
+- ✅ **Media Management**: Automatic download and path transformation
+- ✅ **Component Integration**: Seamless Astro component integration
+- ✅ **Smart Formatting**: Intelligent cleanup and optimization
+- ✅ **Robustness**: Error handling and graceful degradation
+- ✅ **Flexibility**: Modular pipeline with step-by-step options
+
+### 🚀 **Production Ready**
+The toolkit is now **100% operational** for converting Notion pages to MDX/Astro with all advanced features (media handling, component integration, smart formatting).
+
+## 🔗 Integration with notion-to-md v4
+
+This toolkit leverages the powerful [notion-to-md v4](https://notionconvert.com/docs/v4/guides/) library with:
+
+- **Advanced Media Strategies**: Download, upload, and direct media handling
+- **Custom Renderers**: Block transformers and annotation transformers  
+- **Exporter Plugins**: File, buffer, and stdout output options
+- **Database Support**: Full database property and frontmatter transformation
+- **Page References**: Smart internal link handling
+
+## 📚 Additional Resources
+
+- [notion-to-md v4 Documentation](https://notionconvert.com/docs/v4/guides/)
+- [Notion API Documentation](https://developers.notion.com/)
+- [Astro MDX Documentation](https://docs.astro.build/en/guides/integrations-guide/mdx/)
+- [Media Handling Strategies](https://notionconvert.com/blog/mastering-media-handling-in-notion-to-md-v4-download-upload-and-direct-strategies/)
+- [Frontmatter Transformation](https://notionconvert.com/blog/how-to-convert-notion-properties-to-frontmatter-with-notion-to-md-v4/)

app/scripts/notion-to-mdx/custom-code-renderer.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+/**
+ * Custom Code Block Renderer for notion-to-md
+ * Fixes the issue where code blocks end with "text" instead of proper closing
+ */
+
+export function createCustomCodeRenderer() {
+    return {
+        name: 'custom-code-renderer',
+        type: 'renderer',
+
+        /**
+         * Custom renderer for code blocks
+         * @param {Object} block - Notion code block
+         * @returns {string} - Properly formatted markdown code block
+         */
+        code: (block) => {
+            const { language, rich_text } = block.code;
+
+            // Extract the actual code content from rich_text
+            const codeContent = rich_text
+                .map(text => text.plain_text)
+                .join('');
+
+            // Determine the language (default to empty string if not specified)
+            const lang = language || '';
+
+            // Return properly formatted markdown code block
+            return `\`\`\`${lang}\n${codeContent}\n\`\`\``;
+        }
+    };
+}

app/scripts/notion-to-mdx/debug-properties.mjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+import { config } from 'dotenv';
+import { Client } from '@notionhq/client';
+
+// Load environment variables from .env file
+config();
+
+const notion = new Client({
+    auth: process.env.NOTION_TOKEN,
+});
+
+async function debugPageProperties() {
+    const pageId = '27877f1c9c9d804d9c82f7b3905578ff';
+
+    try {
+        console.log('🔍 Debugging page properties...');
+        console.log(`📄 Page ID: ${pageId}`);
+
+        const page = await notion.pages.retrieve({ page_id: pageId });
+        
+        console.log('\n📋 Available properties:');
+        console.log('========================');
+        
+        for (const [key, value] of Object.entries(page.properties)) {
+            console.log(`\n🔹 ${key}:`);
+            console.log(`   Type: ${value.type}`);
+            
+            switch (value.type) {
+                case 'title':
+                    console.log(`   Value: "${value.title.map(t => t.plain_text).join('')}"`);
+                    break;
+                case 'rich_text':
+                    console.log(`   Value: "${value.rich_text.map(t => t.plain_text).join('')}"`);
+                    break;
+                case 'people':
+                    console.log(`   People: ${value.people.map(p => p.name || p.id).join(', ')}`);
+                    break;
+                case 'select':
+                    console.log(`   Value: ${value.select?.name || 'null'}`);
+                    break;
+                case 'multi_select':
+                    console.log(`   Values: [${value.multi_select.map(s => s.name).join(', ')}]`);
+                    break;
+                case 'date':
+                    console.log(`   Value: ${value.date?.start || 'null'}`);
+                    break;
+                case 'checkbox':
+                    console.log(`   Value: ${value.checkbox}`);
+                    break;
+                case 'url':
+                    console.log(`   Value: ${value.url || 'null'}`);
+                    break;
+                case 'email':
+                    console.log(`   Value: ${value.email || 'null'}`);
+                    break;
+                case 'phone_number':
+                    console.log(`   Value: ${value.phone_number || 'null'}`);
+                    break;
+                case 'number':
+                    console.log(`   Value: ${value.number || 'null'}`);
+                    break;
+                case 'created_time':
+                    console.log(`   Value: ${value.created_time}`);
+                    break;
+                case 'created_by':
+                    console.log(`   Value: ${value.created_by?.id || 'null'}`);
+                    break;
+                case 'last_edited_time':
+                    console.log(`   Value: ${value.last_edited_time}`);
+                    break;
+                case 'last_edited_by':
+                    console.log(`   Value: ${value.last_edited_by?.id || 'null'}`);
+                    break;
+                default:
+                    console.log(`   Value: ${JSON.stringify(value, null, 2)}`);
+            }
+        }
+        
+        console.log('\n✅ Properties debug completed!');
+        
+    } catch (error) {
+        console.error('❌ Error:', error.message);
+    }
+}
+
+debugPageProperties();

app/scripts/notion-to-mdx/env.example

@@ -0,0 +1,72 @@
+# Notion to MDX Toolkit - Environment Variables
+# Copy this file to .env and fill in your actual values
+
+# ===========================================
+# NOTION API CONFIGURATION
+# ===========================================
+
+# Your Notion Integration Token
+# Get this from: https://www.notion.so/my-integrations
+# Format: secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+NOTION_TOKEN=secret_your_notion_integration_token_here
+
+# ===========================================
+# OPTIONAL CONFIGURATION
+# ===========================================
+
+# Custom output directory (optional)
+# Default: ./output
+# OUTPUT_DIR=./my-custom-output
+
+# Custom input configuration file (optional)
+# Default: ./input/pages.json
+# INPUT_CONFIG=./my-pages.json
+
+# ===========================================
+# USAGE EXAMPLES
+# ===========================================
+
+# 1. Basic usage:
+#   NOTION_TOKEN=secret_xxx node index.mjs
+
+# 2. With custom paths:
+#   NOTION_TOKEN=secret_xxx OUTPUT_DIR=./converted node index.mjs
+
+# 3. Test access to a page:
+#   NOTION_TOKEN=secret_xxx node test-access.mjs
+
+# ===========================================
+# SETUP INSTRUCTIONS
+# ===========================================
+
+# 1. Create a Notion integration:
+#    - Go to https://www.notion.so/my-integrations
+#    - Click "New integration"
+#    - Give it a name (e.g., "MDX Converter")
+#    - Select your workspace
+#    - Click "Submit"
+#    - Copy the "Internal Integration Token"
+
+# 2. Share your Notion pages with the integration:
+#    - Open your Notion page
+#    - Click "Share" (top right)
+#    - Click "Invite"
+#    - Search for your integration name
+#    - Select it and give "Can read content" permission
+#    - Click "Invite"
+
+# 3. Configure your pages in input/pages.json:
+#    {
+#      "pages": [
+#        {
+#          "id": "your-notion-page-id",
+#          "title": "Page Title",
+#          "slug": "page-slug"
+#        }
+#      ]
+#    }
+
+# 4. Run the conversion:
+#    cp env.example .env
+#    # Edit .env with your actual token
+#    node index.mjs --clean

app/scripts/notion-to-mdx/index.mjs

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+
+import { config } from 'dotenv';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSync } from 'fs';
+import { convertNotionToMarkdown } from './notion-converter.mjs';
+import { convertToMdx } from './mdx-converter.mjs';
+
+// Load environment variables from .env file
+config();
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Default configuration
+const DEFAULT_INPUT = join(__dirname, 'input', 'pages.json');
+const DEFAULT_OUTPUT = join(__dirname, 'output');
+const ASTRO_CONTENT_PATH = join(__dirname, '..', '..', 'src', 'content', 'article.mdx');
+const ASTRO_ASSETS_PATH = join(__dirname, '..', '..', 'src', 'content', 'assets', 'image');
+const ASTRO_BIB_PATH = join(__dirname, '..', '..', 'src', 'content', 'bibliography.bib');
+
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {
+        input: DEFAULT_INPUT,
+        output: DEFAULT_OUTPUT,
+        clean: false,
+        notionOnly: false,
+        mdxOnly: false,
+        token: process.env.NOTION_TOKEN
+    };
+
+    for (const arg of args) {
+        if (arg.startsWith('--input=')) {
+            config.input = arg.split('=')[1];
+        } else if (arg.startsWith('--output=')) {
+            config.output = arg.split('=')[1];
+        } else if (arg.startsWith('--token=')) {
+            config.token = arg.split('=')[1];
+        } else if (arg === '--clean') {
+            config.clean = true;
+        } else if (arg === '--notion-only') {
+            config.notionOnly = true;
+        } else if (arg === '--mdx-only') {
+            config.mdxOnly = true;
+        }
+    }
+
+    return config;
+}
+
+function showHelp() {
+    console.log(`
+🚀 Notion to MDX Toolkit
+
+Usage:
+  node index.mjs [options]
+
+Options:
+  --input=PATH      Input pages configuration file (default: input/pages.json)
+  --output=PATH     Output directory (default: output/)
+  --token=TOKEN     Notion API token (or set NOTION_TOKEN env var)
+  --clean           Clean output directory before processing
+  --notion-only     Only convert Notion to Markdown (skip MDX conversion)
+  --mdx-only        Only convert existing Markdown to MDX
+  --help, -h        Show this help
+
+Environment Variables:
+  NOTION_TOKEN      Your Notion integration token
+
+Examples:
+  # Full conversion workflow
+  NOTION_TOKEN=your_token node index.mjs --clean
+
+  # Only convert Notion pages to Markdown
+  node index.mjs --notion-only --token=your_token
+
+  # Only convert existing Markdown to MDX
+  node index.mjs --mdx-only
+
+  # Custom paths
+  node index.mjs --input=my-pages.json --output=converted/ --token=your_token
+
+Configuration File Format (pages.json):
+{
+  "pages": [
+    {
+      "id": "your-notion-page-id",
+      "title": "Page Title",
+      "slug": "page-slug"
+    }
+  ]
+}
+
+Workflow:
+  1. Notion → Markdown (with media download)
+  2. Markdown → MDX (with Astro components)
+  3. Copy to Astro content directory
+`);
+}
+
+function ensureDirectory(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+
+async function cleanDirectory(dir) {
+    if (existsSync(dir)) {
+        const { execSync } = await import('child_process');
+        execSync(`rm -rf "${dir}"/*`, { stdio: 'inherit' });
+    }
+}
+
+function readPagesConfig(inputFile) {
+    try {
+        const content = readFileSync(inputFile, 'utf8');
+        return JSON.parse(content);
+    } catch (error) {
+        console.error(`❌ Error reading pages config: ${error.message}`);
+        return { pages: [] };
+    }
+}
+
+function copyToAstroContent(outputDir) {
+    console.log('📋 Copying MDX files to Astro content directory...');
+
+    try {
+        // Ensure Astro directories exist
+        mkdirSync(dirname(ASTRO_CONTENT_PATH), { recursive: true });
+        mkdirSync(ASTRO_ASSETS_PATH, { recursive: true });
+
+        // Copy MDX file
+        const files = readdirSync(outputDir);
+        const mdxFiles = files.filter(file => file.endsWith('.mdx'));
+        if (mdxFiles.length > 0) {
+            const mdxFile = join(outputDir, mdxFiles[0]); // Take the first MDX file
+            copyFileSync(mdxFile, ASTRO_CONTENT_PATH);
+            console.log(`    ✅ Copied MDX to ${ASTRO_CONTENT_PATH}`);
+        }
+
+        // Copy images
+        const mediaDir = join(outputDir, 'media');
+        if (existsSync(mediaDir)) {
+            const imageExtensions = ['.png', '.jpg', '.jpeg', '.gif', '.svg'];
+            let imageCount = 0;
+
+            function copyImagesRecursively(dir) {
+                const files = readdirSync(dir);
+                for (const file of files) {
+                    const filePath = join(dir, file);
+                    const stat = statSync(filePath);
+
+                    if (stat.isDirectory()) {
+                        copyImagesRecursively(filePath);
+                    } else if (imageExtensions.some(ext => file.toLowerCase().endsWith(ext))) {
+                        const filename = basename(filePath);
+                        const destPath = join(ASTRO_ASSETS_PATH, filename);
+                        copyFileSync(filePath, destPath);
+                        imageCount++;
+                    }
+                }
+            }
+
+            copyImagesRecursively(mediaDir);
+            console.log(`    ✅ Copied ${imageCount} image(s) to ${ASTRO_ASSETS_PATH}`);
+
+            // Update image paths in MDX file
+            const mdxContent = readFileSync(ASTRO_CONTENT_PATH, 'utf8');
+            let updatedContent = mdxContent.replace(/\.\/media\//g, './assets/image/');
+            // Remove the subdirectory from image paths since we copy images directly to assets/image/
+            updatedContent = updatedContent.replace(/\.\/assets\/image\/[^\/]+\//g, './assets/image/');
+            writeFileSync(ASTRO_CONTENT_PATH, updatedContent);
+            console.log(`    ✅ Updated image paths in MDX file`);
+        }
+
+        // Create empty bibliography.bib
+        writeFileSync(ASTRO_BIB_PATH, '');
+        console.log(`    ✅ Created empty bibliography at ${ASTRO_BIB_PATH}`);
+
+    } catch (error) {
+        console.warn(`    ⚠️  Failed to copy to Astro: ${error.message}`);
+    }
+}
+
+
+async function main() {
+    const args = process.argv.slice(2);
+
+    if (args.includes('--help') || args.includes('-h')) {
+        showHelp();
+        process.exit(0);
+    }
+
+    const config = parseArgs();
+
+    console.log('🚀 Notion to MDX Toolkit');
+    console.log('========================');
+
+    try {
+        if (config.clean) {
+            console.log('🧹 Cleaning output directory...');
+            await cleanDirectory(config.output);
+        }
+
+        if (config.mdxOnly) {
+            // Only convert existing Markdown to MDX
+            console.log('📝 MDX conversion only mode');
+            await convertToMdx(config.output, config.output);
+            copyToAstroContent(config.output);
+
+        } else if (config.notionOnly) {
+            // Only convert Notion to Markdown
+            console.log('📄 Notion conversion only mode');
+            await convertNotionToMarkdown(config.input, config.output, config.token);
+
+        } else {
+            // Full workflow
+            console.log('🔄 Full conversion workflow');
+
+            // Step 1: Convert Notion to Markdown
+            console.log('\n📄 Step 1: Converting Notion pages to Markdown...');
+            await convertNotionToMarkdown(config.input, config.output, config.token);
+
+            // Step 2: Convert Markdown to MDX with Notion metadata
+            console.log('\n📝 Step 2: Converting Markdown to MDX...');
+            const pagesConfig = readPagesConfig(config.input);
+            const firstPage = pagesConfig.pages && pagesConfig.pages.length > 0 ? pagesConfig.pages[0] : null;
+            const pageId = firstPage ? firstPage.id : null;
+            await convertToMdx(config.output, config.output, pageId, config.token);
+
+            // Step 3: Copy to Astro content directory
+            console.log('\n📋 Step 3: Copying to Astro content directory...');
+            copyToAstroContent(config.output);
+        }
+
+        console.log('\n🎉 Conversion completed successfully!');
+
+    } catch (error) {
+        console.error('❌ Error:', error.message);
+        process.exit(1);
+    }
+}
+
+// Export functions for use as module
+export { convertNotionToMarkdown, convertToMdx };
+
+// Run CLI if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}

app/scripts/notion-to-mdx/input/pages.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2d51fba4ce9b05562f5df611a150e3cd702b487d2e608441318336556e0f248a
+size 188

app/scripts/notion-to-mdx/mdx-converter.mjs

@@ -0,0 +1,551 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'fs';
+import { join, dirname, basename, extname } from 'path';
+import { fileURLToPath } from 'url';
+import matter from 'gray-matter';
+import { extractAndGenerateNotionFrontmatter } from './notion-metadata-extractor.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Configuration
+const DEFAULT_INPUT = join(__dirname, 'output');
+const DEFAULT_OUTPUT = join(__dirname, 'output');
+
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {
+        input: DEFAULT_INPUT,
+        output: DEFAULT_OUTPUT,
+    };
+
+    for (const arg of args) {
+        if (arg.startsWith('--input=')) {
+            config.input = arg.substring('--input='.length);
+        } else if (arg.startsWith('--output=')) {
+            config.output = arg.substring('--output='.length);
+        } else if (arg === '--help' || arg === '-h') {
+            console.log(`
+📝 Notion Markdown to MDX Converter
+
+Usage:
+  node mdx-converter.mjs [options]
+
+Options:
+  --input=PATH     Input directory or file (default: ${DEFAULT_INPUT})
+  --output=PATH    Output directory (default: ${DEFAULT_OUTPUT})
+  --help, -h       Show this help
+
+Examples:
+  # Convert all markdown files in output directory
+  node mdx-converter.mjs
+
+  # Convert specific file
+  node mdx-converter.mjs --input=article.md --output=converted/
+
+  # Convert directory
+  node mdx-converter.mjs --input=markdown-files/ --output=mdx-files/
+            `);
+            process.exit(0);
+        } else if (!config.input) {
+            config.input = arg;
+        } else if (!config.output) {
+            config.output = arg;
+        }
+    }
+    return config;
+}
+
+/**
+ * Track which Astro components are used during transformations
+ */
+const usedComponents = new Set();
+
+/**
+ * Track individual image imports needed
+ */
+const imageImports = new Map(); // src -> varName
+
+/**
+ * Generate a variable name from image path
+ * @param {string} src - Image source path
+ * @returns {string} - Valid variable name
+ */
+function generateImageVarName(src) {
+    // Extract filename without extension and make it a valid JS variable
+    const filename = src.split('/').pop().replace(/\.[^.]+$/, '');
+    return filename.replace(/[^a-zA-Z0-9]/g, '_').replace(/^[0-9]/, 'img_$&');
+}
+
+/**
+ * Add required component imports to the frontmatter
+ * @param {string} content - MDX content
+ * @returns {string} - Content with component imports
+ */
+function addComponentImports(content) {
+    console.log('  📦 Adding component and image imports...');
+
+    let imports = [];
+
+    // Add component imports
+    if (usedComponents.size > 0) {
+        const componentImports = Array.from(usedComponents)
+            .map(component => `import ${component} from '../components/${component}.astro';`);
+        imports.push(...componentImports);
+        console.log(`    ✅ Importing components: ${Array.from(usedComponents).join(', ')}`);
+    }
+
+    // Add image imports
+    if (imageImports.size > 0) {
+        const imageImportStatements = Array.from(imageImports.entries())
+            .map(([src, varName]) => `import ${varName} from '${src}';`);
+        imports.push(...imageImportStatements);
+        console.log(`    ✅ Importing ${imageImports.size} image(s)`);
+    }
+
+    if (imports.length === 0) {
+        console.log('    ℹ️  No imports needed');
+        return content;
+    }
+
+    const importBlock = imports.join('\n');
+
+    // Insert imports after frontmatter
+    const frontmatterEnd = content.indexOf('---', 3) + 3;
+    if (frontmatterEnd > 2) {
+        return content.slice(0, frontmatterEnd) + '\n\n' + importBlock + '\n' + content.slice(frontmatterEnd);
+    } else {
+        // No frontmatter, add at beginning
+        return importBlock + '\n\n' + content;
+    }
+}
+
+/**
+ * Transform Notion images to Figure components
+ * @param {string} content - MDX content
+ * @returns {string} - Content with Figure components
+ */
+function transformImages(content) {
+    console.log('  🖼️  Transforming images to Figure components...');
+
+    let hasImages = false;
+
+    // Helper function to clean source paths
+    const cleanSrcPath = (src) => {
+        // Convert Notion media paths to relative paths
+        return src.replace(/^\/media\//, './media/')
+            .replace(/^\.\/media\//, './media/');
+    };
+
+    // Helper to clean caption text
+    const cleanCaption = (caption) => {
+        return caption
+            .replace(/<[^>]*>/g, '')          // Remove HTML tags
+            .replace(/\n/g, ' ')              // Replace newlines with spaces
+            .replace(/\r/g, ' ')              // Replace carriage returns with spaces
+            .replace(/\s+/g, ' ')             // Replace multiple spaces with single space
+            .replace(/'/g, "\\'")             // Escape quotes
+            .trim();                          // Trim whitespace
+    };
+
+    // Helper to clean alt text
+    const cleanAltText = (alt, maxLength = 100) => {
+        const cleaned = alt
+            .replace(/<[^>]*>/g, '')          // Remove HTML tags
+            .replace(/\n/g, ' ')              // Replace newlines with spaces
+            .replace(/\r/g, ' ')              // Replace carriage returns with spaces
+            .replace(/\s+/g, ' ')             // Replace multiple spaces with single space
+            .trim();                          // Trim whitespace
+
+        return cleaned.length > maxLength
+            ? cleaned.substring(0, maxLength) + '...'
+            : cleaned;
+    };
+
+    // Create Figure component with import
+    const createFigureComponent = (src, alt = '', caption = '') => {
+        const cleanSrc = cleanSrcPath(src);
+
+        // Skip PDF URLs and external URLs - they should remain as links only
+        if (cleanSrc.includes('.pdf') || cleanSrc.includes('arxiv.org/pdf') ||
+            (cleanSrc.startsWith('http') && !cleanSrc.includes('/media/'))) {
+            console.log(`    ⚠️  Skipping external/PDF URL: ${cleanSrc}`);
+            // Return the original markdown image syntax for external URLs
+            return `![${alt}](${src})`;
+        }
+
+        const varName = generateImageVarName(cleanSrc);
+        imageImports.set(cleanSrc, varName);
+        usedComponents.add('Figure');
+
+        const props = [];
+        props.push(`src={${varName}}`);
+        props.push('zoomable');
+        props.push('downloadable');
+        props.push('layout="fixed"');
+        if (alt) props.push(`alt="${alt}"`);
+        if (caption) props.push(`caption={'${caption}'}`);
+
+        return `<Figure\n  ${props.join('\n  ')}\n/>`;
+    };
+
+    // Transform markdown images: ![alt](src)
+    content = content.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (match, alt, src) => {
+        const cleanSrc = cleanSrcPath(src);
+        const cleanAlt = cleanAltText(alt || 'Figure');
+        hasImages = true;
+
+        return createFigureComponent(cleanSrc, cleanAlt);
+    });
+
+    // Transform images with captions (Notion sometimes adds captions as separate text)
+    content = content.replace(/!\[([^\]]*)\]\(([^)]+)\)\s*\n\s*([^\n]+)/g, (match, alt, src, caption) => {
+        const cleanSrc = cleanSrcPath(src);
+        const cleanAlt = cleanAltText(alt || 'Figure');
+        const cleanCap = cleanCaption(caption);
+        hasImages = true;
+
+        return createFigureComponent(cleanSrc, cleanAlt, cleanCap);
+    });
+
+    if (hasImages) {
+        console.log('    ✅ Figure components with imports will be created');
+    }
+
+    return content;
+}
+
+/**
+ * Transform Notion callouts to Note components
+ * @param {string} content - MDX content
+ * @returns {string} - Content with Note components
+ */
+function transformCallouts(content) {
+    console.log('  📝 Transforming callouts to Note components...');
+
+    let transformedCount = 0;
+
+    // Transform blockquotes that look like Notion callouts
+    content = content.replace(/^> \*\*([^*]+)\*\*\s*\n> (.+?)(?=\n> \*\*|\n\n|\n$)/gms, (match, title, content) => {
+        transformedCount++;
+        usedComponents.add('Note');
+
+        const cleanContent = content
+            .replace(/^> /gm, '')  // Remove blockquote markers
+            .replace(/\n+/g, '\n') // Normalize newlines
+            .trim();
+
+        return `<Note type="${title.toLowerCase()}" title="${title}">\n${cleanContent}\n</Note>\n\n`;
+    });
+
+    if (transformedCount > 0) {
+        console.log(`    ✅ Transformed ${transformedCount} callout(s) to Note components`);
+    }
+
+    return content;
+}
+
+/**
+ * Transform Notion databases/tables to enhanced table components
+ * @param {string} content - MDX content
+ * @returns {string} - Content with enhanced tables
+ */
+function transformTables(content) {
+    console.log('  📊 Enhancing tables...');
+
+    let enhancedCount = 0;
+
+    // Wrap tables in a container for better styling
+    content = content.replace(/^(\|[^|\n]+\|[\s\S]*?)(?=\n\n|\n$)/gm, (match) => {
+        if (match.includes('|') && match.split('\n').length > 2) {
+            enhancedCount++;
+            return `<div class="table-container">\n\n${match}\n\n</div>`;
+        }
+        return match;
+    });
+
+    if (enhancedCount > 0) {
+        console.log(`    ✅ Enhanced ${enhancedCount} table(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Transform Notion code blocks to enhanced code components
+ * @param {string} content - MDX content
+ * @returns {string} - Content with enhanced code blocks
+ */
+function transformCodeBlocks(content) {
+    console.log('  💻 Enhancing code blocks...');
+
+    let enhancedCount = 0;
+
+    // Add copy functionality to code blocks
+    content = content.replace(/^```(\w+)\n([\s\S]*?)\n```$/gm, (match, lang, code) => {
+        enhancedCount++;
+        return `\`\`\`${lang} copy\n${code}\n\`\`\``;
+    });
+
+    if (enhancedCount > 0) {
+        console.log(`    ✅ Enhanced ${enhancedCount} code block(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Fix Notion-specific formatting issues
+ * @param {string} content - MDX content
+ * @returns {string} - Content with fixed formatting
+ */
+function fixNotionFormatting(content) {
+    console.log('  🔧 Fixing Notion formatting issues...');
+
+    let fixedCount = 0;
+
+    // Fix Notion's toggle lists that don't convert well
+    content = content.replace(/^(\s*)•\s*(.+)$/gm, (match, indent, text) => {
+        fixedCount++;
+        return `${indent}- ${text}`;
+    });
+
+    // Fix Notion's numbered lists that might have issues
+    content = content.replace(/^(\s*)\d+\.\s*(.+)$/gm, (match, indent, text) => {
+        // Only fix if it's not already properly formatted
+        if (!text.includes('\n') || text.split('\n').length === 1) {
+            return match; // Keep as is
+        }
+        fixedCount++;
+        return `${indent}1. ${text}`;
+    });
+
+    // Fix Notion's bold/italic combinations
+    content = content.replace(/\*\*([^*]+)\*\*([^*]+)\*\*([^*]+)\*\*/g, (match, part1, part2, part3) => {
+        fixedCount++;
+        return `**${part1}${part2}${part3}**`;
+    });
+
+    if (fixedCount > 0) {
+        console.log(`    ✅ Fixed ${fixedCount} formatting issue(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Ensure proper frontmatter for MDX with Notion metadata
+ * @param {string} content - MDX content
+ * @param {string} pageId - Notion page ID (optional)
+ * @param {string} notionToken - Notion API token (optional)
+ * @returns {string} - Content with proper frontmatter
+ */
+async function ensureFrontmatter(content, pageId = null, notionToken = null) {
+    console.log('  📄 Ensuring proper frontmatter...');
+
+    if (!content.startsWith('---')) {
+        let frontmatter;
+
+        if (pageId && notionToken) {
+            try {
+                console.log('    🔍 Extracting Notion metadata...');
+                frontmatter = await extractAndGenerateNotionFrontmatter(pageId, notionToken);
+                console.log('    ✅ Generated rich frontmatter from Notion');
+            } catch (error) {
+                console.log('    ⚠️  Failed to extract Notion metadata, using basic frontmatter');
+                frontmatter = generateBasicFrontmatter();
+            }
+        } else {
+            frontmatter = generateBasicFrontmatter();
+            console.log('    ✅ Generated basic frontmatter');
+        }
+
+        return frontmatter + content;
+    }
+
+    // Parse existing frontmatter and enhance it
+    try {
+        const { data, content: body } = matter(content);
+
+        // If we have Notion metadata available, try to enhance the frontmatter
+        if (pageId && notionToken && (!data.notion_id || data.notion_id !== pageId)) {
+            try {
+                console.log('    🔍 Enhancing frontmatter with Notion metadata...');
+                const notionFrontmatter = await extractAndGenerateNotionFrontmatter(pageId, notionToken);
+                const { data: notionData } = matter(notionFrontmatter);
+
+                // Merge Notion metadata with existing frontmatter
+                const enhancedData = { ...data, ...notionData };
+                const enhancedContent = matter.stringify(body, enhancedData);
+                console.log('    ✅ Enhanced frontmatter with Notion metadata');
+                return enhancedContent;
+            } catch (error) {
+                console.log('    ⚠️  Could not enhance with Notion metadata, keeping existing');
+            }
+        }
+
+        // Ensure required fields
+        if (!data.title) data.title = 'Notion Article';
+        if (!data.published) data.published = new Date().toISOString().split('T')[0];
+        if (!data.tableOfContentsAutoCollapse) data.tableOfContentsAutoCollapse = true;
+
+        const enhancedContent = matter.stringify(body, data);
+        console.log('    ✅ Enhanced existing frontmatter');
+        return enhancedContent;
+    } catch (error) {
+        console.log('    ⚠️  Could not parse frontmatter, keeping as is');
+        return content;
+    }
+}
+
+/**
+ * Generate basic frontmatter
+ * @returns {string} - Basic frontmatter
+ */
+function generateBasicFrontmatter() {
+    const currentDate = new Date().toLocaleDateString('en-US', {
+        year: 'numeric',
+        month: 'short',
+        day: '2-digit'
+    });
+    return `---
+title: "Notion Article"
+published: "${currentDate}"
+tableOfContentsAutoCollapse: true
+---
+
+`;
+}
+
+/**
+ * Main MDX processing function that applies all transformations
+ * @param {string} content - Raw Markdown content
+ * @param {string} pageId - Notion page ID (optional)
+ * @param {string} notionToken - Notion API token (optional)
+ * @returns {string} - Processed MDX content compatible with Astro
+ */
+async function processMdxContent(content, pageId = null, notionToken = null) {
+    console.log('🔧 Processing for Astro MDX compatibility...');
+
+    // Clear previous tracking
+    usedComponents.clear();
+    imageImports.clear();
+
+    let processedContent = content;
+
+    // Apply each transformation step sequentially
+    processedContent = await ensureFrontmatter(processedContent, pageId, notionToken);
+    processedContent = fixNotionFormatting(processedContent);
+    processedContent = transformCallouts(processedContent);
+    processedContent = transformImages(processedContent);
+    processedContent = transformTables(processedContent);
+    processedContent = transformCodeBlocks(processedContent);
+
+    // Add component imports at the end
+    processedContent = addComponentImports(processedContent);
+
+    return processedContent;
+}
+
+/**
+ * Convert a single markdown file to MDX
+ * @param {string} inputFile - Input markdown file
+ * @param {string} outputDir - Output directory
+ * @param {string} pageId - Notion page ID (optional)
+ * @param {string} notionToken - Notion API token (optional)
+ */
+async function convertFileToMdx(inputFile, outputDir, pageId = null, notionToken = null) {
+    const filename = basename(inputFile, '.md');
+    const outputFile = join(outputDir, `${filename}.mdx`);
+
+    console.log(`📝 Converting: ${basename(inputFile)} → ${basename(outputFile)}`);
+
+    try {
+        const markdownContent = readFileSync(inputFile, 'utf8');
+        const mdxContent = await processMdxContent(markdownContent, pageId, notionToken);
+        writeFileSync(outputFile, mdxContent);
+
+        console.log(`    ✅ Converted: ${outputFile}`);
+
+        // Show file size
+        const inputSize = Math.round(markdownContent.length / 1024);
+        const outputSize = Math.round(mdxContent.length / 1024);
+        console.log(`    📊 Input: ${inputSize}KB → Output: ${outputSize}KB`);
+
+    } catch (error) {
+        console.error(`    ❌ Failed to convert ${inputFile}: ${error.message}`);
+    }
+}
+
+/**
+ * Convert all markdown files in a directory to MDX
+ * @param {string} inputPath - Input path (file or directory)
+ * @param {string} outputDir - Output directory
+ * @param {string} pageId - Notion page ID (optional)
+ * @param {string} notionToken - Notion API token (optional)
+ */
+async function convertToMdx(inputPath, outputDir, pageId = null, notionToken = null) {
+    console.log('📝 Notion Markdown to Astro MDX Converter');
+    console.log(`📁 Input:  ${inputPath}`);
+    console.log(`📁 Output: ${outputDir}`);
+
+    // Check if input exists
+    if (!existsSync(inputPath)) {
+        console.error(`❌ Input not found: ${inputPath}`);
+        process.exit(1);
+    }
+
+    try {
+        // Ensure output directory exists
+        if (!existsSync(outputDir)) {
+            mkdirSync(outputDir, { recursive: true });
+        }
+
+        let filesToConvert = [];
+
+        if (statSync(inputPath).isDirectory()) {
+            // Convert all .md files in directory
+            const files = readdirSync(inputPath);
+            filesToConvert = files
+                .filter(file => file.endsWith('.md'))
+                .map(file => join(inputPath, file));
+        } else if (inputPath.endsWith('.md')) {
+            // Convert single file
+            filesToConvert = [inputPath];
+        } else {
+            console.error('❌ Input must be a .md file or directory containing .md files');
+            process.exit(1);
+        }
+
+        if (filesToConvert.length === 0) {
+            console.log('ℹ️  No .md files found to convert');
+            return;
+        }
+
+        console.log(`🔄 Found ${filesToConvert.length} file(s) to convert`);
+
+        // Convert each file
+        for (const file of filesToConvert) {
+            await convertFileToMdx(file, outputDir, pageId, notionToken);
+        }
+
+        console.log(`✅ Conversion completed! ${filesToConvert.length} file(s) processed`);
+
+    } catch (error) {
+        console.error('❌ Conversion failed:', error.message);
+        process.exit(1);
+    }
+}
+
+export { convertToMdx };
+
+function main() {
+    const config = parseArgs();
+    convertToMdx(config.input, config.output);
+    console.log('🎉 MDX conversion completed!');
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}

app/scripts/notion-to-mdx/notion-converter.mjs

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+
+import { config } from 'dotenv';
+import { Client } from '@notionhq/client';
+import { NotionConverter } from 'notion-to-md';
+import { DefaultExporter } from 'notion-to-md/plugins/exporter';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { postProcessMarkdown } from './post-processor.mjs';
+import { createCustomCodeRenderer } from './custom-code-renderer.mjs';
+
+// Load environment variables from .env file
+config();
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Configuration
+const DEFAULT_INPUT = join(__dirname, 'input', 'pages.json');
+const DEFAULT_OUTPUT = join(__dirname, 'output');
+
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {
+        input: DEFAULT_INPUT,
+        output: DEFAULT_OUTPUT,
+        clean: false,
+        token: process.env.NOTION_TOKEN
+    };
+
+    for (const arg of args) {
+        if (arg.startsWith('--input=')) {
+            config.input = arg.split('=')[1];
+        } else if (arg.startsWith('--output=')) {
+            config.output = arg.split('=')[1];
+        } else if (arg.startsWith('--token=')) {
+            config.token = arg.split('=')[1];
+        } else if (arg === '--clean') {
+            config.clean = true;
+        }
+    }
+
+    return config;
+}
+
+function ensureDirectory(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+
+function loadPagesConfig(configFile) {
+    if (!existsSync(configFile)) {
+        console.error(`❌ Configuration file not found: ${configFile}`);
+        console.log('📝 Create a pages.json file with your Notion page IDs:');
+        console.log(`
+{
+  "pages": [
+    {
+      "id": "your-notion-page-id-1",
+      "title": "Page Title 1",
+      "slug": "page-1"
+    },
+    {
+      "id": "your-notion-page-id-2", 
+      "title": "Page Title 2",
+      "slug": "page-2"
+    }
+  ]
+}
+        `);
+        process.exit(1);
+    }
+
+    try {
+        const config = JSON.parse(readFileSync(configFile, 'utf8'));
+        return config.pages || [];
+    } catch (error) {
+        console.error(`❌ Error reading configuration: ${error.message}`);
+        process.exit(1);
+    }
+}
+
+/**
+ * Convert a single Notion page to Markdown with advanced media handling
+ * @param {Object} notion - Notion client
+ * @param {string} pageId - Notion page ID
+ * @param {string} outputDir - Output directory
+ * @param {string} pageTitle - Page title for file naming
+ * @returns {Promise<string>} - Path to generated markdown file
+ */
+async function convertNotionPage(notion, pageId, outputDir, pageTitle) {
+    console.log(`📄 Converting Notion page: ${pageTitle} (${pageId})`);
+
+    try {
+        // Create media directory for this page
+        const mediaDir = join(outputDir, 'media', pageId);
+        ensureDirectory(mediaDir);
+
+        // Configure the DefaultExporter to save to a file
+        const outputFile = join(outputDir, `${pageTitle}.md`);
+        const exporter = new DefaultExporter({
+            outputType: 'file',
+            outputPath: outputFile,
+        });
+
+        // Create the converter with media downloading strategy
+        const n2m = new NotionConverter(notion)
+            .withExporter(exporter)
+            // Download media to local directory with path transformation
+            .downloadMediaTo({
+                outputDir: mediaDir,
+                // Transform paths to be web-accessible
+                transformPath: (localPath) => `/media/${pageId}/${basename(localPath)}`,
+            });
+
+        // Convert the page
+        const result = await n2m.convert(pageId);
+
+        console.log(`    ✅ Converted to: ${outputFile}`);
+        console.log(`    📊 Content length: ${result.content.length} characters`);
+        console.log(`    🖼️  Media saved to: ${mediaDir}`);
+
+        return outputFile;
+
+    } catch (error) {
+        console.error(`    ❌ Failed to convert page ${pageId}: ${error.message}`);
+        throw error;
+    }
+}
+
+/**
+ * Process Notion pages with advanced configuration
+ * @param {string} inputFile - Path to pages configuration
+ * @param {string} outputDir - Output directory
+ * @param {string} notionToken - Notion API token
+ */
+export async function convertNotionToMarkdown(inputFile, outputDir, notionToken) {
+    console.log('🚀 Notion to Markdown Converter');
+    console.log(`📁 Input:  ${inputFile}`);
+    console.log(`📁 Output: ${outputDir}`);
+
+    // Validate Notion token
+    if (!notionToken) {
+        console.error('❌ NOTION_TOKEN not found. Please set it as environment variable or use --token=YOUR_TOKEN');
+        process.exit(1);
+    }
+
+    // Ensure output directory exists
+    ensureDirectory(outputDir);
+
+    try {
+        // Initialize Notion client
+        const notion = new Client({
+            auth: notionToken,
+        });
+
+        // Load pages configuration
+        const pages = loadPagesConfig(inputFile);
+        console.log(`📋 Found ${pages.length} page(s) to convert`);
+
+        const convertedFiles = [];
+
+        // Convert each page
+        for (const page of pages) {
+            try {
+                const outputFile = await convertNotionPage(
+                    notion,
+                    page.id,
+                    outputDir,
+                    page.slug || page.title?.toLowerCase().replace(/\s+/g, '-') || page.id
+                );
+                convertedFiles.push(outputFile);
+            } catch (error) {
+                console.error(`❌ Failed to convert page ${page.id}: ${error.message}`);
+                // Continue with other pages
+            }
+        }
+
+        // Post-process all converted files
+        console.log('🔧 Post-processing converted files...');
+        for (const file of convertedFiles) {
+            try {
+                let content = readFileSync(file, 'utf8');
+                content = postProcessMarkdown(content);
+                writeFileSync(file, content);
+                console.log(`    ✅ Post-processed: ${basename(file)}`);
+            } catch (error) {
+                console.error(`    ❌ Failed to post-process ${file}: ${error.message}`);
+            }
+        }
+
+        console.log(`✅ Conversion completed! ${convertedFiles.length} file(s) generated`);
+
+    } catch (error) {
+        console.error('❌ Conversion failed:', error.message);
+        process.exit(1);
+    }
+}
+
+function main() {
+    const config = parseArgs();
+
+    if (config.clean) {
+        console.log('🧹 Cleaning output directory...');
+        // Clean output directory logic would go here
+    }
+
+    convertNotionToMarkdown(config.input, config.output, config.token);
+    console.log('🎉 Notion conversion completed!');
+}
+
+// Show help if requested
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+🚀 Notion to Markdown Converter
+
+Usage:
+  node notion-converter.mjs [options]
+
+Options:
+  --input=PATH     Input pages configuration file (default: input/pages.json)
+  --output=PATH    Output directory (default: output/)
+  --token=TOKEN    Notion API token (or set NOTION_TOKEN env var)
+  --clean          Clean output directory before conversion
+  --help, -h       Show this help
+
+Environment Variables:
+  NOTION_TOKEN     Your Notion integration token
+
+Examples:
+  # Basic conversion with environment token
+  NOTION_TOKEN=your_token node notion-converter.mjs
+
+  # Custom paths and token
+  node notion-converter.mjs --input=my-pages.json --output=converted/ --token=your_token
+
+  # Clean output first
+  node notion-converter.mjs --clean
+
+Configuration File Format (pages.json):
+{
+  "pages": [
+    {
+      "id": "your-notion-page-id",
+      "title": "Page Title",
+      "slug": "page-slug"
+    }
+  ]
+}
+`);
+    process.exit(0);
+}
+
+// Run CLI if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}

app/scripts/notion-to-mdx/notion-metadata-extractor.mjs

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+
+import { Client } from '@notionhq/client';
+
+/**
+ * Notion Metadata Extractor
+ * Extracts document metadata from Notion pages for frontmatter generation
+ */
+
+/**
+ * Extract metadata from Notion page
+ * @param {string} pageId - Notion page ID
+ * @param {string} notionToken - Notion API token
+ * @returns {object} - Extracted metadata object
+ */
+export async function extractNotionMetadata(pageId, notionToken) {
+    const notion = new Client({
+        auth: notionToken,
+    });
+
+    const metadata = {};
+
+    try {
+        // Get page information
+        const page = await notion.pages.retrieve({ page_id: pageId });
+
+        // Extract title from page properties
+        if (page.properties.title && page.properties.title.title && page.properties.title.title.length > 0) {
+            metadata.title = page.properties.title.title[0].plain_text;
+        }
+
+        // Extract creation date
+        if (page.created_time) {
+            metadata.published = new Date(page.created_time).toLocaleDateString('en-US', {
+                year: 'numeric',
+                month: 'short',
+                day: '2-digit'
+            });
+            metadata.created_time = page.created_time;
+        }
+
+        // Extract last edited date
+        if (page.last_edited_time) {
+            metadata.last_edited_time = page.last_edited_time;
+        }
+
+        // Extract created by
+        if (page.created_by && page.created_by.id) {
+            metadata.created_by = page.created_by.id;
+        }
+
+        // Extract last edited by
+        if (page.last_edited_by && page.last_edited_by.id) {
+            metadata.last_edited_by = page.last_edited_by.id;
+        }
+
+        // Extract page URL
+        metadata.notion_url = page.url;
+
+        // Extract page ID
+        metadata.notion_id = page.id;
+
+        // Extract parent information
+        if (page.parent) {
+            metadata.parent = {
+                type: page.parent.type,
+                id: page.parent[page.parent.type]?.id || page.parent[page.parent.type]
+            };
+        }
+
+        // Extract cover image if available
+        if (page.cover) {
+            metadata.cover = {
+                type: page.cover.type,
+                url: page.cover[page.cover.type]?.url || page.cover[page.cover.type]
+            };
+        }
+
+        // Extract icon if available
+        if (page.icon) {
+            metadata.icon = {
+                type: page.icon.type,
+                emoji: page.icon.emoji,
+                url: page.icon.external?.url || page.icon.file?.url
+            };
+        }
+
+        // Extract authors and custom properties
+        const customProperties = {};
+        for (const [key, value] of Object.entries(page.properties)) {
+            if (key !== 'title') { // Skip title as it's handled separately
+                const extractedValue = extractPropertyValue(value);
+
+                // Check for author-related properties
+                if (key.toLowerCase().includes('author') ||
+                    key.toLowerCase().includes('writer') ||
+                    key.toLowerCase().includes('creator') ||
+                    value.type === 'people') {
+                    metadata.authors = extractedValue;
+                } else {
+                    customProperties[key] = extractedValue;
+                }
+            }
+        }
+
+        // If no authors found in properties, try to get from created_by
+        if (!metadata.authors && page.created_by) {
+            try {
+                const user = await notion.users.retrieve({ user_id: page.created_by.id });
+                metadata.authors = [{
+                    name: user.name || user.id,
+                    id: user.id
+                }];
+            } catch (error) {
+                console.log('    ⚠️  Could not fetch author from created_by:', error.message);
+                // Fallback to basic info
+                metadata.authors = [{
+                    name: page.created_by.name || page.created_by.id,
+                    id: page.created_by.id
+                }];
+            }
+        }
+
+        if (Object.keys(customProperties).length > 0) {
+            metadata.properties = customProperties;
+        }
+
+        // Try to extract description from page content (first paragraph)
+        try {
+            const blocks = await notion.blocks.children.list({ block_id: pageId });
+            const firstParagraph = blocks.results.find(block =>
+                block.type === 'paragraph' &&
+                block.paragraph.rich_text &&
+                block.paragraph.rich_text.length > 0
+            );
+
+            if (firstParagraph) {
+                const description = firstParagraph.paragraph.rich_text
+                    .map(text => text.plain_text)
+                    .join('')
+                    .trim();
+
+                if (description && description.length > 0) {
+                    metadata.description = description.substring(0, 200) + (description.length > 200 ? '...' : '');
+                }
+            }
+        } catch (error) {
+            console.log('  ⚠️  Could not extract description from page content');
+        }
+
+        // Generate tags from page properties
+        const tags = [];
+        for (const [key, value] of Object.entries(page.properties)) {
+            if (value.type === 'multi_select' && value.multi_select) {
+                value.multi_select.forEach(option => {
+                    tags.push(option.name);
+                });
+            } else if (value.type === 'select' && value.select) {
+                tags.push(value.select.name);
+            }
+        }
+
+        if (tags.length > 0) {
+            metadata.tags = tags;
+        }
+
+    } catch (error) {
+        console.error('Error extracting Notion metadata:', error.message);
+        // Return basic metadata if extraction fails
+        metadata.title = "Notion Article";
+        metadata.published = new Date().toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: 'short',
+            day: '2-digit'
+        });
+    }
+
+    return metadata;
+}
+
+/**
+ * Extract value from Notion property
+ * @param {object} property - Notion property object
+ * @returns {any} - Extracted value
+ */
+function extractPropertyValue(property) {
+    switch (property.type) {
+        case 'rich_text':
+            return property.rich_text.map(text => text.plain_text).join('');
+        case 'title':
+            return property.title.map(text => text.plain_text).join('');
+        case 'number':
+            return property.number;
+        case 'select':
+            return property.select?.name || null;
+        case 'multi_select':
+            return property.multi_select.map(option => option.name);
+        case 'date':
+            return property.date?.start || null;
+        case 'checkbox':
+            return property.checkbox;
+        case 'url':
+            return property.url;
+        case 'email':
+            return property.email;
+        case 'phone_number':
+            return property.phone_number;
+        case 'created_time':
+            return property.created_time;
+        case 'created_by':
+            return property.created_by?.id || null;
+        case 'last_edited_time':
+            return property.last_edited_time;
+        case 'last_edited_by':
+            return property.last_edited_by?.id || null;
+        case 'people':
+            return property.people.map(person => ({
+                name: person.name || person.id,
+                id: person.id
+            }));
+        default:
+            return null;
+    }
+}
+
+/**
+ * Generate YAML frontmatter from metadata object
+ * @param {object} metadata - Metadata object
+ * @returns {string} - YAML frontmatter string
+ */
+export function generateNotionFrontmatter(metadata) {
+    let frontmatter = '---\n';
+
+    // Title
+    if (metadata.title) {
+        frontmatter += `title: "${metadata.title}"\n`;
+    }
+
+    // Description
+    if (metadata.description) {
+        frontmatter += `description: "${metadata.description}"\n`;
+    }
+
+    // Publication date
+    if (metadata.published) {
+        frontmatter += `published: "${metadata.published}"\n`;
+    }
+
+    // Authors
+    if (metadata.authors && metadata.authors.length > 0) {
+        frontmatter += 'authors:\n';
+        metadata.authors.forEach(author => {
+            if (typeof author === 'string') {
+                frontmatter += `  - name: "${author}"\n`;
+            } else if (author.name) {
+                frontmatter += `  - name: "${author.name}"\n`;
+            }
+        });
+    }
+
+    // Tags
+    if (metadata.tags && metadata.tags.length > 0) {
+        frontmatter += 'tags:\n';
+        metadata.tags.forEach(tag => {
+            frontmatter += `  - "${tag}"\n`;
+        });
+    }
+
+    // Notion metadata removed - keeping only standard frontmatter fields
+
+    // Cover image
+    if (metadata.cover && metadata.cover.url) {
+        frontmatter += `cover: "${metadata.cover.url}"\n`;
+    }
+
+    // Icon
+    if (metadata.icon) {
+        if (metadata.icon.emoji) {
+            frontmatter += `icon: "${metadata.icon.emoji}"\n`;
+        } else if (metadata.icon.url) {
+            frontmatter += `icon: "${metadata.icon.url}"\n`;
+        }
+    }
+
+    // Custom properties removed - keeping frontmatter clean and standard
+
+    // Default Astro configuration
+    frontmatter += 'tableOfContentsAutoCollapse: true\n';
+    frontmatter += '---\n\n';
+
+    return frontmatter;
+}
+
+/**
+ * Extract and generate frontmatter from Notion page
+ * @param {string} pageId - Notion page ID
+ * @param {string} notionToken - Notion API token
+ * @returns {string} - Complete YAML frontmatter
+ */
+export async function extractAndGenerateNotionFrontmatter(pageId, notionToken) {
+    const metadata = await extractNotionMetadata(pageId, notionToken);
+    return generateNotionFrontmatter(metadata);
+}

app/scripts/notion-to-mdx/post-processor.mjs

@@ -0,0 +1,369 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * Post-process Notion-generated Markdown for better MDX compatibility
+ * @param {string} content - Raw markdown content from Notion
+ * @returns {string} - Processed markdown content
+ */
+export function postProcessMarkdown(content) {
+    console.log('🔧 Post-processing Notion Markdown for MDX compatibility...');
+
+    let processedContent = content;
+
+    // Apply each transformation step
+    processedContent = cleanNotionArtifacts(processedContent);
+    processedContent = fixNotionLinks(processedContent);
+    processedContent = optimizeImages(processedContent);
+    processedContent = shiftHeadingLevels(processedContent);
+    processedContent = cleanEmptyLines(processedContent);
+    processedContent = fixCodeBlocks(processedContent);
+    processedContent = fixCodeBlockEndings(processedContent);
+    processedContent = optimizeTables(processedContent);
+
+    return processedContent;
+}
+
+/**
+ * Clean Notion-specific artifacts and formatting
+ * @param {string} content - Markdown content
+ * @returns {string} - Cleaned content
+ */
+function cleanNotionArtifacts(content) {
+    console.log('  🧹 Cleaning Notion artifacts...');
+
+    let cleanedCount = 0;
+
+    // Remove Notion's internal page references that don't convert well
+    content = content.replace(/\[([^\]]+)\]\(https:\/\/www\.notion\.so\/[^)]+\)/g, (match, text) => {
+        cleanedCount++;
+        return text; // Keep just the text, remove the broken link
+    });
+
+    // Clean up Notion's callout blocks that might not render properly
+    content = content.replace(/^> \*\*([^*]+)\*\*\s*\n/gm, '> **$1**\n\n');
+
+    // Remove Notion's page dividers that don't have markdown equivalents
+    content = content.replace(/^---+\s*$/gm, '');
+
+    // Clean up empty blockquotes
+    content = content.replace(/^>\s*$/gm, '');
+
+    if (cleanedCount > 0) {
+        console.log(`    ✅ Cleaned ${cleanedCount} Notion artifact(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Fix Notion internal links to be more MDX-friendly
+ * @param {string} content - Markdown content
+ * @returns {string} - Content with fixed links
+ */
+function fixNotionLinks(content) {
+    console.log('  🔗 Fixing Notion internal links...');
+
+    let fixedCount = 0;
+
+    // Convert Notion page links to relative links (assuming they'll be converted to MDX)
+    content = content.replace(/\[([^\]]+)\]\(https:\/\/www\.notion\.so\/[^/]+\/([^?#)]+)\)/g, (match, text, pageId) => {
+        fixedCount++;
+        // Convert to relative link - this will need to be updated based on your routing
+        return `[${text}](#${pageId})`;
+    });
+
+    // Fix broken notion.so links that might be malformed
+    content = content.replace(/\[([^\]]+)\]\(https:\/\/www\.notion\.so\/[^)]*\)/g, (match, text) => {
+        fixedCount++;
+        return text; // Remove broken links, keep text
+    });
+
+    if (fixedCount > 0) {
+        console.log(`    ✅ Fixed ${fixedCount} Notion link(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Optimize images for better MDX compatibility
+ * @param {string} content - Markdown content
+ * @returns {string} - Content with optimized images
+ */
+function optimizeImages(content) {
+    console.log('  🖼️  Optimizing images...');
+
+    let optimizedCount = 0;
+
+    // Ensure images have proper alt text
+    content = content.replace(/!\[\]\(([^)]+)\)/g, (match, src) => {
+        optimizedCount++;
+        const filename = basename(src);
+        return `![${filename}](${src})`;
+    });
+
+    // Clean up image paths that might have query parameters
+    content = content.replace(/!\[([^\]]*)\]\(([^)]+)\?[^)]*\)/g, (match, alt, src) => {
+        optimizedCount++;
+        return `![${alt}](${src})`;
+    });
+
+    if (optimizedCount > 0) {
+        console.log(`    ✅ Optimized ${optimizedCount} image(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Shift all heading levels down by one (H1 → H2, H2 → H3, etc.)
+ * @param {string} content - Markdown content
+ * @returns {string} - Content with shifted heading levels
+ */
+function shiftHeadingLevels(content) {
+    console.log('  📝 Shifting heading levels down by one...');
+
+    let shiftedCount = 0;
+
+    // Shift heading levels: H1 → H2, H2 → H3, H3 → H4, H4 → H5, H5 → H6
+    // Process from highest to lowest to avoid conflicts
+    content = content.replace(/^##### (.*$)/gim, '###### $1');
+    content = content.replace(/^#### (.*$)/gim, '##### $1');
+    content = content.replace(/^### (.*$)/gim, '#### $1');
+    content = content.replace(/^## (.*$)/gim, '### $1');
+    content = content.replace(/^# (.*$)/gim, '## $1');
+
+    // Count the number of headings shifted
+    const headingMatches = content.match(/^#{1,6} /gm);
+    if (headingMatches) {
+        shiftedCount = headingMatches.length;
+    }
+
+    console.log(`    ✅ Shifted ${shiftedCount} heading level(s)`);
+    return content;
+}
+
+/**
+ * Fix code block endings that end with "text" instead of proper closing
+ * @param {string} content - Markdown content
+ * @returns {string} - Content with fixed code block endings
+ */
+function fixCodeBlockEndings(content) {
+    console.log('  💻 Fixing code block endings...');
+
+    let fixedCount = 0;
+
+    // Fix code blocks that end with ```text instead of ```
+    content = content.replace(/```text\n/g, '```\n');
+
+    // Count the number of fixes
+    const textEndingMatches = content.match(/```text\n/g);
+    if (textEndingMatches) {
+        fixedCount = textEndingMatches.length;
+    }
+
+    if (fixedCount > 0) {
+        console.log(`    ✅ Fixed ${fixedCount} code block ending(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Clean up excessive empty lines
+ * @param {string} content - Markdown content
+ * @returns {string} - Content with cleaned spacing
+ */
+function cleanEmptyLines(content) {
+    console.log('  📝 Cleaning excessive empty lines...');
+
+    // Replace 3+ consecutive newlines with 2 newlines
+    const cleanedContent = content.replace(/\n{3,}/g, '\n\n');
+
+    const originalLines = content.split('\n').length;
+    const cleanedLines = cleanedContent.split('\n').length;
+    const removedLines = originalLines - cleanedLines;
+
+    if (removedLines > 0) {
+        console.log(`    ✅ Removed ${removedLines} excessive empty line(s)`);
+    }
+
+    return cleanedContent;
+}
+
+/**
+ * Fix code blocks for better MDX compatibility
+ * @param {string} content - Markdown content
+ * @returns {string} - Content with fixed code blocks
+ */
+function fixCodeBlocks(content) {
+    console.log('  💻 Fixing code blocks...');
+
+    let fixedCount = 0;
+
+    // Ensure code blocks have proper language identifiers
+    content = content.replace(/^```\s*$/gm, '```text');
+
+    // Fix code blocks that might have Notion-specific formatting
+    content = content.replace(/^```(\w+)\s*\n([\s\S]*?)\n```$/gm, (match, lang, code) => {
+        // Clean up any Notion artifacts in code
+        const cleanCode = code.replace(/\u00A0/g, ' '); // Replace non-breaking spaces
+        return `\`\`\`${lang}\n${cleanCode}\n\`\`\``;
+    });
+
+    if (fixedCount > 0) {
+        console.log(`    ✅ Fixed ${fixedCount} code block(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Optimize tables for better MDX rendering
+ * @param {string} content - Markdown content
+ * @returns {string} - Content with optimized tables
+ */
+function optimizeTables(content) {
+    console.log('  📊 Optimizing tables...');
+
+    let optimizedCount = 0;
+
+    // Fix tables that might have inconsistent column counts
+    content = content.replace(/^\|(.+)\|\s*$/gm, (match, row) => {
+        const cells = row.split('|').map(cell => cell.trim());
+        const cleanCells = cells.filter(cell => cell.length > 0);
+
+        if (cleanCells.length > 0) {
+            optimizedCount++;
+            return `| ${cleanCells.join(' | ')} |`;
+        }
+        return match;
+    });
+
+    // Ensure table headers are properly formatted
+    content = content.replace(/^\|(.+)\|\s*\n\|([-:\s|]+)\|\s*$/gm, (match, header, separator) => {
+        const headerCells = header.split('|').map(cell => cell.trim()).filter(cell => cell.length > 0);
+        const separatorCells = separator.split('|').map(cell => cell.trim()).filter(cell => cell.length > 0);
+
+        if (headerCells.length !== separatorCells.length) {
+            optimizedCount++;
+            const newSeparator = headerCells.map(() => '---').join(' | ');
+            return `| ${headerCells.join(' | ')} |\n| ${newSeparator} |`;
+        }
+        return match;
+    });
+
+    if (optimizedCount > 0) {
+        console.log(`    ✅ Optimized ${optimizedCount} table(s)`);
+    }
+
+    return content;
+}
+
+/**
+ * Extract frontmatter from Notion page properties
+ * @param {Object} pageProperties - Notion page properties
+ * @returns {string} - YAML frontmatter
+ */
+export function generateFrontmatter(pageProperties) {
+    console.log('  📄 Generating frontmatter from Notion properties...');
+
+    const frontmatter = {
+        title: pageProperties.title || 'Untitled',
+        published: new Date().toISOString().split('T')[0],
+        tableOfContentsAutoCollapse: true
+    };
+
+    // Add other properties if they exist
+    if (pageProperties.description) {
+        frontmatter.description = pageProperties.description;
+    }
+    if (pageProperties.tags) {
+        frontmatter.tags = pageProperties.tags;
+    }
+    if (pageProperties.author) {
+        frontmatter.author = pageProperties.author;
+    }
+
+    // Convert to YAML string
+    const yamlLines = Object.entries(frontmatter)
+        .map(([key, value]) => {
+            if (Array.isArray(value)) {
+                return `${key}:\n${value.map(v => `  - ${v}`).join('\n')}`;
+            }
+            return `${key}: "${value}"`;
+        });
+
+    return `---\n${yamlLines.join('\n')}\n---\n\n`;
+}
+
+function main() {
+    const args = process.argv.slice(2);
+
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+🔧 Notion Markdown Post-Processor
+
+Usage:
+  node post-processor.mjs [options] [input-file] [output-file]
+
+Options:
+  --verbose        Show detailed processing information
+  --help, -h       Show this help
+
+Examples:
+  # Process a single file
+  node post-processor.mjs input.md output.md
+
+  # Process with verbose output
+  node post-processor.mjs --verbose input.md output.md
+`);
+        process.exit(0);
+    }
+
+    const verbose = args.includes('--verbose');
+    const inputFile = args.find(arg => !arg.startsWith('--') && arg.endsWith('.md'));
+    const outputFile = args.find(arg => !arg.startsWith('--') && arg !== inputFile && arg.endsWith('.md'));
+
+    if (!inputFile) {
+        console.error('❌ Please provide an input markdown file');
+        process.exit(1);
+    }
+
+    if (!existsSync(inputFile)) {
+        console.error(`❌ Input file not found: ${inputFile}`);
+        process.exit(1);
+    }
+
+    try {
+        console.log(`📖 Reading: ${inputFile}`);
+        const content = readFileSync(inputFile, 'utf8');
+
+        const processedContent = postProcessMarkdown(content);
+
+        const finalOutputFile = outputFile || inputFile.replace('.md', '.processed.md');
+        writeFileSync(finalOutputFile, processedContent);
+
+        console.log(`✅ Processed: ${finalOutputFile}`);
+
+        if (verbose) {
+            console.log(`📊 Input: ${content.length} chars → Output: ${processedContent.length} chars`);
+        }
+
+    } catch (error) {
+        console.error('❌ Processing failed:', error.message);
+        process.exit(1);
+    }
+}
+
+// Run CLI if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}

app/scripts/notion-to-mdx/test-access.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+import { config } from 'dotenv';
+import { Client } from '@notionhq/client';
+
+// Load environment variables from .env file
+config();
+
+const notion = new Client({
+    auth: process.env.NOTION_TOKEN,
+});
+
+async function testAccess() {
+    const pageId = '27877f1c9c9d804d9c82f7b3905578ff';
+
+    try {
+        console.log('🔍 Testing access to Notion page...');
+        console.log(`📄 Page ID: ${pageId}`);
+
+        const response = await notion.pages.retrieve({ page_id: pageId });
+
+        console.log('✅ Access successful!');
+        console.log(`📝 Page title: ${response.properties.title?.title?.[0]?.text?.content || 'No title'}`);
+        console.log(`📅 Created: ${response.created_time}`);
+        console.log(`👤 Created by: ${response.created_by.id}`);
+
+    } catch (error) {
+        console.error('❌ Access failed:', error.message);
+
+        if (error.code === 'unauthorized') {
+            console.log('\n💡 Solutions:');
+            console.log('1. Check that your NOTION_TOKEN is correct');
+            console.log('2. Make sure the page is shared with your integration');
+            console.log('3. Verify that the integration has the right permissions');
+        }
+    }
+}
+
+testAccess();

app/scripts/notion-to-mdx/yarn.lock

@@ -0,0 +1,1118 @@
+# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
+# yarn lockfile v1
+
+
+"@cspotcode/source-map-support@^0.8.0":
+  version "0.8.1"
+  resolved "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz"
+  integrity sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==
+  dependencies:
+    "@jridgewell/trace-mapping" "0.3.9"
+
+"@jridgewell/resolve-uri@^3.0.3":
+  version "3.1.2"
+  resolved "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz"
+  integrity sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==
+
+"@jridgewell/sourcemap-codec@^1.4.10":
+  version "1.5.5"
+  resolved "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz"
+  integrity sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==
+
+"@jridgewell/trace-mapping@0.3.9":
+  version "0.3.9"
+  resolved "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz"
+  integrity sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==
+  dependencies:
+    "@jridgewell/resolve-uri" "^3.0.3"
+    "@jridgewell/sourcemap-codec" "^1.4.10"
+
+"@notionhq/client@^2.0.0", "@notionhq/client@^2.2.15":
+  version "2.3.0"
+  resolved "https://registry.npmjs.org/@notionhq/client/-/client-2.3.0.tgz"
+  integrity sha512-l7WqTCpQqC+HibkB9chghONQTYcxNQT0/rOJemBfmuKQRTu2vuV8B3yA395iKaUdDo7HI+0KvQaz9687Xskzkw==
+  dependencies:
+    "@types/node-fetch" "^2.5.10"
+    node-fetch "^2.6.1"
+
+"@tsconfig/node10@^1.0.7":
+  version "1.0.11"
+  resolved "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz"
+  integrity sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==
+
+"@tsconfig/node12@^1.0.7":
+  version "1.0.11"
+  resolved "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz"
+  integrity sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==
+
+"@tsconfig/node14@^1.0.0":
+  version "1.0.3"
+  resolved "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz"
+  integrity sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==
+
+"@tsconfig/node16@^1.0.2":
+  version "1.0.4"
+  resolved "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz"
+  integrity sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==
+
+"@types/debug@^4.0.0":
+  version "4.1.12"
+  resolved "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz"
+  integrity sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==
+  dependencies:
+    "@types/ms" "*"
+
+"@types/estree-jsx@^1.0.0":
+  version "1.0.5"
+  resolved "https://registry.npmjs.org/@types/estree-jsx/-/estree-jsx-1.0.5.tgz"
+  integrity sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==
+  dependencies:
+    "@types/estree" "*"
+
+"@types/estree@*", "@types/estree@^1.0.0":
+  version "1.0.8"
+  resolved "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz"
+  integrity sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==
+
+"@types/hast@^3.0.0":
+  version "3.0.4"
+  resolved "https://registry.npmjs.org/@types/hast/-/hast-3.0.4.tgz"
+  integrity sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ==
+  dependencies:
+    "@types/unist" "*"
+
+"@types/mdast@^4.0.0":
+  version "4.0.4"
+  resolved "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz"
+  integrity sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==
+  dependencies:
+    "@types/unist" "*"
+
+"@types/ms@*":
+  version "2.1.0"
+  resolved "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz"
+  integrity sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==
+
+"@types/node-fetch@^2.5.10":
+  version "2.6.13"
+  resolved "https://registry.npmjs.org/@types/node-fetch/-/node-fetch-2.6.13.tgz"
+  integrity sha512-QGpRVpzSaUs30JBSGPjOg4Uveu384erbHBoT1zeONvyCfwQxIkUshLAOqN/k9EjGviPRmWTTe6aH2qySWKTVSw==
+  dependencies:
+    "@types/node" "*"
+    form-data "^4.0.4"
+
+"@types/node@*":
+  version "24.5.2"
+  resolved "https://registry.npmjs.org/@types/node/-/node-24.5.2.tgz"
+  integrity sha512-FYxk1I7wPv3K2XBaoyH2cTnocQEu8AOZ60hPbsyukMPLv5/5qr7V1i8PLHdl6Zf87I+xZXFvPCXYjiTFq+YSDQ==
+  dependencies:
+    undici-types "~7.12.0"
+
+"@types/unist@*", "@types/unist@^3.0.0":
+  version "3.0.3"
+  resolved "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz"
+  integrity sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==
+
+"@types/unist@^2.0.0":
+  version "2.0.11"
+  resolved "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz"
+  integrity sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==
+
+acorn-jsx@^5.0.0:
+  version "5.3.2"
+  resolved "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz"
+  integrity sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==
+
+acorn-walk@^8.1.1:
+  version "8.3.4"
+  resolved "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz"
+  integrity sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==
+  dependencies:
+    acorn "^8.11.0"
+
+"acorn@^6.0.0 || ^7.0.0 || ^8.0.0", acorn@^8.0.0, acorn@^8.11.0, acorn@^8.4.1:
+  version "8.15.0"
+  resolved "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz"
+  integrity sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==
+
+arg@^4.1.0:
+  version "4.1.3"
+  resolved "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz"
+  integrity sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==
+
+argparse@^1.0.7:
+  version "1.0.10"
+  resolved "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz"
+  integrity sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==
+  dependencies:
+    sprintf-js "~1.0.2"
+
+asynckit@^0.4.0:
+  version "0.4.0"
+  resolved "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz"
+  integrity sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==
+
+bail@^2.0.0:
+  version "2.0.2"
+  resolved "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz"
+  integrity sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==
+
+call-bind-apply-helpers@^1.0.1, call-bind-apply-helpers@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz"
+  integrity sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==
+  dependencies:
+    es-errors "^1.3.0"
+    function-bind "^1.1.2"
+
+ccount@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz"
+  integrity sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==
+
+character-entities-html4@^2.0.0:
+  version "2.1.0"
+  resolved "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz"
+  integrity sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==
+
+character-entities-legacy@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz"
+  integrity sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==
+
+character-entities@^2.0.0:
+  version "2.0.2"
+  resolved "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz"
+  integrity sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==
+
+character-reference-invalid@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz"
+  integrity sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==
+
+combined-stream@^1.0.8:
+  version "1.0.8"
+  resolved "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz"
+  integrity sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==
+  dependencies:
+    delayed-stream "~1.0.0"
+
+create-require@^1.1.0:
+  version "1.1.1"
+  resolved "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz"
+  integrity sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==
+
+data-uri-to-buffer@^4.0.0:
+  version "4.0.1"
+  resolved "https://registry.npmjs.org/data-uri-to-buffer/-/data-uri-to-buffer-4.0.1.tgz"
+  integrity sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A==
+
+debug@^4.0.0:
+  version "4.4.3"
+  resolved "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz"
+  integrity sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==
+  dependencies:
+    ms "^2.1.3"
+
+decode-named-character-reference@^1.0.0:
+  version "1.2.0"
+  resolved "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.2.0.tgz"
+  integrity sha512-c6fcElNV6ShtZXmsgNgFFV5tVX2PaV4g+MOAkb8eXHvn6sryJBrZa9r0zV6+dtTyoCKxtDy5tyQ5ZwQuidtd+Q==
+  dependencies:
+    character-entities "^2.0.0"
+
+delayed-stream@~1.0.0:
+  version "1.0.0"
+  resolved "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz"
+  integrity sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==
+
+dequal@^2.0.0:
+  version "2.0.3"
+  resolved "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz"
+  integrity sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==
+
+devlop@^1.0.0, devlop@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz"
+  integrity sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==
+  dependencies:
+    dequal "^2.0.0"
+
+diff@^4.0.1:
+  version "4.0.2"
+  resolved "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz"
+  integrity sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==
+
+dotenv@^17.2.2:
+  version "17.2.2"
+  resolved "https://registry.npmjs.org/dotenv/-/dotenv-17.2.2.tgz"
+  integrity sha512-Sf2LSQP+bOlhKWWyhFsn0UsfdK/kCWRv1iuA2gXAwt3dyNabr6QSj00I2V10pidqz69soatm9ZwZvpQMTIOd5Q==
+
+dunder-proto@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz"
+  integrity sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==
+  dependencies:
+    call-bind-apply-helpers "^1.0.1"
+    es-errors "^1.3.0"
+    gopd "^1.2.0"
+
+es-define-property@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz"
+  integrity sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==
+
+es-errors@^1.3.0:
+  version "1.3.0"
+  resolved "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz"
+  integrity sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==
+
+es-object-atoms@^1.0.0, es-object-atoms@^1.1.1:
+  version "1.1.1"
+  resolved "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz"
+  integrity sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==
+  dependencies:
+    es-errors "^1.3.0"
+
+es-set-tostringtag@^2.1.0:
+  version "2.1.0"
+  resolved "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz"
+  integrity sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==
+  dependencies:
+    es-errors "^1.3.0"
+    get-intrinsic "^1.2.6"
+    has-tostringtag "^1.0.2"
+    hasown "^2.0.2"
+
+esprima@^4.0.0:
+  version "4.0.1"
+  resolved "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz"
+  integrity sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==
+
+estree-util-is-identifier-name@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.npmjs.org/estree-util-is-identifier-name/-/estree-util-is-identifier-name-3.0.0.tgz"
+  integrity sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==
+
+estree-util-visit@^2.0.0:
+  version "2.0.0"
+  resolved "https://registry.npmjs.org/estree-util-visit/-/estree-util-visit-2.0.0.tgz"
+  integrity sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==
+  dependencies:
+    "@types/estree-jsx" "^1.0.0"
+    "@types/unist" "^3.0.0"
+
+extend-shallow@^2.0.1:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz"
+  integrity sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==
+  dependencies:
+    is-extendable "^0.1.0"
+
+extend@^3.0.0:
+  version "3.0.2"
+  resolved "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz"
+  integrity sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==
+
+fetch-blob@^3.1.2, fetch-blob@^3.1.4:
+  version "3.2.0"
+  resolved "https://registry.npmjs.org/fetch-blob/-/fetch-blob-3.2.0.tgz"
+  integrity sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ==
+  dependencies:
+    node-domexception "^1.0.0"
+    web-streams-polyfill "^3.0.3"
+
+form-data@^4.0.4:
+  version "4.0.4"
+  resolved "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz"
+  integrity sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==
+  dependencies:
+    asynckit "^0.4.0"
+    combined-stream "^1.0.8"
+    es-set-tostringtag "^2.1.0"
+    hasown "^2.0.2"
+    mime-types "^2.1.12"
+
+formdata-polyfill@^4.0.10:
+  version "4.0.10"
+  resolved "https://registry.npmjs.org/formdata-polyfill/-/formdata-polyfill-4.0.10.tgz"
+  integrity sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g==
+  dependencies:
+    fetch-blob "^3.1.2"
+
+function-bind@^1.1.2:
+  version "1.1.2"
+  resolved "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz"
+  integrity sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==
+
+get-intrinsic@^1.2.6:
+  version "1.3.0"
+  resolved "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz"
+  integrity sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==
+  dependencies:
+    call-bind-apply-helpers "^1.0.2"
+    es-define-property "^1.0.1"
+    es-errors "^1.3.0"
+    es-object-atoms "^1.1.1"
+    function-bind "^1.1.2"
+    get-proto "^1.0.1"
+    gopd "^1.2.0"
+    has-symbols "^1.1.0"
+    hasown "^2.0.2"
+    math-intrinsics "^1.1.0"
+
+get-proto@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz"
+  integrity sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==
+  dependencies:
+    dunder-proto "^1.0.1"
+    es-object-atoms "^1.0.0"
+
+gopd@^1.2.0:
+  version "1.2.0"
+  resolved "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz"
+  integrity sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==
+
+gray-matter@^4.0.3:
+  version "4.0.3"
+  resolved "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz"
+  integrity sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==
+  dependencies:
+    js-yaml "^3.13.1"
+    kind-of "^6.0.2"
+    section-matter "^1.0.0"
+    strip-bom-string "^1.0.0"
+
+has-symbols@^1.0.3, has-symbols@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz"
+  integrity sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==
+
+has-tostringtag@^1.0.2:
+  version "1.0.2"
+  resolved "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz"
+  integrity sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==
+  dependencies:
+    has-symbols "^1.0.3"
+
+hasown@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz"
+  integrity sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==
+  dependencies:
+    function-bind "^1.1.2"
+
+is-alphabetical@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz"
+  integrity sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==
+
+is-alphanumerical@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz"
+  integrity sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==
+  dependencies:
+    is-alphabetical "^2.0.0"
+    is-decimal "^2.0.0"
+
+is-decimal@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/is-decimal/-/is-decimal-2.0.1.tgz"
+  integrity sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==
+
+is-extendable@^0.1.0:
+  version "0.1.1"
+  resolved "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz"
+  integrity sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==
+
+is-hexadecimal@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz"
+  integrity sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==
+
+is-plain-obj@^4.0.0:
+  version "4.1.0"
+  resolved "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz"
+  integrity sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==
+
+js-yaml@^3.13.1:
+  version "3.14.1"
+  resolved "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz"
+  integrity sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==
+  dependencies:
+    argparse "^1.0.7"
+    esprima "^4.0.0"
+
+kind-of@^6.0.0, kind-of@^6.0.2:
+  version "6.0.3"
+  resolved "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz"
+  integrity sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==
+
+longest-streak@^3.0.0:
+  version "3.1.0"
+  resolved "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz"
+  integrity sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==
+
+make-error@^1.1.1:
+  version "1.3.6"
+  resolved "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz"
+  integrity sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==
+
+math-intrinsics@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz"
+  integrity sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==
+
+mdast-util-from-markdown@^2.0.0:
+  version "2.0.2"
+  resolved "https://registry.npmjs.org/mdast-util-from-markdown/-/mdast-util-from-markdown-2.0.2.tgz"
+  integrity sha512-uZhTV/8NBuw0WHkPTrCqDOl0zVe1BIng5ZtHoDk49ME1qqcjYmmLmOf0gELgcRMxN4w2iuIeVso5/6QymSrgmA==
+  dependencies:
+    "@types/mdast" "^4.0.0"
+    "@types/unist" "^3.0.0"
+    decode-named-character-reference "^1.0.0"
+    devlop "^1.0.0"
+    mdast-util-to-string "^4.0.0"
+    micromark "^4.0.0"
+    micromark-util-decode-numeric-character-reference "^2.0.0"
+    micromark-util-decode-string "^2.0.0"
+    micromark-util-normalize-identifier "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+    unist-util-stringify-position "^4.0.0"
+
+mdast-util-mdx-expression@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/mdast-util-mdx-expression/-/mdast-util-mdx-expression-2.0.1.tgz"
+  integrity sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==
+  dependencies:
+    "@types/estree-jsx" "^1.0.0"
+    "@types/hast" "^3.0.0"
+    "@types/mdast" "^4.0.0"
+    devlop "^1.0.0"
+    mdast-util-from-markdown "^2.0.0"
+    mdast-util-to-markdown "^2.0.0"
+
+mdast-util-mdx-jsx@^3.0.0:
+  version "3.2.0"
+  resolved "https://registry.npmjs.org/mdast-util-mdx-jsx/-/mdast-util-mdx-jsx-3.2.0.tgz"
+  integrity sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==
+  dependencies:
+    "@types/estree-jsx" "^1.0.0"
+    "@types/hast" "^3.0.0"
+    "@types/mdast" "^4.0.0"
+    "@types/unist" "^3.0.0"
+    ccount "^2.0.0"
+    devlop "^1.1.0"
+    mdast-util-from-markdown "^2.0.0"
+    mdast-util-to-markdown "^2.0.0"
+    parse-entities "^4.0.0"
+    stringify-entities "^4.0.0"
+    unist-util-stringify-position "^4.0.0"
+    vfile-message "^4.0.0"
+
+mdast-util-mdx@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.npmjs.org/mdast-util-mdx/-/mdast-util-mdx-3.0.0.tgz"
+  integrity sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==
+  dependencies:
+    mdast-util-from-markdown "^2.0.0"
+    mdast-util-mdx-expression "^2.0.0"
+    mdast-util-mdx-jsx "^3.0.0"
+    mdast-util-mdxjs-esm "^2.0.0"
+    mdast-util-to-markdown "^2.0.0"
+
+mdast-util-mdxjs-esm@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/mdast-util-mdxjs-esm/-/mdast-util-mdxjs-esm-2.0.1.tgz"
+  integrity sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==
+  dependencies:
+    "@types/estree-jsx" "^1.0.0"
+    "@types/hast" "^3.0.0"
+    "@types/mdast" "^4.0.0"
+    devlop "^1.0.0"
+    mdast-util-from-markdown "^2.0.0"
+    mdast-util-to-markdown "^2.0.0"
+
+mdast-util-phrasing@^4.0.0:
+  version "4.1.0"
+  resolved "https://registry.npmjs.org/mdast-util-phrasing/-/mdast-util-phrasing-4.1.0.tgz"
+  integrity sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==
+  dependencies:
+    "@types/mdast" "^4.0.0"
+    unist-util-is "^6.0.0"
+
+mdast-util-to-markdown@^2.0.0:
+  version "2.1.2"
+  resolved "https://registry.npmjs.org/mdast-util-to-markdown/-/mdast-util-to-markdown-2.1.2.tgz"
+  integrity sha512-xj68wMTvGXVOKonmog6LwyJKrYXZPvlwabaryTjLh9LuvovB/KAH+kvi8Gjj+7rJjsFi23nkUxRQv1KqSroMqA==
+  dependencies:
+    "@types/mdast" "^4.0.0"
+    "@types/unist" "^3.0.0"
+    longest-streak "^3.0.0"
+    mdast-util-phrasing "^4.0.0"
+    mdast-util-to-string "^4.0.0"
+    micromark-util-classify-character "^2.0.0"
+    micromark-util-decode-string "^2.0.0"
+    unist-util-visit "^5.0.0"
+    zwitch "^2.0.0"
+
+mdast-util-to-string@^4.0.0:
+  version "4.0.0"
+  resolved "https://registry.npmjs.org/mdast-util-to-string/-/mdast-util-to-string-4.0.0.tgz"
+  integrity sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==
+  dependencies:
+    "@types/mdast" "^4.0.0"
+
+micromark-core-commonmark@^2.0.0:
+  version "2.0.3"
+  resolved "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-2.0.3.tgz"
+  integrity sha512-RDBrHEMSxVFLg6xvnXmb1Ayr2WzLAWjeSATAoxwKYJV94TeNavgoIdA0a9ytzDSVzBy2YKFK+emCPOEibLeCrg==
+  dependencies:
+    decode-named-character-reference "^1.0.0"
+    devlop "^1.0.0"
+    micromark-factory-destination "^2.0.0"
+    micromark-factory-label "^2.0.0"
+    micromark-factory-space "^2.0.0"
+    micromark-factory-title "^2.0.0"
+    micromark-factory-whitespace "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-chunked "^2.0.0"
+    micromark-util-classify-character "^2.0.0"
+    micromark-util-html-tag-name "^2.0.0"
+    micromark-util-normalize-identifier "^2.0.0"
+    micromark-util-resolve-all "^2.0.0"
+    micromark-util-subtokenize "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-extension-mdx-expression@^3.0.0:
+  version "3.0.1"
+  resolved "https://registry.npmjs.org/micromark-extension-mdx-expression/-/micromark-extension-mdx-expression-3.0.1.tgz"
+  integrity sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==
+  dependencies:
+    "@types/estree" "^1.0.0"
+    devlop "^1.0.0"
+    micromark-factory-mdx-expression "^2.0.0"
+    micromark-factory-space "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-events-to-acorn "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-extension-mdx-jsx@^3.0.0:
+  version "3.0.2"
+  resolved "https://registry.npmjs.org/micromark-extension-mdx-jsx/-/micromark-extension-mdx-jsx-3.0.2.tgz"
+  integrity sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==
+  dependencies:
+    "@types/estree" "^1.0.0"
+    devlop "^1.0.0"
+    estree-util-is-identifier-name "^3.0.0"
+    micromark-factory-mdx-expression "^2.0.0"
+    micromark-factory-space "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-events-to-acorn "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+    vfile-message "^4.0.0"
+
+micromark-extension-mdx-md@^2.0.0:
+  version "2.0.0"
+  resolved "https://registry.npmjs.org/micromark-extension-mdx-md/-/micromark-extension-mdx-md-2.0.0.tgz"
+  integrity sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==
+  dependencies:
+    micromark-util-types "^2.0.0"
+
+micromark-extension-mdxjs-esm@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.npmjs.org/micromark-extension-mdxjs-esm/-/micromark-extension-mdxjs-esm-3.0.0.tgz"
+  integrity sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==
+  dependencies:
+    "@types/estree" "^1.0.0"
+    devlop "^1.0.0"
+    micromark-core-commonmark "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-events-to-acorn "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+    unist-util-position-from-estree "^2.0.0"
+    vfile-message "^4.0.0"
+
+micromark-extension-mdxjs@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.npmjs.org/micromark-extension-mdxjs/-/micromark-extension-mdxjs-3.0.0.tgz"
+  integrity sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==
+  dependencies:
+    acorn "^8.0.0"
+    acorn-jsx "^5.0.0"
+    micromark-extension-mdx-expression "^3.0.0"
+    micromark-extension-mdx-jsx "^3.0.0"
+    micromark-extension-mdx-md "^2.0.0"
+    micromark-extension-mdxjs-esm "^3.0.0"
+    micromark-util-combine-extensions "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-factory-destination@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz"
+  integrity sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==
+  dependencies:
+    micromark-util-character "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-factory-label@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-2.0.1.tgz"
+  integrity sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==
+  dependencies:
+    devlop "^1.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-factory-mdx-expression@^2.0.0:
+  version "2.0.3"
+  resolved "https://registry.npmjs.org/micromark-factory-mdx-expression/-/micromark-factory-mdx-expression-2.0.3.tgz"
+  integrity sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==
+  dependencies:
+    "@types/estree" "^1.0.0"
+    devlop "^1.0.0"
+    micromark-factory-space "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-events-to-acorn "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+    unist-util-position-from-estree "^2.0.0"
+    vfile-message "^4.0.0"
+
+micromark-factory-space@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-2.0.1.tgz"
+  integrity sha512-zRkxjtBxxLd2Sc0d+fbnEunsTj46SWXgXciZmHq0kDYGnck/ZSGj9/wULTV95uoeYiK5hRXP2mJ98Uo4cq/LQg==
+  dependencies:
+    micromark-util-character "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-factory-title@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-2.0.1.tgz"
+  integrity sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==
+  dependencies:
+    micromark-factory-space "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-factory-whitespace@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-2.0.1.tgz"
+  integrity sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==
+  dependencies:
+    micromark-factory-space "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-util-character@^2.0.0:
+  version "2.1.1"
+  resolved "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz"
+  integrity sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==
+  dependencies:
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-util-chunked@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-2.0.1.tgz"
+  integrity sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==
+  dependencies:
+    micromark-util-symbol "^2.0.0"
+
+micromark-util-classify-character@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-2.0.1.tgz"
+  integrity sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==
+  dependencies:
+    micromark-util-character "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-util-combine-extensions@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-2.0.1.tgz"
+  integrity sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==
+  dependencies:
+    micromark-util-chunked "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-util-decode-numeric-character-reference@^2.0.0:
+  version "2.0.2"
+  resolved "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-2.0.2.tgz"
+  integrity sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==
+  dependencies:
+    micromark-util-symbol "^2.0.0"
+
+micromark-util-decode-string@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-decode-string/-/micromark-util-decode-string-2.0.1.tgz"
+  integrity sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==
+  dependencies:
+    decode-named-character-reference "^1.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-decode-numeric-character-reference "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+
+micromark-util-encode@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz"
+  integrity sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==
+
+micromark-util-events-to-acorn@^2.0.0:
+  version "2.0.3"
+  resolved "https://registry.npmjs.org/micromark-util-events-to-acorn/-/micromark-util-events-to-acorn-2.0.3.tgz"
+  integrity sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==
+  dependencies:
+    "@types/estree" "^1.0.0"
+    "@types/unist" "^3.0.0"
+    devlop "^1.0.0"
+    estree-util-visit "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+    vfile-message "^4.0.0"
+
+micromark-util-html-tag-name@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-2.0.1.tgz"
+  integrity sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==
+
+micromark-util-normalize-identifier@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-2.0.1.tgz"
+  integrity sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==
+  dependencies:
+    micromark-util-symbol "^2.0.0"
+
+micromark-util-resolve-all@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-2.0.1.tgz"
+  integrity sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==
+  dependencies:
+    micromark-util-types "^2.0.0"
+
+micromark-util-sanitize-uri@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz"
+  integrity sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==
+  dependencies:
+    micromark-util-character "^2.0.0"
+    micromark-util-encode "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+
+micromark-util-subtokenize@^2.0.0:
+  version "2.1.0"
+  resolved "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-2.1.0.tgz"
+  integrity sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==
+  dependencies:
+    devlop "^1.0.0"
+    micromark-util-chunked "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+micromark-util-symbol@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz"
+  integrity sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==
+
+micromark-util-types@^2.0.0:
+  version "2.0.2"
+  resolved "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz"
+  integrity sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==
+
+micromark@^4.0.0:
+  version "4.0.2"
+  resolved "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz"
+  integrity sha512-zpe98Q6kvavpCr1NPVSCMebCKfD7CA2NqZ+rykeNhONIJBpc1tFKt9hucLGwha3jNTNI8lHpctWJWoimVF4PfA==
+  dependencies:
+    "@types/debug" "^4.0.0"
+    debug "^4.0.0"
+    decode-named-character-reference "^1.0.0"
+    devlop "^1.0.0"
+    micromark-core-commonmark "^2.0.0"
+    micromark-factory-space "^2.0.0"
+    micromark-util-character "^2.0.0"
+    micromark-util-chunked "^2.0.0"
+    micromark-util-combine-extensions "^2.0.0"
+    micromark-util-decode-numeric-character-reference "^2.0.0"
+    micromark-util-encode "^2.0.0"
+    micromark-util-normalize-identifier "^2.0.0"
+    micromark-util-resolve-all "^2.0.0"
+    micromark-util-sanitize-uri "^2.0.0"
+    micromark-util-subtokenize "^2.0.0"
+    micromark-util-symbol "^2.0.0"
+    micromark-util-types "^2.0.0"
+
+mime-db@1.52.0:
+  version "1.52.0"
+  resolved "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz"
+  integrity sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==
+
+mime-types@^2.1.12, mime-types@^2.1.35:
+  version "2.1.35"
+  resolved "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz"
+  integrity sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==
+  dependencies:
+    mime-db "1.52.0"
+
+mime@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.npmjs.org/mime/-/mime-3.0.0.tgz"
+  integrity sha512-jSCU7/VB1loIWBZe14aEYHU/+1UMEHoaO7qxCOVJOw9GgH72VAWppxNcjU+x9a2k3GSIBXNKxXQFqRvvZ7vr3A==
+
+ms@^2.1.3:
+  version "2.1.3"
+  resolved "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz"
+  integrity sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==
+
+node-domexception@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.npmjs.org/node-domexception/-/node-domexception-1.0.0.tgz"
+  integrity sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==
+
+node-fetch@^2.6.1:
+  version "2.7.0"
+  resolved "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz"
+  integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==
+  dependencies:
+    whatwg-url "^5.0.0"
+
+node-fetch@^2.7.0:
+  version "2.7.0"
+  resolved "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz"
+  integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==
+  dependencies:
+    whatwg-url "^5.0.0"
+
+node-fetch@^3.3.2:
+  version "3.3.2"
+  resolved "https://registry.npmjs.org/node-fetch/-/node-fetch-3.3.2.tgz"
+  integrity sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA==
+  dependencies:
+    data-uri-to-buffer "^4.0.0"
+    fetch-blob "^3.1.4"
+    formdata-polyfill "^4.0.10"
+
+notion-to-md@^4.0.0-alpha:
+  version "4.0.0-alpha.7"
+  resolved "https://registry.npmjs.org/notion-to-md/-/notion-to-md-4.0.0-alpha.7.tgz"
+  integrity sha512-3kocKMEVcivy2ccuv2uZDJQFKXdvRmsujbN2GeOwP6yoNqhj/c/fmXroqPkk4XXRqNdJB2jzf5NPhPSWpuZkdA==
+  dependencies:
+    mime "^3.0.0"
+    node-fetch "^2.7.0"
+    ts-node "^10.9.2"
+
+parse-entities@^4.0.0:
+  version "4.0.2"
+  resolved "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz"
+  integrity sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==
+  dependencies:
+    "@types/unist" "^2.0.0"
+    character-entities-legacy "^3.0.0"
+    character-reference-invalid "^2.0.0"
+    decode-named-character-reference "^1.0.0"
+    is-alphanumerical "^2.0.0"
+    is-decimal "^2.0.0"
+    is-hexadecimal "^2.0.0"
+
+remark-mdx@^3.0.0:
+  version "3.1.1"
+  resolved "https://registry.npmjs.org/remark-mdx/-/remark-mdx-3.1.1.tgz"
+  integrity sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==
+  dependencies:
+    mdast-util-mdx "^3.0.0"
+    micromark-extension-mdxjs "^3.0.0"
+
+remark-parse@^11.0.0:
+  version "11.0.0"
+  resolved "https://registry.npmjs.org/remark-parse/-/remark-parse-11.0.0.tgz"
+  integrity sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==
+  dependencies:
+    "@types/mdast" "^4.0.0"
+    mdast-util-from-markdown "^2.0.0"
+    micromark-util-types "^2.0.0"
+    unified "^11.0.0"
+
+remark-stringify@^11.0.0:
+  version "11.0.0"
+  resolved "https://registry.npmjs.org/remark-stringify/-/remark-stringify-11.0.0.tgz"
+  integrity sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==
+  dependencies:
+    "@types/mdast" "^4.0.0"
+    mdast-util-to-markdown "^2.0.0"
+    unified "^11.0.0"
+
+section-matter@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.npmjs.org/section-matter/-/section-matter-1.0.0.tgz"
+  integrity sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==
+  dependencies:
+    extend-shallow "^2.0.1"
+    kind-of "^6.0.0"
+
+sprintf-js@~1.0.2:
+  version "1.0.3"
+  resolved "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz"
+  integrity sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==
+
+stringify-entities@^4.0.0:
+  version "4.0.4"
+  resolved "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz"
+  integrity sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==
+  dependencies:
+    character-entities-html4 "^2.0.0"
+    character-entities-legacy "^3.0.0"
+
+strip-bom-string@^1.0.0:
+  version "1.0.0"
+  resolved "https://registry.npmjs.org/strip-bom-string/-/strip-bom-string-1.0.0.tgz"
+  integrity sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==
+
+tr46@~0.0.3:
+  version "0.0.3"
+  resolved "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz"
+  integrity sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==
+
+trough@^2.0.0:
+  version "2.2.0"
+  resolved "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz"
+  integrity sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==
+
+ts-node@^10.9.2:
+  version "10.9.2"
+  resolved "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz"
+  integrity sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==
+  dependencies:
+    "@cspotcode/source-map-support" "^0.8.0"
+    "@tsconfig/node10" "^1.0.7"
+    "@tsconfig/node12" "^1.0.7"
+    "@tsconfig/node14" "^1.0.0"
+    "@tsconfig/node16" "^1.0.2"
+    acorn "^8.4.1"
+    acorn-walk "^8.1.1"
+    arg "^4.1.0"
+    create-require "^1.1.0"
+    diff "^4.0.1"
+    make-error "^1.1.1"
+    v8-compile-cache-lib "^3.0.1"
+    yn "3.1.1"
+
+typescript@>=2.7:
+  version "5.9.2"
+  resolved "https://registry.npmjs.org/typescript/-/typescript-5.9.2.tgz"
+  integrity sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A==
+
+undici-types@~7.12.0:
+  version "7.12.0"
+  resolved "https://registry.npmjs.org/undici-types/-/undici-types-7.12.0.tgz"
+  integrity sha512-goOacqME2GYyOZZfb5Lgtu+1IDmAlAEu5xnD3+xTzS10hT0vzpf0SPjkXwAw9Jm+4n/mQGDP3LO8CPbYROeBfQ==
+
+unified@^11.0.0, unified@^11.0.4:
+  version "11.0.5"
+  resolved "https://registry.npmjs.org/unified/-/unified-11.0.5.tgz"
+  integrity sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==
+  dependencies:
+    "@types/unist" "^3.0.0"
+    bail "^2.0.0"
+    devlop "^1.0.0"
+    extend "^3.0.0"
+    is-plain-obj "^4.0.0"
+    trough "^2.0.0"
+    vfile "^6.0.0"
+
+unist-util-is@^6.0.0:
+  version "6.0.0"
+  resolved "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.0.tgz"
+  integrity sha512-2qCTHimwdxLfz+YzdGfkqNlH0tLi9xjTnHddPmJwtIG9MGsdbutfTc4P+haPD7l7Cjxf/WZj+we5qfVPvvxfYw==
+  dependencies:
+    "@types/unist" "^3.0.0"
+
+unist-util-position-from-estree@^2.0.0:
+  version "2.0.0"
+  resolved "https://registry.npmjs.org/unist-util-position-from-estree/-/unist-util-position-from-estree-2.0.0.tgz"
+  integrity sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==
+  dependencies:
+    "@types/unist" "^3.0.0"
+
+unist-util-stringify-position@^4.0.0:
+  version "4.0.0"
+  resolved "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz"
+  integrity sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==
+  dependencies:
+    "@types/unist" "^3.0.0"
+
+unist-util-visit-parents@^6.0.0:
+  version "6.0.1"
+  resolved "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.1.tgz"
+  integrity sha512-L/PqWzfTP9lzzEa6CKs0k2nARxTdZduw3zyh8d2NVBnsyvHjSX4TWse388YrrQKbvI8w20fGjGlhgT96WwKykw==
+  dependencies:
+    "@types/unist" "^3.0.0"
+    unist-util-is "^6.0.0"
+
+unist-util-visit@^5.0.0:
+  version "5.0.0"
+  resolved "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.0.0.tgz"
+  integrity sha512-MR04uvD+07cwl/yhVuVWAtw+3GOR/knlL55Nd/wAdblk27GCVt3lqpTivy/tkJcZoNPzTwS1Y+KMojlLDhoTzg==
+  dependencies:
+    "@types/unist" "^3.0.0"
+    unist-util-is "^6.0.0"
+    unist-util-visit-parents "^6.0.0"
+
+v8-compile-cache-lib@^3.0.1:
+  version "3.0.1"
+  resolved "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz"
+  integrity sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==
+
+vfile-message@^4.0.0:
+  version "4.0.3"
+  resolved "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz"
+  integrity sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==
+  dependencies:
+    "@types/unist" "^3.0.0"
+    unist-util-stringify-position "^4.0.0"
+
+vfile@^6.0.0:
+  version "6.0.3"
+  resolved "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz"
+  integrity sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==
+  dependencies:
+    "@types/unist" "^3.0.0"
+    vfile-message "^4.0.0"
+
+web-streams-polyfill@^3.0.3:
+  version "3.3.3"
+  resolved "https://registry.npmjs.org/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz"
+  integrity sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw==
+
+webidl-conversions@^3.0.0:
+  version "3.0.1"
+  resolved "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz"
+  integrity sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==
+
+whatwg-url@^5.0.0:
+  version "5.0.0"
+  resolved "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz"
+  integrity sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==
+  dependencies:
+    tr46 "~0.0.3"
+    webidl-conversions "^3.0.0"
+
+yn@3.1.1:
+  version "3.1.1"
+  resolved "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz"
+  integrity sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==
+
+zwitch@^2.0.0:
+  version "2.0.4"
+  resolved "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz"
+  integrity sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==

app/src/components/Hero.astro

@@ -5,26 +5,49 @@ interface Props {
   title: string; // may contain HTML (e.g., <br/>)
   titleRaw?: string; // plain title for slug/PDF (optional)
   description?: string;
-  authors?: Array<string | { name: string; url?: string; affiliationIndices?: number[] }>;
+  authors?: Array<
+    string | { name: string; url?: string; affiliationIndices?: number[] }
+  >;
   affiliations?: Array<{ id: number; name: string; url?: string }>;
   affiliation?: string; // legacy single affiliation
   published?: string;
   doi?: string;
 }
 
-const { title, titleRaw, description, authors = [], affiliations = [], affiliation, published, doi } = Astro.props as Props;
+const {
+  title,
+  titleRaw,
+  description,
+  authors = [],
+  affiliations = [],
+  affiliation,
+  published,
+  doi,
+} = Astro.props as Props;
 
 type Author = { name: string; url?: string; affiliationIndices?: number[] };
 
-function normalizeAuthors(input: Array<string | { name?: string; url?: string; link?: string; affiliationIndices?: number[] }>): Author[] {
+function normalizeAuthors(
+  input: Array<
+    | string
+    | {
+        name?: string;
+        url?: string;
+        link?: string;
+        affiliationIndices?: number[];
+      }
+  >,
+): Author[] {
   return (Array.isArray(input) ? input : [])
     .map((a) => {
-      if (typeof a === 'string') {
+      if (typeof a === "string") {
         return { name: a } as Author;
       }
-      const name = (a?.name ?? '').toString();
+      const name = (a?.name ?? "").toString();
       const url = (a?.url ?? a?.link) as string | undefined;
-      const affiliationIndices = Array.isArray((a as any)?.affiliationIndices) ? (a as any).affiliationIndices : undefined;
+      const affiliationIndices = Array.isArray((a as any)?.affiliationIndices)
+        ? (a as any).affiliationIndices
+        : undefined;
       return { name, url, affiliationIndices } as Author;
     })
     .filter((a) => a.name && a.name.trim().length > 0);
@@ -35,35 +58,41 @@ const normalizedAuthors: Author[] = normalizeAuthors(authors as any);
 // Determine if affiliation superscripts should be shown (only when there are multiple distinct affiliations referenced by authors)
 const authorAffiliationIndexSet = new Set<number>();
 for (const author of normalizedAuthors) {
-  const indices = Array.isArray(author.affiliationIndices) ? author.affiliationIndices : [];
+  const indices = Array.isArray(author.affiliationIndices)
+    ? author.affiliationIndices
+    : [];
   for (const idx of indices) {
-    if (typeof idx === 'number') {
+    if (typeof idx === "number") {
       authorAffiliationIndexSet.add(idx);
     }
   }
 }
 const shouldShowAffiliationSupers = authorAffiliationIndexSet.size > 1;
-const hasMultipleAffiliations = Array.isArray(affiliations) && affiliations.length > 1;
+const hasMultipleAffiliations =
+  Array.isArray(affiliations) && affiliations.length > 1;
 
 function stripHtml(text: string): string {
-  return String(text || '').replace(/<[^>]*>/g, '');
+  return String(text || "").replace(/<[^>]*>/g, "");
 }
 
 function slugify(text: string): string {
-  return String(text || '')
-    .normalize('NFKD')
-    .replace(/\p{Diacritic}+/gu, '')
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-')
-    .replace(/^-+|-+$/g, '')
-    .slice(0, 120) || 'article';
+  return (
+    String(text || "")
+      .normalize("NFKD")
+      .replace(/\p{Diacritic}+/gu, "")
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-+|-+$/g, "")
+      .slice(0, 120) || "article"
+  );
 }
 
 const pdfBase = titleRaw ? stripHtml(titleRaw) : stripHtml(title);
 const pdfFilename = `${slugify(pdfBase)}.pdf`;
 ---
+
 <section class="hero">
-  <h1 class="hero-title" set:html={title}></h1>
+  <h1 class="hero-title" set:html={title} />
   <div class="hero-banner">
     <HtmlEmbed src="banner.html" frameless />
     {description && <p class="hero-desc">{description}</p>}
@@ -72,53 +101,82 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
 
 <header class="meta" aria-label="Article meta information">
   <div class="meta-container">
-    {normalizedAuthors.length > 0 && (
-      <div class="meta-container-cell">
-        <h3>Author{normalizedAuthors.length > 1 ? 's' : ''}</h3>
-        <ul class="authors">
-          {normalizedAuthors.map((a, i) => {
-            const supers = shouldShowAffiliationSupers && Array.isArray(a.affiliationIndices) && a.affiliationIndices.length
-              ? <sup>{a.affiliationIndices.join(',')}</sup>
-              : null;
-            return (
-              <li>
-                {a.url ? <a href={a.url}>{a.name}</a> : a.name}{supers}
-              </li>
-            );
-          })}
-        </ul>
-      </div>
-    )}
-    {(Array.isArray(affiliations) && affiliations.length > 0) && (
-      <div class="meta-container-cell">
-        <h3>Affiliation{affiliations.length > 1 ? 's' : ''}</h3>
-        {hasMultipleAffiliations ? (
-          <ol class="affiliations">
-            {affiliations.map((af) => (
-              <li value={af.id}>{af.url ? <a href={af.url} target="_blank" rel="noopener noreferrer">{af.name}</a> : af.name}</li>
-            ))}
-          </ol>
-        ) : (
-          <p>
-            {affiliations[0]?.url 
-              ? <a href={affiliations[0].url} target="_blank" rel="noopener noreferrer">{affiliations[0].name}</a> 
-              : affiliations[0]?.name}
-          </p>
-        )}
-      </div>
-    )}
-    {(!affiliations || affiliations.length === 0) && affiliation && (
-      <div class="meta-container-cell">
-        <h3>Affiliation</h3>
-        <p>{affiliation}</p>
-      </div>
-    )}
-    {published && (
-      <div class="meta-container-cell meta-container-cell--published">
-        <h3>Published</h3>
-        <p>{published}</p>
-      </div>
-    )}
+    {
+      normalizedAuthors.length > 0 && (
+        <div class="meta-container-cell">
+          <h3>Author{normalizedAuthors.length > 1 ? "s" : ""}</h3>
+          <ul class="authors">
+            {normalizedAuthors.map((a, i) => {
+              const supers =
+                shouldShowAffiliationSupers &&
+                Array.isArray(a.affiliationIndices) &&
+                a.affiliationIndices.length ? (
+                  <sup>{a.affiliationIndices.join(",")}</sup>
+                ) : null;
+              return (
+                <li>
+                  {a.url ? <a href={a.url}>{a.name}</a> : a.name}
+                  {supers}
+                  {i < normalizedAuthors.length - 1 && ", "}
+                </li>
+              );
+            })}
+          </ul>
+        </div>
+      )
+    }
+    {
+      Array.isArray(affiliations) && affiliations.length > 0 && (
+        <div class="meta-container-cell meta-container-cell--affiliations">
+          <h3>Affiliation{affiliations.length > 1 ? "s" : ""}</h3>
+          {hasMultipleAffiliations ? (
+            <ol class="affiliations">
+              {affiliations.map((af) => (
+                <li value={af.id}>
+                  {af.url ? (
+                    <a href={af.url} target="_blank" rel="noopener noreferrer">
+                      {af.name}
+                    </a>
+                  ) : (
+                    af.name
+                  )}
+                </li>
+              ))}
+            </ol>
+          ) : (
+            <p>
+              {affiliations[0]?.url ? (
+                <a
+                  href={affiliations[0].url}
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  {affiliations[0].name}
+                </a>
+              ) : (
+                affiliations[0]?.name
+              )}
+            </p>
+          )}
+        </div>
+      )
+    }
+    {
+      (!affiliations || affiliations.length === 0) && affiliation && (
+        <div class="meta-container-cell meta-container-cell--affiliations">
+          <h3>Affiliation</h3>
+          <p>{affiliation}</p>
+        </div>
+      )
+    }
+    {
+      published && (
+        <div class="meta-container-cell meta-container-cell--published">
+          <h3>Published</h3>
+          <p>{published}</p>
+        </div>
+      )
+    }
     <!-- {doi && (
       <div class="meta-container-cell">
         <h3>DOI</h3>
@@ -128,7 +186,12 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
     <div class="meta-container-cell meta-container-cell--pdf">
       <h3>PDF</h3>
       <p>
-        <a class="button" href={`/${pdfFilename}`} download={pdfFilename} aria-label={`Download PDF ${pdfFilename}`}>
+        <a
+          class="button"
+          href={`/${pdfFilename}`}
+          download={pdfFilename}
+          aria-label={`Download PDF ${pdfFilename}`}
+        >
           Download PDF
         </a>
       </p>
@@ -136,7 +199,6 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
   </div>
 </header>
 
-
 <style>
   /* Hero (full-width) */
   .hero {
@@ -185,7 +247,7 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
     text-underline-offset: 2px;
     text-decoration-thickness: 0.06em;
     text-decoration-color: var(--link-underline);
-    transition: text-decoration-color .15s ease-in-out;
+    transition: text-decoration-color 0.15s ease-in-out;
   }
   .meta-container a:hover {
     text-decoration-color: var(--link-underline-hover);
@@ -198,6 +260,7 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
     display: flex;
     flex-direction: column;
     gap: 8px;
+    max-width: 250px;
   }
   .meta-container-cell h3 {
     margin: 0;
@@ -205,15 +268,21 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
     font-weight: 400;
     color: var(--muted-color);
     text-transform: uppercase;
-    letter-spacing: .02em;
+    letter-spacing: 0.02em;
   }
   .meta-container-cell p {
     margin: 0;
-  } 
+  }
   .authors {
     margin: 0;
     list-style-type: none;
     padding-left: 0;
+    display: flex;
+    flex-wrap: wrap;
+  }
+  .authors li {
+    white-space: nowrap;
+    margin-right: 4px;
   }
   .affiliations {
     margin: 0;
@@ -227,12 +296,17 @@ const pdfFilename = `${slugify(pdfBase)}.pdf`;
     flex-wrap: wrap;
     row-gap: 12px;
   }
-  
+
+  @media (max-width: 768px) {
+    .meta-container-cell--affiliations,
+    .meta-container-cell--pdf {
+      text-align: right;
+    }
+  }
+
   @media print {
     .meta-container-cell--pdf {
       display: none !important;
     }
   }
 </style>
-
-

app/src/components/HtmlEmbed.astro

@@ -20,12 +20,15 @@ const html = resolveFragment(src);
 const mountId = `frag-${Math.random().toString(36).slice(2)}`;
 const dataAttr = Array.isArray(data) ? JSON.stringify(data) : (typeof data === 'string' ? data : undefined);
 const configAttr = typeof config === 'string' ? config : (config != null ? JSON.stringify(config) : undefined);
+
+// Apply the ID to the HTML content if provided
+const htmlWithId = id && html ? html.replace(/<div class="([^"]*)"[^>]*>/, `<div class="$1" id="${id}">`) : html;
 ---
 { html ? (
   <figure class="html-embed" id={id}>
     {title && <figcaption class="html-embed__title" style={`text-align:${align}`}>{title}</figcaption>}
     <div class={`html-embed__card${frameless ? ' is-frameless' : ''}`}>
-      <div id={mountId} data-datafiles={dataAttr} data-config={configAttr} set:html={html} />
+      <div id={mountId} data-datafiles={dataAttr} data-config={configAttr} set:html={htmlWithId} />
     </div>
     {desc && <figcaption class="html-embed__desc" style={`text-align:${align}`} set:html={desc}></figcaption>}
   </figure>
@@ -70,7 +73,6 @@ const configAttr = typeof config === 'string' ? config : (config != null ? JSON.
   .html-embed { margin: 0 0 var(--block-spacing-y);
     z-index: var(--z-elevated);
     position: relative;
-  
   }
   .html-embed__title { 
     text-align: left; 
@@ -83,12 +85,14 @@ const configAttr = typeof config === 'string' ? config : (config != null ? JSON.
     position: relative;
     display: block;
     width: 100%;
+    background: var(--page-bg);
+    z-index: var(--z-elevated);
   }
   .html-embed__card {
     background: var(--code-bg);
     border: 1px solid var(--border-color);
     border-radius: 10px;
-    padding: 8px;
+    padding: 24px;
     z-index: calc(var(--z-elevated) + 1);
     position: relative;
   }
@@ -108,6 +112,7 @@ const configAttr = typeof config === 'string' ? config : (config != null ? JSON.
     z-index: var(--z-elevated);
     display: block;
     width: 100%;
+    background: var(--page-bg);
   }
   /* Plotly – fragments & controls */
   .html-embed__card svg text { fill: var(--text-color); }

app/src/components/Sidenote.astro

@@ -14,28 +14,38 @@
 
     containers.forEach((container) => {
       // Find the previous element (sibling just before)
-      const previousElement = container.previousElementSibling;
+      const previousElement = container.previousElementSibling as HTMLElement;
 
-      if (previousElement) {
-        // Make the sidenote container relative to the previous element
-        previousElement.style.position = "relative";
+      if (previousElement && previousElement.parentNode) {
+        // Create a wrapper div that will contain both the previous element and the sidenote
+        const wrapper = document.createElement("div");
+        wrapper.className = "sidenote-wrapper";
 
-        // Move the sidenote container as child of the previous element
-        previousElement.appendChild(container);
+        // Insert the wrapper before the previous element
+        previousElement.parentNode.insertBefore(wrapper, previousElement);
 
-        // Style the container so it positions correctly
-        container.style.position = "absolute";
-        container.style.top = "0";
-        container.style.right = "-292px"; // 260px width + 32px gap
-        container.style.width = "260px";
+        // Move both the previous element and the sidenote container into the wrapper
+        wrapper.appendChild(previousElement);
+        wrapper.appendChild(container);
+
+        // Style the wrapper to create the layout
+        wrapper.style.position = "relative";
+        wrapper.style.display = "block";
+
+        // Style the sidenote container so it positions correctly
+        const sidenoteContainer = container as HTMLElement;
+        sidenoteContainer.style.position = "absolute";
+        sidenoteContainer.style.top = "0";
+        sidenoteContainer.style.right = "-292px"; // 260px width + 32px gap
+        sidenoteContainer.style.width = "260px";
 
         // Display the container with a fade-in
-        container.style.display = "block";
-        container.style.opacity = "0";
+        sidenoteContainer.style.display = "block";
+        sidenoteContainer.style.opacity = "0";
 
         // Fade-in with transition
         setTimeout(() => {
-          container.style.opacity = "1";
+          sidenoteContainer.style.opacity = "1";
         }, 10);
       }
     });
@@ -43,10 +53,16 @@
 </script>
 
 <style is:global>
+  .sidenote-wrapper {
+    /* Le wrapper contient l'élément original et le sidenote */
+    position: relative;
+    display: block;
+  }
+
   .sidenote-container {
     /* Caché par défaut, sera affiché par JS */
     display: none;
-    margin: 0 ;
+    margin: 0;
     /* Transition for fade-in */
     transition: opacity 0.3s ease-in-out;
   }
@@ -60,6 +76,11 @@
   }
 
   @media (--bp-content-collapse) {
+    .sidenote-wrapper {
+      /* Sur mobile, le wrapper n'a pas besoin de position relative */
+      position: static !important;
+    }
+
     .sidenote-container {
       position: static !important;
       width: auto !important;

app/src/styles/_layout.css

@@ -13,12 +13,16 @@
   align-items: start;
 }
 
-.content-grid > main {
+.content-grid>main {
   max-width: 100%;
   margin: 0;
   padding: 0;
 }
 
+.content-grid>main>*:first-child {
+  margin-top: 0;
+}
+
 @media (--bp-content-collapse) {
   .content-grid {
     overflow: hidden;
@@ -44,7 +48,7 @@
     gap: 16px;
   }
 
-  .footer-inner > h3 {
+  .footer-inner>h3 {
     grid-column: auto;
     margin-top: 16px;
   }
@@ -74,6 +78,9 @@
   width: min(1100px, 100vw - var(--content-padding-x) * 2);
   margin-left: 50%;
   transform: translateX(-50%);
+  padding: var(--content-padding-x);
+  border-radius: var(--button-radius);
+  background-color: var(--page-bg);
 }
 
 .full-width {
@@ -84,11 +91,13 @@
 }
 
 @media (--bp-content-collapse) {
+
   .wide,
   .full-width {
     width: 100%;
     margin-left: 0;
     margin-right: 0;
+    padding: 0;
     transform: none;
   }
 }
@@ -118,6 +127,7 @@
     max-width: 100%;
     padding: 0 var(--spacing-4);
   }
+
   header.meta .meta-container .meta-container-cell {
     flex: 1 1 calc(50% - 8px);
     min-width: 0;
@@ -129,12 +139,14 @@
     flex-basis: 100%;
     text-align: center;
   }
+
   /* Center ordered list numbers within meta (e.g., affiliations) */
   header.meta .affiliations {
     list-style-position: inside;
     padding-left: 0;
     margin-left: 0;
   }
+
   header.meta .affiliations li {
     text-align: center;
   }
@@ -160,7 +172,4 @@
     width: 100%;
     min-width: 0;
   }
-}
-
-
-
+}

app/src/styles/_variables.css

@@ -109,11 +109,10 @@
   --grid-color: rgba(255, 255, 255, .10);
 
   /* Primary (lower L in dark) */
-  --primary-color: oklch(from var(--primary-base) calc(l - 0.08) c 100);
   --primary-color-hover: oklch(from var(--primary-color) calc(l - 0.05) c h);
   --primary-color-active: oklch(from var(--primary-color) calc(l - 0.10) c h);
   --on-primary: #0f1115;
 
   color-scheme: dark;
-  background: #0f1115;
+  background: var(--page-bg);
 }

app/src/styles/components/_form.css

@@ -5,7 +5,7 @@
 /* Select styling with modern chevron */
 select {
   background-color: var(--page-bg);
-  border: 1px solid var(--border-color);
+  border: 1px solid color-mix(in srgb, var(--primary-color) 50%, var(--border-color));
   border-radius: var(--button-radius);
   padding: var(--button-padding-y) var(--button-padding-x) var(--button-padding-y) var(--button-padding-x);
   font-family: var(--default-font-family);
@@ -13,13 +13,18 @@ select {
   color: var(--text-color);
   background-image: url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 12 12'%3E%3Cpath fill='%23666' d='M6 8.825L1.175 4 2.35 2.825 6 6.475 9.65 2.825 10.825 4z'/%3E%3C/svg%3E");
   background-repeat: no-repeat;
-  background-position: right calc(var(--button-padding-x) + 14px) center;
+  background-position: right calc(var(--button-padding-x) + 2px) center;
   background-size: 12px;
   cursor: pointer;
   transition: border-color 0.2s ease, box-shadow 0.2s ease;
+  -webkit-appearance: none;
+  -moz-appearance: none;
+  appearance: none;
 }
 
-select:hover, select:focus, select:active {
+select:hover,
+select:focus,
+select:active {
   border-color: var(--primary-color);
 }
 
@@ -238,4 +243,4 @@ div[class*="flex"] label,
 .theme-selector label {
   margin-bottom: 0 !important;
   align-self: center;
-}
+}

app/src/styles/components/_table.css

@@ -1,98 +1,126 @@
 .content-grid main table {
-    border-collapse: collapse;
-    table-layout: auto;
-    margin: 0;
-  }
-  .content-grid main th, .content-grid main td {
-    border-bottom: 1px solid var(--border-color);
-    padding: 6px 8px;
-    text-align: left;
-    font-size: 15px;
-    white-space: nowrap; /* prevent squashing; allow horizontal scroll instead */
-  }
-  .content-grid main thead th { border-bottom: 1px solid var(--border-color); }
-  .content-grid main thead th {
-    border-bottom: 1px solid var(--border-color);
-  }
-  .content-grid main thead th {
-    background: var(--table-header-bg);
-    padding-top: 10px;
-    padding-bottom: 10px;
-    font-weight: 600;
-  }
-  
-  .content-grid main hr {
-    border: none;
-    border-bottom: 1px solid var(--border-color);
-    margin: var(--spacing-5) 0;
-  }
-  
-  /* Scroll wrapper: keeps table 100% width but enables horizontal scroll when needed */
-  .content-grid main .table-scroll {
-    width: 100%;
-    overflow-x: auto;
-    -webkit-overflow-scrolling: touch;
-    border: 1px solid var(--border-color);
-    border-radius: var(--table-border-radius);
-    background: var(--surface-bg);
-    margin: 0 0 var(--block-spacing-y);
-  }
-  .content-grid main .table-scroll > table {
-    width: fit-content;
+  border-collapse: collapse;
+  table-layout: auto;
+  margin: 0;
+}
+
+.content-grid main th,
+.content-grid main td {
+  border-bottom: 1px solid var(--border-color);
+  padding: 6px 8px;
+  text-align: left;
+  font-size: 15px;
+  white-space: nowrap;
+  /* prevent squashing; allow horizontal scroll instead */
+  word-break: auto-phrase;
+  white-space: break-spaces;
+  vertical-align: top;
+}
+
+.content-grid main th:last-child,
+.content-grid main td:last-child {
+  text-align: right;
+}
+
+.content-grid main thead th {
+  border-bottom: 1px solid var(--border-color);
+}
+
+.content-grid main thead th {
+  border-bottom: 1px solid var(--border-color);
+}
+
+.content-grid main thead th {
+  background: var(--table-header-bg);
+  padding-top: 10px;
+  padding-bottom: 10px;
+  font-weight: 600;
+}
+
+.content-grid main hr {
+  border: none;
+  border-bottom: 1px solid var(--border-color);
+  margin: var(--spacing-5) 0;
+}
+
+/* Scroll wrapper: keeps table 100% width but enables horizontal scroll when needed */
+.content-grid main .table-scroll {
+  width: 100%;
+  overflow-x: auto;
+  -webkit-overflow-scrolling: touch;
+  border: 1px solid var(--border-color);
+  border-radius: var(--table-border-radius);
+  background: var(--surface-bg);
+  margin: 0 0 var(--block-spacing-y);
+}
+
+.content-grid main .table-scroll>table {
+  width: fit-content;
+  min-width: 100%;
+  max-width: none;
+}
+
+/* Vertical dividers between columns (no outer right border) */
+.content-grid main .table-scroll>table th,
+.content-grid main .table-scroll>table td {
+  border-right: 1px solid var(--border-color);
+}
+
+.content-grid main .table-scroll>table th:last-child,
+.content-grid main .table-scroll>table td:last-child {
+  border-right: none;
+}
+
+.content-grid main .table-scroll>table thead th:first-child {
+  border-top-left-radius: var(--table-border-radius);
+}
+
+.content-grid main .table-scroll>table thead th:last-child {
+  border-top-right-radius: var(--table-border-radius);
+}
+
+.content-grid main .table-scroll>table tbody tr:last-child td:first-child {
+  border-bottom-left-radius: var(--table-border-radius);
+}
+
+.content-grid main .table-scroll>table tbody tr:last-child td:last-child {
+  border-bottom-right-radius: var(--table-border-radius);
+}
+
+/* Zebra striping for odd rows */
+.content-grid main .table-scroll>table tbody tr:nth-child(odd) td {
+  background: var(--table-row-odd-bg);
+}
+
+/* Remove bottom border on last row */
+.content-grid main .table-scroll>table tbody tr:last-child td {
+  border-bottom: none;
+}
+
+/* Accordion context: remove outer borders/radius and fit content flush */
+.accordion .accordion__content .table-scroll {
+  border: none;
+  border-radius: 0;
+  margin: 0;
+  margin-bottom: 0 !important;
+}
+
+/* Ensure no bottom margin even if table isn't wrapped (fallback) */
+.accordion .accordion__content table {
+  margin: 0 !important;
+}
+
+.accordion .accordion__content .table-scroll>table thead th:first-child,
+.accordion .accordion__content .table-scroll>table thead th:last-child,
+.accordion .accordion__content .table-scroll>table tbody tr:last-child td:first-child,
+.accordion .accordion__content .table-scroll>table tbody tr:last-child td:last-child {
+  border-radius: 0;
+}
+
+/* Fallback for browsers without fit-content support */
+@supports not (width: fit-content) {
+  .content-grid main .table-scroll>table {
+    width: max-content;
     min-width: 100%;
-    max-width: none;
-  }
-  /* Vertical dividers between columns (no outer right border) */
-  .content-grid main .table-scroll > table th,
-  .content-grid main .table-scroll > table td {
-    border-right: 1px solid var(--border-color);
-  }
-  .content-grid main .table-scroll > table th:last-child,
-  .content-grid main .table-scroll > table td:last-child {
-    border-right: none;
-  }
-  .content-grid main .table-scroll > table thead th:first-child {
-    border-top-left-radius: var(--table-border-radius);
-  }
-  .content-grid main .table-scroll > table thead th:last-child {
-    border-top-right-radius: var(--table-border-radius);
-  }
-  .content-grid main .table-scroll > table tbody tr:last-child td:first-child {
-    border-bottom-left-radius: var(--table-border-radius);
-  }
-  .content-grid main .table-scroll > table tbody tr:last-child td:last-child {
-    border-bottom-right-radius: var(--table-border-radius);
-  }
-  /* Zebra striping for odd rows */
-  .content-grid main .table-scroll > table tbody tr:nth-child(odd) td {
-    background: var(--table-row-odd-bg);
-  }
-  /* Remove bottom border on last row */
-  .content-grid main .table-scroll > table tbody tr:last-child td {
-    border-bottom: none;
-  }
-  
-  /* Accordion context: remove outer borders/radius and fit content flush */
-  .accordion .accordion__content .table-scroll {
-    border: none;
-    border-radius: 0;
-    margin: 0;
-    margin-bottom: 0 !important;
-  }
-  /* Ensure no bottom margin even if table isn't wrapped (fallback) */
-  .accordion .accordion__content table { margin: 0 !important; }
-  .accordion .accordion__content .table-scroll > table thead th:first-child,
-  .accordion .accordion__content .table-scroll > table thead th:last-child,
-  .accordion .accordion__content .table-scroll > table tbody tr:last-child td:first-child,
-  .accordion .accordion__content .table-scroll > table tbody tr:last-child td:last-child {
-    border-radius: 0;
-  }
-  
-  /* Fallback for browsers without fit-content support */
-  @supports not (width: fit-content) {
-    .content-grid main .table-scroll > table {
-      width: max-content;
-      min-width: 100%;
-    }
   }
-  
+}

tools/duplicated-spaces/README.md

@@ -1,32 +0,0 @@
-# duplicated-spaces
-
-Small Poetry project to list public Spaces created in the last N days that were duplicated from a given source Space.
-
-## Setup
-
-```bash
-cd tools/duplicated-spaces
-poetry install --no-root
-```
-
-Optionally export your token:
-
-```bash
-export HF_TOKEN=hf_xxx
-```
-
-## Usage
-
-```bash
-poetry run find-duplicated-spaces --source owner/space-name --days 14
-```
-
-Options:
-- `--source`: required. The source Space in the form `owner/space-name`.
-- `--days`: optional. Time window in days (default: 14).
-- `--token`: optional. Your HF token. Defaults to `HF_TOKEN` env var if set.
-- `--no-deep`: optional. Disable README/frontmatter fallback detection.
-
-The tool checks card metadata and may fallback to README frontmatter parsing for robustness.
-
-

tools/duplicated-spaces/duplicated_spaces/__init__.py

@@ -1,5 +0,0 @@
-from .finder import find_duplicated_spaces
-
-__all__ = ["find_duplicated_spaces"]
-
-

tools/duplicated-spaces/duplicated_spaces/cli.py

@@ -1,69 +0,0 @@
-from __future__ import annotations
-
-import argparse
-import os
-from typing import Optional
-
-from huggingface_hub import HfApi
-
-from .finder import find_duplicated_spaces
-
-
-def build_parser() -> argparse.ArgumentParser:
-    parser = argparse.ArgumentParser(
-        description="List recent Spaces duplicated from a given Space"
-    )
-    parser.add_argument(
-        "--source",
-        required=True,
-        help="Source Space in the form 'owner/space-name'",
-    )
-    parser.add_argument(
-        "--days",
-        type=int,
-        default=14,
-        help="Time window in days (default: 14)",
-    )
-    parser.add_argument(
-        "--token",
-        default=os.environ.get("HF_TOKEN"),
-        help="Hugging Face token (optional). Defaults to HF_TOKEN env var if set.",
-    )
-    parser.add_argument(
-        "--no-deep",
-        action="store_true",
-        help=(
-            "Disable deep detection (README/frontmatter fetch) when card metadata is missing."
-        ),
-    )
-    return parser
-
-
-def main(argv: Optional[list[str]] = None) -> None:
-    parser = build_parser()
-    args = parser.parse_args(argv)
-
-    api = HfApi(token=args.token)
-    duplicated = find_duplicated_spaces(
-        api=api,
-        source=args.source,
-        days=args.days,
-        deep_detection=not args.no_deep,
-    )
-
-    if duplicated:
-        print(
-            f"Found {len(duplicated)} Space(s) duplicated from {args.source} in the last {args.days} days:\n"
-        )
-        for sid in duplicated:
-            print(f"https://huggingface.co/spaces/{sid}")
-    else:
-        print(
-            f"No public Spaces duplicated from {args.source} in the last {args.days} days."
-        )
-
-
-if __name__ == "__main__":
-    main()
-
-

tools/duplicated-spaces/duplicated_spaces/finder.py

@@ -1,99 +0,0 @@
-from __future__ import annotations
-
-"""
-Core logic to find Spaces duplicated from a given source within a time window.
-Comments are in English (per user preference for code comments).
-"""
-
-from datetime import datetime, timedelta, timezone
-from typing import Iterable, List, Optional
-
-import requests
-from huggingface_hub import HfApi
-
-
-def iso_to_datetime(value: str) -> datetime:
-    """Parse ISO 8601 timestamps returned by the Hub to aware datetime in UTC."""
-    try:
-        dt = datetime.strptime(value, "%Y-%m-%dT%H:%M:%S.%fZ")
-    except ValueError:
-        dt = datetime.strptime(value, "%Y-%m-%dT%H:%M:%SZ")
-    return dt.replace(tzinfo=timezone.utc)
-
-
-def readme_frontmatter_duplicated_from(space_id: str) -> Optional[str]:
-    """Fetch README raw and try to extract duplicated_from from YAML frontmatter."""
-    url = f"https://huggingface.co/spaces/{space_id}/raw/README.md"
-    try:
-        resp = requests.get(url, timeout=10)
-        if resp.status_code != 200:
-            return None
-        text = resp.text
-    except requests.RequestException:
-        return None
-
-    lines = text.splitlines()
-    in_frontmatter = False
-    for line in lines:
-        if line.strip() == "---":
-            in_frontmatter = not in_frontmatter
-            if not in_frontmatter:
-                break
-            continue
-        if in_frontmatter and line.strip().startswith("duplicated_from:"):
-            value = line.split(":", 1)[1].strip().strip("'\"")
-            return value or None
-    return None
-
-
-def get_recent_spaces(api: HfApi, days: int) -> Iterable:
-    """Yield Spaces created within the last `days` days, iterating newest first if possible."""
-    cutoff = datetime.now(timezone.utc) - timedelta(days=days)
-    try:
-        spaces_iter = api.list_spaces(full=True, sort="created", direction=-1)
-    except TypeError:
-        spaces_iter = api.list_spaces(full=True)
-
-    for space in spaces_iter:
-        created_at_raw = getattr(space, "created_at", None) or getattr(space, "createdAt", None)
-        if not created_at_raw:
-            yield space
-            continue
-        created_at = (
-            created_at_raw if isinstance(created_at_raw, datetime) else iso_to_datetime(str(created_at_raw))
-        )
-        if created_at >= cutoff:
-            yield space
-        else:
-            # We cannot guarantee sort order when falling back; continue to be safe.
-            continue
-
-
-def find_duplicated_spaces(api: HfApi, source: str, days: int, deep_detection: bool) -> List[str]:
-    """Return list of Space IDs that were duplicated from `source` within `days`."""
-    source = source.strip().strip("/ ")
-    results: List[str] = []
-    for space in get_recent_spaces(api, days=days):
-        space_id = getattr(space, "id", None) or getattr(space, "repo_id", None)
-        if not space_id:
-            continue
-
-        card = getattr(space, "cardData", None) or getattr(space, "card_data", None)
-        duplicated_from_value: Optional[str] = None
-        if isinstance(card, dict):
-            for key in ("duplicated_from", "duplicatedFrom", "duplicated-from"):
-                if key in card and isinstance(card[key], str):
-                    duplicated_from_value = card[key].strip().strip("/ ")
-                    break
-
-        if not duplicated_from_value and deep_detection:
-            duplicated_from_value = readme_frontmatter_duplicated_from(space_id)
-            if duplicated_from_value:
-                duplicated_from_value = duplicated_from_value.strip().strip("/ ")
-
-        if duplicated_from_value and duplicated_from_value.lower() == source.lower():
-            results.append(space_id)
-
-    return results
-
-

tools/duplicated-spaces/pyproject.toml

@@ -1,23 +0,0 @@
-[tool.poetry]
-name = "duplicated-spaces"
-version = "0.1.0"
-description = "Find recent Hugging Face Spaces duplicated from a given Space"
-authors = ["thibaud frere <>"]
-readme = "README.md"
-packages = [{ include = "duplicated_spaces" }]
-
-[tool.poetry.dependencies]
-python = ">=3.9,<4.0"
-huggingface_hub = "^0.24.0"
-requests = "^2.31.0"
-
-[tool.poetry.group.dev.dependencies]
-
-[tool.poetry.scripts]
-find-duplicated-spaces = "duplicated_spaces.cli:main"
-
-[build-system]
-requires = ["poetry-core>=1.7.0"]
-build-backend = "poetry.core.masonry.api"
-
-