skrypt-ai 0.4.2 → 0.5.0

package/dist/importers/transform.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Mintlify: <Note>content</Note>, <Warning>, <Tip>, <Info>, <Check>
+ */
+export declare function transformMintlifyCallouts(content: string): string;
+/**
+ * Docusaurus: :::note[Title]\ncontent\n:::
+ */
+export declare function transformDocusaurusAdmonitions(content: string): string;
+/**
+ * GitBook: {% hint style="info" %}\ncontent\n{% endhint %}
+ */
+export declare function transformGitBookHints(content: string): string;
+/**
+ * ReadMe RDMD: > 📘 Title\n> content lines
+ */
+export declare function transformReadmeCallouts(content: string): string;
+/**
+ * Notion: <aside>content</aside> and :::callout
+ */
+export declare function transformNotionCallouts(content: string): string;
+/**
+ * Confluence: <ac:structured-macro ac:name="info">...<ac:rich-text-body>content</ac:rich-text-body>
+ */
+export declare function transformConfluenceCallouts(content: string): string;
+/**
+ * Mintlify: <Tabs><Tab title="X">content</Tab></Tabs>
+ */
+export declare function transformMintlifyTabs(content: string): string;
+/**
+ * Docusaurus: <Tabs><TabItem value="x" label="X">content</TabItem></Tabs>
+ */
+export declare function transformDocusaurusTabs(content: string): string;
+/**
+ * GitBook: {% tabs %}{% tab title="X" %}content{% endtab %}{% endtabs %}
+ */
+export declare function transformGitBookTabs(content: string): string;
+/**
+ * ReadMe [block:code] JSON → <CodeGroup>
+ */
+export declare function transformReadmeCodeBlocks(content: string): string;
+/**
+ * GitBook: {% stepper %}{% step %}...{% endstep %}{% endstepper %}
+ */
+export declare function transformGitBookSteps(content: string): string;
+/**
+ * GitBook: {% expandable title="X" %}content{% endexpandable %}
+ */
+export declare function transformGitBookExpandable(content: string): string;
+/**
+ * GitBook: {% content-ref url="path" %} → markdown link
+ */
+export declare function transformGitBookContentRef(content: string): string;
+/**
+ * GitBook: {% embed url="..." %} → plain URL
+ */
+export declare function transformGitBookEmbed(content: string): string;
+/**
+ * Notion: <details><summary>Title</summary>content</details> → <Accordion>
+ */
+export declare function transformNotionToggles(content: string): string;
+/**
+ * Confluence: Convert common HTML and AC macros to markdown
+ */
+export declare function transformConfluenceHtml(content: string): string;
+/**
+ * Docusaurus: Strip import ... from '@theme/...' statements
+ */
+export declare function stripDocusaurusImports(content: string): string;
+interface FrontmatterDefaults {
+    title?: string;
+    description?: string;
+}
+/**
+ * Normalize frontmatter fields to Skrypt format
+ */
+export declare function normalizeFrontmatter(content: string, defaults?: FrontmatterDefaults): string;
+/**
+ * Rewrite image paths based on asset copy mapping
+ */
+export declare function rewriteImagePaths(content: string, mapping: Map<string, string>): string;
+/**
+ * Strip 32-char hex UUID suffixes from Notion filenames
+ * e.g., "Getting Started a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4.md" → "Getting Started.md"
+ */
+export declare function stripNotionUUIDs(filename: string): string;
+/**
+ * Get sorting weight from frontmatter
+ */
+export declare function getSortWeight(content: string): number;
+export {};

package/dist/importers/transform.js

