@brainfish-ai/devdoc 0.1.42 → 0.1.43

package/renderer/app/sitemap.xml/route.js

@@ -0,0 +1,145 @@
+import { NextResponse } from 'next/server';
+import { join } from 'path';
+import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
+/**
+ * sitemap.xml - Auto-generated sitemap for search engines
+ * 
+ * Generated from docs.json configuration.
+ */ const DOCS_DIR = join(process.cwd(), 'templates', 'starter');
+const BASE_URL = process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000';
+function loadDocsConfig() {
+    const configPath = join(DOCS_DIR, 'docs.json');
+    if (!existsSync(configPath)) return null;
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    } catch  {
+        return null;
+    }
+}
+function getFileLastModified(slug) {
+    const extensions = [
+        '.mdx',
+        '.md'
+    ];
+    for (const ext of extensions){
+        const filePath = join(DOCS_DIR, `${slug}${ext}`);
+        if (existsSync(filePath)) {
+            try {
+                const stats = statSync(filePath);
+                return stats.mtime.toISOString().split('T')[0];
+            } catch  {
+                return undefined;
+            }
+        }
+    }
+    return undefined;
+}
+function getChangelogFiles() {
+    const changelogDir = join(DOCS_DIR, 'changelog');
+    if (!existsSync(changelogDir)) return [];
+    try {
+        return readdirSync(changelogDir).filter((f)=>(f.endsWith('.mdx') || f.endsWith('.md')) && f !== 'latest.mdx').map((f)=>f.replace(/\.(mdx?|md)$/, ''));
+    } catch  {
+        return [];
+    }
+}
+function generateSitemap(config) {
+    const entries = [];
+    const baseUrl = config.seo?.metatags?.canonical || BASE_URL;
+    // Add homepage
+    entries.push({
+        url: baseUrl,
+        changefreq: 'weekly',
+        priority: 1.0
+    });
+    // Process navigation tabs
+    if (config.navigation?.tabs) {
+        for (const tab of config.navigation.tabs){
+            if (tab.type === 'docs' && tab.groups) {
+                for (const group of tab.groups){
+                    for (const page of group.pages){
+                        const lastmod = getFileLastModified(page);
+                        const urlPath = page === 'index' ? '' : page;
+                        entries.push({
+                            url: `${baseUrl}/#${tab.tab.toLowerCase()}/page/${urlPath}`.replace(/\/+$/, ''),
+                            lastmod,
+                            changefreq: 'weekly',
+                            priority: page === 'index' ? 0.9 : 0.8
+                        });
+                    }
+                }
+            } else if (tab.type === 'openapi') {
+                entries.push({
+                    url: `${baseUrl}/#api-reference`,
+                    changefreq: 'weekly',
+                    priority: 0.9
+                });
+            } else if (tab.type === 'changelog') {
+                entries.push({
+                    url: `${baseUrl}/#changelog`,
+                    changefreq: 'weekly',
+                    priority: 0.7
+                });
+                // Add individual changelog pages
+                const versions = getChangelogFiles();
+                for (const version of versions){
+                    const lastmod = getFileLastModified(`changelog/${version}`);
+                    entries.push({
+                        url: `${baseUrl}/#changelog/page/changelog/${version}`,
+                        lastmod,
+                        changefreq: 'monthly',
+                        priority: 0.6
+                    });
+                }
+            }
+        }
+    }
+    // Generate XML
+    const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${entries.map((entry)=>`  <url>
+    <loc>${escapeXml(entry.url)}</loc>
+${entry.lastmod ? `    <lastmod>${entry.lastmod}</lastmod>\n` : ''}${entry.changefreq ? `    <changefreq>${entry.changefreq}</changefreq>\n` : ''}${entry.priority !== undefined ? `    <priority>${entry.priority}</priority>\n` : ''}  </url>`).join('\n')}
+</urlset>`;
+    return xml;
+}
+function escapeXml(str) {
+    return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+}
+export async function GET() {
+    try {
+        // Check for custom sitemap.xml first
+        const customPath = join(DOCS_DIR, 'sitemap.xml');
+        if (existsSync(customPath)) {
+            const customContent = readFileSync(customPath, 'utf-8');
+            return new NextResponse(customContent, {
+                headers: {
+                    'Content-Type': 'application/xml; charset=utf-8',
+                    'Cache-Control': 'public, max-age=3600'
+                }
+            });
+        }
+        // Generate from docs.json config
+        const config = loadDocsConfig();
+        if (!config) {
+            return new NextResponse('<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>', {
+                headers: {
+                    'Content-Type': 'application/xml; charset=utf-8'
+                }
+            });
+        }
+        const content = generateSitemap(config);
+        return new NextResponse(content, {
+            headers: {
+                'Content-Type': 'application/xml; charset=utf-8',
+                'Cache-Control': 'public, max-age=3600'
+            }
+        });
+    } catch (error) {
+        console.error('Error generating sitemap.xml:', error);
+        return new NextResponse('Error generating sitemap.xml', {
+            status: 500
+        });
+    }
+}

package/renderer/components/docs/index.js

@@ -0,0 +1,8 @@
+/**
+ * Documentation Components Exports
+ */ // MDX Components
+export * from './mdx';
+// MDX Renderer
+export { MDXRenderer, TableOfContents as MDXTableOfContents } from './mdx-renderer';
+// Navigation Components
+export * from './navigation';

package/renderer/components/docs/mdx/accordion.js

@@ -0,0 +1,113 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useState, createContext, useContext } from 'react';
+import { cn } from '@/lib/utils';
+import { CaretDown } from '@phosphor-icons/react';
+import * as PhosphorIcons from '@phosphor-icons/react';
+/**
+ * Accordion Components for MDX Documentation
+ * 
+ * Mintlify-compatible accordion components for collapsible content sections.
+ */ // Dynamic icon resolver
+function getIcon(iconName) {
+    if (!iconName) return null;
+    const pascalCase = iconName.split(/[-_]/).map((word)=>word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join('');
+    const Icon = PhosphorIcons[pascalCase];
+    return Icon || null;
+}
+const AccordionGroupContext = /*#__PURE__*/ createContext(null);
+export function Accordion({ title, children, description, icon, defaultOpen = false, className }) {
+    const groupContext = useContext(AccordionGroupContext);
+    const [localOpen, setLocalOpen] = useState(defaultOpen);
+    // Generate a stable ID for this accordion
+    const id = React.useId();
+    // Use group context if available, otherwise use local state
+    const isOpen = groupContext ? groupContext.openItems.has(id) : localOpen;
+    const toggle = ()=>{
+        if (groupContext) {
+            groupContext.toggleItem(id);
+        } else {
+            setLocalOpen(!localOpen);
+        }
+    };
+    // Register default open state with group on mount
+    React.useEffect(()=>{
+        if (groupContext && defaultOpen) {
+            groupContext.toggleItem(id);
+        }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    const Icon = icon ? getIcon(icon) : null;
+    return /*#__PURE__*/ _jsxs("div", {
+        className: cn('border border-border rounded-lg overflow-hidden', 'bg-card', className),
+        children: [
+            /*#__PURE__*/ _jsxs("button", {
+                type: "button",
+                onClick: toggle,
+                className: cn('flex w-full items-center gap-3 p-4 text-left', 'hover:bg-muted/50 transition-colors', 'focus:outline-none focus-visible:ring-2 focus-visible:ring-primary/50'),
+                "aria-expanded": isOpen,
+                children: [
+                    Icon && /*#__PURE__*/ _jsx(Icon, {
+                        className: "h-5 w-5 shrink-0 text-primary",
+                        weight: "duotone"
+                    }),
+                    /*#__PURE__*/ _jsxs("div", {
+                        className: "flex-1 min-w-0",
+                        children: [
+                            /*#__PURE__*/ _jsx("div", {
+                                className: "font-medium text-foreground",
+                                children: title
+                            }),
+                            description && /*#__PURE__*/ _jsx("div", {
+                                className: "text-sm text-muted-foreground mt-0.5",
+                                children: description
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsx(CaretDown, {
+                        className: cn('h-5 w-5 shrink-0 text-muted-foreground transition-transform duration-200', isOpen && 'rotate-180'),
+                        weight: "bold"
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsx("div", {
+                className: cn('grid transition-all duration-200 ease-in-out', isOpen ? 'grid-rows-[1fr] opacity-100' : 'grid-rows-[0fr] opacity-0'),
+                children: /*#__PURE__*/ _jsx("div", {
+                    className: "overflow-hidden",
+                    children: /*#__PURE__*/ _jsx("div", {
+                        className: "px-4 pb-4 text-sm text-foreground/90 [&>p]:mb-2 [&>p:last-child]:mb-0",
+                        children: children
+                    })
+                })
+            })
+        ]
+    });
+}
+export function AccordionGroup({ children, allowMultiple = true, className }) {
+    const [openItems, setOpenItems] = useState(new Set());
+    const toggleItem = (id)=>{
+        setOpenItems((prev)=>{
+            const next = new Set(prev);
+            if (next.has(id)) {
+                next.delete(id);
+            } else {
+                if (!allowMultiple) {
+                    next.clear();
+                }
+                next.add(id);
+            }
+            return next;
+        });
+    };
+    return /*#__PURE__*/ _jsx(AccordionGroupContext.Provider, {
+        value: {
+            openItems,
+            toggleItem,
+            allowMultiple
+        },
+        children: /*#__PURE__*/ _jsx("div", {
+            className: cn('space-y-2 my-4', className),
+            children: children
+        })
+    });
+}

package/renderer/components/docs/mdx/badge.js

@@ -0,0 +1,72 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '@/lib/utils';
+import * as PhosphorIcons from '@phosphor-icons/react';
+// Helper to get Phosphor icon component from name
+function getIcon(iconName) {
+    if (!iconName) return null;
+    // Convert kebab-case to PascalCase for Phosphor icons
+    const pascalCase = iconName.split('-').map((part)=>part.charAt(0).toUpperCase() + part.slice(1)).join('');
+    const IconComponent = PhosphorIcons[pascalCase];
+    return IconComponent || null;
+}
+// Color variants - filled background
+const colorVariants = {
+    gray: 'bg-gray-100 text-gray-700 dark:bg-gray-800 dark:text-gray-300',
+    blue: 'bg-blue-100 text-blue-700 dark:bg-blue-900/50 dark:text-blue-300',
+    green: 'bg-green-100 text-green-700 dark:bg-green-900/50 dark:text-green-300',
+    yellow: 'bg-yellow-100 text-yellow-700 dark:bg-yellow-900/50 dark:text-yellow-300',
+    orange: 'bg-orange-100 text-orange-700 dark:bg-orange-900/50 dark:text-orange-300',
+    red: 'bg-red-100 text-red-700 dark:bg-red-900/50 dark:text-red-300',
+    purple: 'bg-purple-100 text-purple-700 dark:bg-purple-900/50 dark:text-purple-300',
+    white: 'bg-white text-gray-900 border border-gray-200 dark:bg-gray-900 dark:text-gray-100 dark:border-gray-700',
+    surface: 'bg-muted text-foreground',
+    'white-destructive': 'bg-white text-red-600 border border-red-200 dark:bg-gray-900 dark:text-red-400 dark:border-red-800',
+    'surface-destructive': 'bg-red-50 text-red-600 dark:bg-red-950 dark:text-red-400'
+};
+// Color variants - stroke/outline
+const strokeVariants = {
+    gray: 'border border-gray-300 text-gray-700 dark:border-gray-600 dark:text-gray-300',
+    blue: 'border border-blue-300 text-blue-700 dark:border-blue-600 dark:text-blue-300',
+    green: 'border border-green-300 text-green-700 dark:border-green-600 dark:text-green-300',
+    yellow: 'border border-yellow-300 text-yellow-700 dark:border-yellow-600 dark:text-yellow-300',
+    orange: 'border border-orange-300 text-orange-700 dark:border-orange-600 dark:text-orange-300',
+    red: 'border border-red-300 text-red-700 dark:border-red-600 dark:text-red-300',
+    purple: 'border border-purple-300 text-purple-700 dark:border-purple-600 dark:text-purple-300',
+    white: 'border border-gray-300 text-gray-700 dark:border-gray-600 dark:text-gray-300',
+    surface: 'border border-border text-foreground',
+    'white-destructive': 'border border-red-300 text-red-600 dark:border-red-600 dark:text-red-400',
+    'surface-destructive': 'border border-red-300 text-red-600 dark:border-red-600 dark:text-red-400'
+};
+// Size variants
+const sizeVariants = {
+    xs: 'text-[10px] px-1.5 py-0.5 gap-1',
+    sm: 'text-xs px-2 py-0.5 gap-1',
+    md: 'text-sm px-2.5 py-1 gap-1.5',
+    lg: 'text-base px-3 py-1.5 gap-2'
+};
+// Icon size variants
+const iconSizeVariants = {
+    xs: 'h-2.5 w-2.5',
+    sm: 'h-3 w-3',
+    md: 'h-3.5 w-3.5',
+    lg: 'h-4 w-4'
+};
+// Shape variants
+const shapeVariants = {
+    rounded: 'rounded-md',
+    pill: 'rounded-full'
+};
+export function Badge({ children, color = 'gray', size = 'md', shape = 'rounded', icon, stroke = false, disabled = false, className }) {
+    const IconComponent = getIcon(icon);
+    return /*#__PURE__*/ _jsxs("span", {
+        className: cn('inline-flex items-center font-medium whitespace-nowrap', sizeVariants[size], shapeVariants[shape], stroke ? strokeVariants[color] : colorVariants[color], disabled && 'opacity-50 cursor-not-allowed', className),
+        children: [
+            IconComponent && /*#__PURE__*/ _jsx(IconComponent, {
+                className: cn(iconSizeVariants[size], 'shrink-0'),
+                weight: "bold"
+            }),
+            children
+        ]
+    });
+}

package/renderer/components/docs/mdx/callouts.js

@@ -0,0 +1,137 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { cn } from '@/lib/utils';
+import { Info as InfoIcon, Warning as WarningIcon, Lightbulb, Note as NoteIcon, CheckCircle, XCircle } from '@phosphor-icons/react';
+const calloutConfig = {
+    note: {
+        icon: NoteIcon,
+        defaultTitle: 'Note',
+        containerClass: 'border-blue-500/30 bg-blue-500/10 dark:border-blue-400/30 dark:bg-blue-400/10',
+        iconClass: 'text-blue-600 dark:text-blue-400',
+        titleClass: 'text-blue-700 dark:text-blue-300'
+    },
+    warning: {
+        icon: WarningIcon,
+        defaultTitle: 'Warning',
+        containerClass: 'border-amber-500/30 bg-amber-500/10 dark:border-amber-400/30 dark:bg-amber-400/10',
+        iconClass: 'text-amber-600 dark:text-amber-400',
+        titleClass: 'text-amber-700 dark:text-amber-300'
+    },
+    info: {
+        icon: InfoIcon,
+        defaultTitle: 'Info',
+        containerClass: 'border-sky-500/30 bg-sky-500/10 dark:border-sky-400/30 dark:bg-sky-400/10',
+        iconClass: 'text-sky-600 dark:text-sky-400',
+        titleClass: 'text-sky-700 dark:text-sky-300'
+    },
+    tip: {
+        icon: Lightbulb,
+        defaultTitle: 'Tip',
+        containerClass: 'border-emerald-500/30 bg-emerald-500/10 dark:border-emerald-400/30 dark:bg-emerald-400/10',
+        iconClass: 'text-emerald-600 dark:text-emerald-400',
+        titleClass: 'text-emerald-700 dark:text-emerald-300'
+    },
+    check: {
+        icon: CheckCircle,
+        defaultTitle: 'Success',
+        containerClass: 'border-green-500/30 bg-green-500/10 dark:border-green-400/30 dark:bg-green-400/10',
+        iconClass: 'text-green-600 dark:text-green-400',
+        titleClass: 'text-green-700 dark:text-green-300'
+    },
+    error: {
+        icon: XCircle,
+        defaultTitle: 'Error',
+        containerClass: 'border-red-500/30 bg-red-500/10 dark:border-red-400/30 dark:bg-red-400/10',
+        iconClass: 'text-red-600 dark:text-red-400',
+        titleClass: 'text-red-700 dark:text-red-300'
+    }
+};
+function BaseCallout({ variant, children, title, className }) {
+    const config = calloutConfig[variant];
+    const Icon = config.icon;
+    const displayTitle = title ?? config.defaultTitle;
+    return /*#__PURE__*/ _jsx("div", {
+        className: cn(`docs-callout docs-callout-${variant} my-4 rounded-lg border p-4`, config.containerClass, className),
+        children: /*#__PURE__*/ _jsxs("div", {
+            className: "flex items-start gap-3",
+            children: [
+                /*#__PURE__*/ _jsx(Icon, {
+                    className: cn('docs-callout-icon mt-0.5 h-5 w-5 shrink-0', config.iconClass),
+                    weight: "fill"
+                }),
+                /*#__PURE__*/ _jsxs("div", {
+                    className: "docs-callout-content flex-1 min-w-0",
+                    children: [
+                        displayTitle && /*#__PURE__*/ _jsx("div", {
+                            className: cn('docs-callout-title font-semibold text-sm mb-1', config.titleClass),
+                            children: displayTitle
+                        }),
+                        /*#__PURE__*/ _jsx("div", {
+                            className: "docs-callout-body text-sm text-foreground/90 [&>p]:mb-2 [&>p:last-child]:mb-0 [&>ul]:mt-2 [&>ol]:mt-2",
+                            children: children
+                        })
+                    ]
+                })
+            ]
+        })
+    });
+}
+// Individual callout components for MDX usage
+export function Note({ children, title, className }) {
+    return /*#__PURE__*/ _jsx(BaseCallout, {
+        variant: "note",
+        title: title,
+        className: className,
+        children: children
+    });
+}
+export function Warning({ children, title, className }) {
+    return /*#__PURE__*/ _jsx(BaseCallout, {
+        variant: "warning",
+        title: title,
+        className: className,
+        children: children
+    });
+}
+export function Info({ children, title, className }) {
+    return /*#__PURE__*/ _jsx(BaseCallout, {
+        variant: "info",
+        title: title,
+        className: className,
+        children: children
+    });
+}
+export function Tip({ children, title, className }) {
+    return /*#__PURE__*/ _jsx(BaseCallout, {
+        variant: "tip",
+        title: title,
+        className: className,
+        children: children
+    });
+}
+export function Check({ children, title, className }) {
+    return /*#__PURE__*/ _jsx(BaseCallout, {
+        variant: "check",
+        title: title,
+        className: className,
+        children: children
+    });
+}
+export function Error({ children, title, className }) {
+    return /*#__PURE__*/ _jsx(BaseCallout, {
+        variant: "error",
+        title: title,
+        className: className,
+        children: children
+    });
+}
+// Generic Callout component with type prop
+export function Callout({ type = 'note', children, title, className }) {
+    return /*#__PURE__*/ _jsx(BaseCallout, {
+        variant: type,
+        title: title,
+        className: className,
+        children: children
+    });
+}

package/renderer/components/docs/mdx/cards.js

@@ -0,0 +1,175 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import Link from 'next/link';
+import { cn } from '@/lib/utils';
+import { ArrowRight, ArrowSquareOut } from '@phosphor-icons/react';
+import * as PhosphorIcons from '@phosphor-icons/react';
+import { useDocsNavigation } from '@/lib/docs-navigation-context';
+// Dynamic icon resolver for Phosphor icons
+function getIcon(iconName) {
+    if (!iconName) return null;
+    // Convert kebab-case or snake_case to PascalCase
+    const pascalCase = iconName.split(/[-_]/).map((word)=>word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join('');
+    // Try to get the icon from Phosphor
+    const Icon = PhosphorIcons[pascalCase];
+    return Icon || null;
+}
+// Icon size configurations
+const ICON_SIZES = {
+    sm: {
+        container: 'h-8 w-8',
+        icon: 'h-4 w-4',
+        img: 'h-5 w-5'
+    },
+    md: {
+        container: 'h-10 w-10',
+        icon: 'h-5 w-5',
+        img: 'h-6 w-6'
+    },
+    lg: {
+        container: 'h-12 w-12',
+        icon: 'h-6 w-6',
+        img: 'h-8 w-8'
+    },
+    xl: {
+        container: 'h-16 w-16',
+        icon: 'h-8 w-8',
+        img: 'h-12 w-12'
+    }
+};
+export function Card({ title, children, icon, iconSize = 'md', href, horizontal = false, img, cta, arrow, className }) {
+    // Check if icon is a string (icon name) or React node
+    const isIconString = typeof icon === 'string';
+    const Icon = isIconString ? getIcon(icon) : null;
+    const hasCustomIcon = !isIconString && icon != null;
+    const sizeConfig = ICON_SIZES[iconSize];
+    const isExternal = href?.startsWith('http') || href?.startsWith('//');
+    const docsNav = useDocsNavigation();
+    // Check if this is a tab switch link (/api-reference, /changelog)
+    const isTabSwitchLink = (href === '/api-reference' || href === '/changelog') && docsNav?.isApiDocsView;
+    // Check if this is an internal docs link (starts with / but not external or tab switch)
+    const isInternalDocsLink = href?.startsWith('/') && !isExternal && !isTabSwitchLink && docsNav?.isApiDocsView;
+    // Extract slug from href - removes /docs/ prefix if present, or just the leading /
+    const getSlugFromHref = (path)=>{
+        let slug = path;
+        if (slug.startsWith('/docs/')) {
+            slug = slug.slice(6); // Remove '/docs/'
+        } else if (slug.startsWith('/')) {
+            slug = slug.slice(1); // Remove leading '/'
+        }
+        return slug;
+    };
+    // Get tab ID from href
+    const getTabIdFromHref = (path)=>{
+        if (path === '/api-reference') return 'api-reference';
+        if (path === '/changelog') return 'changelog';
+        return 'docs';
+    };
+    // Handle click for internal navigation
+    const handleClick = (e)=>{
+        if (!href || !docsNav) return;
+        if (isTabSwitchLink) {
+            e.preventDefault();
+            const tabId = getTabIdFromHref(href);
+            docsNav.switchToTab(tabId);
+        } else if (isInternalDocsLink) {
+            e.preventDefault();
+            const slug = getSlugFromHref(href);
+            docsNav.navigateToPage(slug);
+        }
+    };
+    const showArrow = arrow ?? isExternal;
+    const cardContent = /*#__PURE__*/ _jsxs("div", {
+        className: cn('docs-card group relative rounded-lg border border-border bg-card p-4 transition-all h-full', href && 'hover:border-primary/50 hover:shadow-md cursor-pointer', horizontal ? 'docs-card-horizontal flex items-start gap-4' : 'flex flex-col justify-start', className),
+        children: [
+            img && !horizontal && /*#__PURE__*/ _jsx("div", {
+                className: "mb-4 -mx-4 -mt-4 overflow-hidden rounded-t-lg",
+                children: /*#__PURE__*/ _jsx("img", {
+                    src: img,
+                    alt: title,
+                    className: "w-full h-auto object-cover"
+                })
+            }),
+            Icon && /*#__PURE__*/ _jsx("div", {
+                className: cn('docs-card-icon flex shrink-0 items-center justify-center rounded-lg', sizeConfig.container, 'bg-primary/10 text-primary', horizontal && 'mt-0.5'),
+                children: /*#__PURE__*/ _jsx(Icon, {
+                    className: sizeConfig.icon,
+                    weight: "duotone"
+                })
+            }),
+            hasCustomIcon && /*#__PURE__*/ _jsx("div", {
+                className: cn('docs-card-icon flex shrink-0 items-center justify-center rounded-lg overflow-hidden', sizeConfig.container, horizontal && 'mt-0.5'),
+                children: icon
+            }),
+            /*#__PURE__*/ _jsxs("div", {
+                className: cn('docs-card-content min-w-0', horizontal && 'flex-1', !horizontal && (Icon || hasCustomIcon) && 'mt-3'),
+                children: [
+                    /*#__PURE__*/ _jsxs("div", {
+                        className: "flex items-center gap-2",
+                        children: [
+                            /*#__PURE__*/ _jsx("h3", {
+                                className: "docs-card-title font-semibold text-foreground group-hover:text-primary transition-colors",
+                                children: title
+                            }),
+                            showArrow && (isExternal ? /*#__PURE__*/ _jsx(ArrowSquareOut, {
+                                className: "h-4 w-4 text-muted-foreground"
+                            }) : /*#__PURE__*/ _jsx(ArrowRight, {
+                                className: "h-4 w-4 text-muted-foreground opacity-0 -translate-x-2 group-hover:opacity-100 group-hover:translate-x-0 transition-all"
+                            }))
+                        ]
+                    }),
+                    children && /*#__PURE__*/ _jsx("div", {
+                        className: "docs-card-description mt-1 text-sm text-muted-foreground",
+                        children: children
+                    }),
+                    cta && /*#__PURE__*/ _jsx("div", {
+                        className: "docs-card-cta mt-3 text-sm font-medium text-primary",
+                        children: cta
+                    })
+                ]
+            })
+        ]
+    });
+    if (href) {
+        if (isExternal) {
+            return /*#__PURE__*/ _jsx("a", {
+                href: href,
+                target: "_blank",
+                rel: "noopener noreferrer",
+                className: "docs-card-link block h-full",
+                children: cardContent
+            });
+        }
+        // For internal docs links or tab switch links in ApiDocs view, use click handler
+        if (isInternalDocsLink || isTabSwitchLink) {
+            return /*#__PURE__*/ _jsx("a", {
+                href: href,
+                onClick: handleClick,
+                className: "docs-card-link block h-full cursor-pointer",
+                children: cardContent
+            });
+        }
+        // Standard Next.js Link for all other internal links
+        return /*#__PURE__*/ _jsx(Link, {
+            href: href,
+            className: "docs-card-link block h-full",
+            children: cardContent
+        });
+    }
+    return cardContent;
+}
+export function CardGroup({ children, cols = 2, className }) {
+    const gridCols = {
+        1: 'grid-cols-1',
+        2: 'grid-cols-1 sm:grid-cols-2',
+        3: 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-3',
+        4: 'grid-cols-1 sm:grid-cols-2 lg:grid-cols-4'
+    };
+    return /*#__PURE__*/ _jsx("div", {
+        className: cn('docs-card-group grid gap-4 my-4', gridCols[cols], className),
+        children: children
+    });
+}
+// Alias for Mintlify compatibility
+export { CardGroup as Columns };