@@ -0,0 +1,457 @@
+// ============================================================
+// Content Transformation Engine
+// Composable string→string transforms for all platform syntaxes
+// ============================================================
+// --- Callout Transforms ---
+const MINTLIFY_CALLOUT_MAP = {
+    Note: 'note',
+    Warning: 'warning',
+    Tip: 'tip',
+    Info: 'info',
+    Check: 'success',
+};
+/**
+ * Mintlify: <Note>content</Note>, <Warning>, <Tip>, <Info>, <Check>
+ */
+export function transformMintlifyCallouts(content) {
+    for (const [tag, type] of Object.entries(MINTLIFY_CALLOUT_MAP)) {
+        const regex = new RegExp(`<${tag}>([\\s\\S]*?)<\\/${tag}>`, 'g');
+        content = content.replace(regex, `<Callout type="${type}">$1</Callout>`);
+    }
+    return content;
+}
+const DOCUSAURUS_ADMONITION_MAP = {
+    note: 'note',
+    tip: 'tip',
+    info: 'info',
+    caution: 'warning',
+    danger: 'error',
+    warning: 'warning',
+};
+/**
+ * Docusaurus: :::note[Title]\ncontent\n:::
+ */
+export function transformDocusaurusAdmonitions(content) {
+    return content.replace(/:::(note|tip|info|caution|danger|warning)(?:\[(.+?)\])?\n([\s\S]*?):::/g, (_match, type, title, body) => {
+        const calloutType = DOCUSAURUS_ADMONITION_MAP[type] || 'info';
+        const titleAttr = title ? ` title="${title}"` : '';
+        return `<Callout type="${calloutType}"${titleAttr}>${body}</Callout>`;
+    });
+}
+const GITBOOK_HINT_MAP = {
+    info: 'info',
+    warning: 'warning',
+    danger: 'error',
+    success: 'success',
+    tip: 'tip',
+};
+/**
+ * GitBook: {% hint style="info" %}\ncontent\n{% endhint %}
+ */
+export function transformGitBookHints(content) {
+    return content.replace(/\{%\s*hint\s+style="(\w+)"\s*%\}([\s\S]*?)\{%\s*endhint\s*%\}/g, (_match, style, body) => {
+        const calloutType = GITBOOK_HINT_MAP[style] || 'info';
+        return `<Callout type="${calloutType}">${body.trim()}</Callout>`;
+    });
+}
+const README_EMOJI_MAP = {
+    '\u{1F4D8}': 'info', // 📘
+    '\u{2139}\uFE0F': 'info', // ℹ️
+    '\u{1F44D}': 'success', // 👍
+    '\u{2705}': 'success', // ✅
+    '\u{1F6A7}': 'warning', // 🚧
+    '\u{26A0}\uFE0F': 'warning', // ⚠️
+    '\u{2757}': 'error', // ❗
+    '\u{1F6D1}': 'error', // 🛑
+};
+/**
+ * ReadMe RDMD: > 📘 Title\n> content lines
+ */
+export function transformReadmeCallouts(content) {
+    // Modern RDMD emoji format
+    const emojiPattern = Object.keys(README_EMOJI_MAP).join('|');
+    const rdmdRegex = new RegExp(`> (${emojiPattern}) (.+)\\n((?:> .+\\n?)*)`, 'g');
+    content = content.replace(rdmdRegex, (_match, emoji, title, bodyLines) => {
+        const type = README_EMOJI_MAP[emoji] || 'info';
+        const body = bodyLines.replace(/^> /gm, '').trim();
+        return `<Callout type="${type}" title="${title}">\n${body}\n</Callout>`;
+    });
+    // Legacy [block:callout] format
+    content = content.replace(/\[block:callout\]\n?([\s\S]*?)\n?\[\/block\]/g, (_match, jsonStr) => {
+        try {
+            const data = JSON.parse(jsonStr);
+            const type = data.type === 'warning' ? 'warning' :
+                data.type === 'danger' ? 'error' :
+                    data.type === 'success' ? 'success' : 'info';
+            const titleAttr = data.title ? ` title="${data.title}"` : '';
+            return `<Callout type="${type}"${titleAttr}>\n${data.body || ''}\n</Callout>`;
+        }
+        catch {
+            return _match; // leave as-is if JSON parse fails
+        }
+    });
+    return content;
+}
+/**
+ * Notion: <aside>content</aside> and :::callout
+ */
+export function transformNotionCallouts(content) {
+    // <aside> blocks
+    content = content.replace(/<aside>([\s\S]*?)<\/aside>/g, (_match, body) => {
+        // Strip common Notion emoji prefixes (single codepoint emojis + variation selectors)
+        const cleaned = body.replace(/^[\s\n]*(?:☝️|💡|⚠️|❗|📌|🔥|✨|🎯|📝)\s*/u, '').trim();
+        return `<Callout type="info">${cleaned}</Callout>`;
+    });
+    // :::callout blocks (Notion API export format)
+    content = content.replace(/:::callout([\s\S]*?):::/g, (_match, body) => `<Callout type="info">${body.trim()}</Callout>`);
+    return content;
+}
+/**
+ * Confluence: <ac:structured-macro ac:name="info">...<ac:rich-text-body>content</ac:rich-text-body>
+ */
+export function transformConfluenceCallouts(content) {
+    return content.replace(/<ac:structured-macro[^>]*ac:name="(info|note|warning|tip)"[^>]*>[\s\S]*?<ac:rich-text-body>([\s\S]*?)<\/ac:rich-text-body>[\s\S]*?<\/ac:structured-macro>/g, (_match, type, body) => {
+        const cleaned = stripHtmlTags(body).trim();
+        return `<Callout type="${type}">${cleaned}</Callout>`;
+    });
+}
+// --- Tabs Transforms ---
+/**
+ * Mintlify: <Tabs><Tab title="X">content</Tab></Tabs>
+ */
+export function transformMintlifyTabs(content) {
+    return content.replace(/<Tabs>([\s\S]*?)<\/Tabs>/g, (_match, inner) => {
+        const tabs = [];
+        const tabRegex = /<Tab\s+title="([^"]+)">([\s\S]*?)<\/Tab>/g;
+        let tabMatch;
+        while ((tabMatch = tabRegex.exec(inner)) !== null) {
+            tabs.push({ title: tabMatch[1], content: tabMatch[2] });
+        }
+        if (tabs.length === 0)
+            return _match;
+        const defaultValue = tabs[0].title;
+        const tabList = tabs.map(t => `  <Tab value="${t.title}">${t.title}</Tab>`).join('\n');
+        const panels = tabs.map(t => `<TabPanel value="${t.title}">${t.content}</TabPanel>`).join('\n');
+        return `<Tabs defaultValue="${defaultValue}">\n<TabList>\n${tabList}\n</TabList>\n${panels}\n</Tabs>`;
+    });
+}
+/**
+ * Docusaurus: <Tabs><TabItem value="x" label="X">content</TabItem></Tabs>
+ */
+export function transformDocusaurusTabs(content) {
+    return content.replace(/<Tabs[^>]*>([\s\S]*?)<\/Tabs>/g, (_match, inner) => {
+        const tabs = [];
+        const tabRegex = /<TabItem\s+value="([^"]+)"(?:\s+label="([^"]*)")?>([\s\S]*?)<\/TabItem>/g;
+        let tabMatch;
+        while ((tabMatch = tabRegex.exec(inner)) !== null) {
+            tabs.push({ value: tabMatch[1], label: tabMatch[2] || tabMatch[1], content: tabMatch[3] });
+        }
+        if (tabs.length === 0)
+            return _match;
+        const defaultValue = tabs[0].value;
+        const tabList = tabs.map(t => `  <Tab value="${t.value}">${t.label}</Tab>`).join('\n');
+        const panels = tabs.map(t => `<TabPanel value="${t.value}">${t.content}</TabPanel>`).join('\n');
+        return `<Tabs defaultValue="${defaultValue}">\n<TabList>\n${tabList}\n</TabList>\n${panels}\n</Tabs>`;
+    });
+}
+/**
+ * GitBook: {% tabs %}{% tab title="X" %}content{% endtab %}{% endtabs %}
+ */
+export function transformGitBookTabs(content) {
+    return content.replace(/\{%\s*tabs\s*%\}([\s\S]*?)\{%\s*endtabs\s*%\}/g, (_match, inner) => {
+        const tabs = [];
+        const tabRegex = /\{%\s*tab\s+title="([^"]+)"\s*%\}([\s\S]*?)\{%\s*endtab\s*%\}/g;
+        let tabMatch;
+        while ((tabMatch = tabRegex.exec(inner)) !== null) {
+            tabs.push({ title: tabMatch[1], content: tabMatch[2].trim() });
+        }
+        if (tabs.length === 0)
+            return _match;
+        const defaultValue = tabs[0].title;
+        const tabList = tabs.map(t => `  <Tab value="${t.title}">${t.title}</Tab>`).join('\n');
+        const panels = tabs.map(t => `<TabPanel value="${t.title}">\n${t.content}\n</TabPanel>`).join('\n');
+        return `<Tabs defaultValue="${defaultValue}">\n<TabList>\n${tabList}\n</TabList>\n${panels}\n</Tabs>`;
+    });
+}
+/**
+ * ReadMe [block:code] JSON → <CodeGroup>
+ */
+export function transformReadmeCodeBlocks(content) {
+    return content.replace(/\[block:code\]\n?([\s\S]*?)\n?\[\/block\]/g, (_match, jsonStr) => {
+        try {
+            const data = JSON.parse(jsonStr);
+            if (!data.codes || !Array.isArray(data.codes))
+                return _match;
+            if (data.codes.length === 1) {
+                const c = data.codes[0];
+                const lang = c.language || '';
+                const name = c.name ? ` ${c.name}` : '';
+                return `\`\`\`${lang}${name}\n${c.code}\n\`\`\``;
+            }
+            const blocks = data.codes.map((c) => {
+                const lang = c.language || '';
+                const name = c.name ? ` ${c.name}` : '';
+                return `\`\`\`${lang}${name}\n${c.code || ''}\n\`\`\``;
+            }).join('\n\n');
+            return `<CodeGroup>\n\n${blocks}\n\n</CodeGroup>`;
+        }
+        catch {
+            return _match;
+        }
+    });
+}
+// --- Other Component Transforms ---
+/**
+ * GitBook: {% stepper %}{% step %}...{% endstep %}{% endstepper %}
+ */
+export function transformGitBookSteps(content) {
+    return content.replace(/\{%\s*stepper\s*%\}([\s\S]*?)\{%\s*endstepper\s*%\}/g, (_match, inner) => {
+        const steps = inner.split(/\{%\s*step\s*%\}/).filter(s => s.trim());
+        const mapped = steps.map(step => {
+            const body = step.replace(/\{%\s*endstep\s*%\}/g, '').trim();
+            return `<Step>\n${body}\n</Step>`;
+        }).join('\n');
+        return `<Steps>\n${mapped}\n</Steps>`;
+    });
+}
+/**
+ * GitBook: {% expandable title="X" %}content{% endexpandable %}
+ */
+export function transformGitBookExpandable(content) {
+    return content.replace(/\{%\s*expandable\s+title="([^"]+)"\s*%\}([\s\S]*?)\{%\s*endexpandable\s*%\}/g, (_match, title, body) => `<Accordion title="${title}">\n${body.trim()}\n</Accordion>`);
+}
+/**
+ * GitBook: {% content-ref url="path" %} → markdown link
+ */
+export function transformGitBookContentRef(content) {
+    return content.replace(/\{%\s*content-ref\s+url="([^"]+)"\s*%\}[\s\S]*?\{%\s*endcontent-ref\s*%\}/g, (_match, url) => {
+        const label = url.replace(/\.md$/, '').split('/').pop() || url;
+        return `[${label}](${url})`;
+    });
+}
+/**
+ * GitBook: {% embed url="..." %} → plain URL
+ */
+export function transformGitBookEmbed(content) {
+    return content.replace(/\{%\s*embed\s+url="([^"]+)"\s*%\}/g, (_match, url) => url);
+}
+/**
+ * Notion: <details><summary>Title</summary>content</details> → <Accordion>
+ */
+export function transformNotionToggles(content) {
+    return content.replace(/<details>\s*<summary>([\s\S]*?)<\/summary>([\s\S]*?)<\/details>/g, (_match, title, body) => `<Accordion title="${title.trim()}">\n${body.trim()}\n</Accordion>`);
+}
+/**
+ * Confluence: Convert common HTML and AC macros to markdown
+ */
+export function transformConfluenceHtml(content) {
+    // Code macros
+    content = content.replace(/<ac:structured-macro[^>]*ac:name="code"[^>]*>[\s\S]*?(?:<ac:parameter ac:name="language">([^<]*)<\/ac:parameter>)?[\s\S]*?<ac:plain-text-body><!\[CDATA\[([\s\S]*?)\]\]><\/ac:plain-text-body>[\s\S]*?<\/ac:structured-macro>/g, (_match, lang, code) => `\`\`\`${lang || ''}\n${code}\n\`\`\``);
+    // Expand macros → Accordion
+    content = content.replace(/<ac:structured-macro[^>]*ac:name="expand"[^>]*>[\s\S]*?<ac:parameter ac:name="title">([^<]*)<\/ac:parameter>[\s\S]*?<ac:rich-text-body>([\s\S]*?)<\/ac:rich-text-body>[\s\S]*?<\/ac:structured-macro>/g, (_match, title, body) => `<Accordion title="${title}">\n${stripHtmlTags(body).trim()}\n</Accordion>`);
+    // Strip remaining AC macros
+    content = content.replace(/<ac:[^>]+>|<\/ac:[^>]+>/g, '');
+    // Convert common HTML
+    content = convertBasicHtml(content);
+    return content;
+}
+/**
+ * Docusaurus: Strip import ... from '@theme/...' statements
+ */
+export function stripDocusaurusImports(content) {
+    return content.replace(/^import\s+.*from\s+['"]@theme\/.*['"];?\s*\n?/gm, '');
+}
+/**
+ * Normalize frontmatter fields to Skrypt format
+ */
+export function normalizeFrontmatter(content, defaults) {
+    const { data, body } = parseFrontmatterRaw(content);
+    if (!data && !defaults)
+        return content;
+    const fm = data || {};
+    // Map known field aliases
+    if (!fm.title && fm.sidebarTitle)
+        fm.title = fm.sidebarTitle;
+    if (!fm.description && fm.excerpt)
+        fm.description = fm.excerpt;
+    // Apply defaults
+    if (defaults?.title && !fm.title)
+        fm.title = defaults.title;
+    if (defaults?.description && !fm.description)
+        fm.description = defaults.description;
+    // Map icon field
+    if (fm.sidebar_icon && !fm.icon)
+        fm.icon = fm.sidebar_icon;
+    // Remove non-Skrypt fields
+    const removeFields = ['sidebar_position', 'order', 'weight', 'slug', 'sidebarTitle',
+        'excerpt', 'sidebar_icon', 'sidebar_label', 'sidebar_class_name',
+        'pagination_next', 'pagination_prev', 'custom_edit_url',
+        'displayed_sidebar', 'hide_table_of_contents', 'hide_title',
+        'keywords', 'tags', 'image', 'last_update', 'category'];
+    for (const field of removeFields) {
+        delete fm[field];
+    }
+    // Build normalized frontmatter
+    const skryptFields = {};
+    if (fm.title)
+        skryptFields.title = fm.title;
+    if (fm.description)
+        skryptFields.description = fm.description;
+    if (fm.icon)
+        skryptFields.icon = fm.icon;
+    // Include any remaining unknown fields
+    for (const [key, value] of Object.entries(fm)) {
+        if (!(key in skryptFields) && !removeFields.includes(key)) {
+            skryptFields[key] = value;
+        }
+    }
+    if (Object.keys(skryptFields).length === 0)
+        return body;
+    const fmLines = Object.entries(skryptFields)
+        .map(([k, v]) => {
+        if (typeof v === 'string') {
+            // Escape double quotes and backslashes in YAML string values
+            const escaped = v.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+            return `${k}: "${escaped}"`;
+        }
+        return `${k}: ${JSON.stringify(v)}`;
+    })
+        .join('\n');
+    return `---\n${fmLines}\n---\n\n${body}`;
+}
+/**
+ * Rewrite image paths based on asset copy mapping
+ */
+export function rewriteImagePaths(content, mapping) {
+    for (const [oldPath, newPath] of mapping) {
+        content = content.replaceAll(oldPath, newPath);
+    }
+    return content;
+}
+/**
+ * Strip 32-char hex UUID suffixes from Notion filenames
+ * e.g., "Getting Started a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4.md" → "Getting Started.md"
+ */
+export function stripNotionUUIDs(filename) {
+    return filename.replace(/\s+[0-9a-f]{32}/g, '');
+}
+// --- Helpers ---
+function stripHtmlTags(html) {
+    return html
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>/gi, '\n\n')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n{3,}/g, '\n\n');
+}
+function convertBasicHtml(html) {
+    let md = html;
+    // Headings
+    md = md.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '# $1\n\n');
+    md = md.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '## $1\n\n');
+    md = md.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '### $1\n\n');
+    md = md.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, '#### $1\n\n');
+    // Bold / italic
+    md = md.replace(/<strong>([\s\S]*?)<\/strong>/gi, '**$1**');
+    md = md.replace(/<b>([\s\S]*?)<\/b>/gi, '**$1**');
+    md = md.replace(/<em>([\s\S]*?)<\/em>/gi, '*$1*');
+    md = md.replace(/<i>([\s\S]*?)<\/i>/gi, '*$1*');
+    // Links
+    md = md.replace(/<a[^>]+href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)');
+    // Images
+    md = md.replace(/<img[^>]+src="([^"]*)"(?:[^>]*alt="([^"]*)")?[^>]*\/?>/gi, '![$2]($1)');
+    // Lists
+    md = md.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '- $1\n');
+    md = md.replace(/<\/?[uo]l[^>]*>/gi, '\n');
+    // Paragraphs & breaks
+    md = md.replace(/<\/p>/gi, '\n\n');
+    md = md.replace(/<p[^>]*>/gi, '');
+    md = md.replace(/<br\s*\/?>/gi, '\n');
+    // Code
+    md = md.replace(/<code>([\s\S]*?)<\/code>/gi, '`$1`');
+    md = md.replace(/<pre>([\s\S]*?)<\/pre>/gi, '```\n$1\n```');
+    // Tables
+    md = md.replace(/<table[^>]*>([\s\S]*?)<\/table>/gi, (_, tableContent) => {
+        return convertHtmlTable(tableContent);
+    });
+    // Strip remaining HTML tags (preserve Skrypt components like Accordion, Callout, Steps, etc.)
+    md = md.replace(/<\/?(?!Accordion|Callout|Steps|Step|Tabs|Tab|TabList|TabPanel|CodeGroup|Card|CardGroup)[a-z][^>]*>/gi, '');
+    // Decode entities
+    md = md.replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;/g, "'");
+    return md;
+}
+function convertHtmlTable(tableHtml) {
+    const rows = [];
+    const rowRegex = /<tr[^>]*>([\s\S]*?)<\/tr>/gi;
+    let rowMatch;
+    while ((rowMatch = rowRegex.exec(tableHtml)) !== null) {
+        const cells = [];
+        const cellRegex = /<t[dh][^>]*>([\s\S]*?)<\/t[dh]>/gi;
+        let cellMatch;
+        while ((cellMatch = cellRegex.exec(rowMatch[1])) !== null) {
+            cells.push(cellMatch[1].replace(/<[^>]+>/g, '').trim());
+        }
+        if (cells.length > 0)
+            rows.push(cells);
+    }
+    if (rows.length === 0)
+        return '';
+    const colCount = Math.max(...rows.map(r => r.length));
+    const lines = [];
+    for (let i = 0; i < rows.length; i++) {
+        const paddedCells = Array.from({ length: colCount }, (_, j) => rows[i][j] || '');
+        lines.push('| ' + paddedCells.join(' | ') + ' |');
+        if (i === 0) {
+            lines.push('| ' + paddedCells.map(() => '---').join(' | ') + ' |');
+        }
+    }
+    return '\n' + lines.join('\n') + '\n';
+}
+/**
+ * Simple frontmatter parser: splits on --- markers
+ */
+function parseFrontmatterRaw(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!match)
+        return { data: null, body: content };
+    const yamlStr = match[1];
+    const body = match[2];
+    // Simple YAML key: value parser (handles strings, numbers, booleans)
+    const data = {};
+    for (const line of yamlStr.split('\n')) {
+        const kvMatch = line.match(/^(\w[\w-]*)\s*:\s*(.*)$/);
+        if (!kvMatch)
+            continue;
+        const key = kvMatch[1];
+        let value = kvMatch[2].trim();
+        // Strip quotes
+        if (typeof value === 'string') {
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            else if (value === 'true')
+                value = true;
+            else if (value === 'false')
+                value = false;
+            else if (/^\d+$/.test(value))
+                value = parseInt(value, 10);
+        }
+        data[key] = value;
+    }
+    return { data, body };
+}
+/**
+ * Get sorting weight from frontmatter
+ */
+export function getSortWeight(content) {
+    const { data } = parseFrontmatterRaw(content);
+    if (!data)
+        return Infinity;
+    const weight = data.sidebar_position ?? data.order ?? data.weight ?? data.position;
+    return typeof weight === 'number' ? weight : Infinity;
+}

package/dist/importers/types.d.ts

@@ -0,0 +1,37 @@
+export type ImportFormat = 'mintlify' | 'docusaurus' | 'gitbook' | 'readme' | 'notion' | 'confluence' | 'markdown';
+export interface ImportedPage {
+    title: string;
+    slug: string;
+    sourcePath: string;
+    content: string;
+    description?: string;
+    frontmatter?: Record<string, unknown>;
+}
+export interface ImportedGroup {
+    group: string;
+    icon?: string;
+    pages: ImportedPage[];
+}
+export interface TransformStats {
+    callouts: number;
+    tabs: number;
+    codeGroups: number;
+    steps: number;
+    accordions: number;
+    images: number;
+    other: number;
+}
+export interface ImportResult {
+    navigation: ImportedGroup[];
+    name: string;
+    description: string;
+    files: Map<string, string>;
+    assets: Map<string, string>;
+    warnings: string[];
+    stats: {
+        pages: number;
+        groups: number;
+        transforms: TransformStats;
+    };
+    sourceFormat: ImportFormat;
+}

package/dist/importers/types.js

@@ -0,0 +1 @@
+export {};

package/dist/plugins/index.js

@@ -23,6 +23,8 @@ export class PluginManager {
         if (!configFile)
             return;
         try {
+            console.log(`  Loading config: ${configFile}`);
+            console.warn('  ⚠ Plugin configs execute code — only load trusted files');
             const configUrl = pathToFileURL(configFile).href;
             const module = await import(configUrl);
             const config = module.default || module;
@@ -57,6 +59,11 @@ export class PluginManager {
         return null;
     }
     async loadPluginByName(name) {
+        // Validate plugin name — must be a valid npm package name, no path traversal
+        if (!/^(@[a-zA-Z0-9._-]+\/)?[a-zA-Z0-9._-]+$/.test(name)) {
+            console.warn(`Skipping plugin with invalid name: ${name}`);
+            return;
+        }
         // Try to load from node_modules
         try {
             const module = await import(name);