@mintlify/astro 0.1.7 → 0.1.9

package/README.md

@@ -31,6 +31,7 @@ export default defineConfig({
 import { render } from 'astro:content';
 import { components } from '@mintlify/astro/components';
 ---
+
 <Content components={components} />
 ```
 

package/dist/helpers.js

@@ -1,4 +1,4 @@
-import { divisions } from '@mintlify/validation';
+import { divisions, } from '@mintlify/validation';
 export function isNavPage(entry) {
     return 'href' in entry && 'title' in entry;
 }
@@ -140,7 +140,7 @@ export function getFooterPages(entries, currentPath) {
     };
 }
 function flattenPages(entries) {
-    return entries.flatMap((x) => isNavGroup(x) ? flattenPages(x.pages) : [x]);
+    return entries.flatMap((x) => (isNavGroup(x) ? flattenPages(x.pages) : [x]));
 }
 /**
  * Finds the group label that contains the given path.

package/dist/index.js

@@ -11,6 +11,7 @@ import { readDocsConfig } from './utils/read-docs-config.js';
 import { readPageContent } from './utils/read-page-content.js';
 import { createStaticAssetMiddleware } from './utils/serve-docs-assets.js';
 import { writePageContent } from './utils/write-page-content.js';
+import { writeRawMd } from './utils/write-raw-md.js';
 export { readDocsConfig } from './utils/read-docs-config.js';
 export function mintlify(options) {
     let docsDir;
@@ -38,22 +39,25 @@ export function mintlify(options) {
                 const docsConfig = await readDocsConfig(docsDir);
                 const pagePaths = getAllPathsInDocsNav(docsConfig.navigation);
                 logger.info(`Found ${pagePaths.length} pages to sync`);
-                await Promise.all(pagePaths.map(async (pagePath) => {
-                    try {
-                        const { content, slug } = await readPageContent(pagePath, docsDir);
-                        await writePageContent({
-                            content,
-                            slug,
-                            contentDir,
-                            componentsDir,
-                            userComponents,
-                            snippets,
-                        });
-                    }
-                    catch (error) {
-                        logger.warn(`Failed to read content for ${pagePath}: ${error}`);
-                    }
-                }));
+                await Promise.all([
+                    writeRawMd(pagePaths, docsDir, staticDir),
+                    ...pagePaths.map(async (pagePath) => {
+                        try {
+                            const { content, slug } = await readPageContent(pagePath, docsDir);
+                            await writePageContent({
+                                content,
+                                slug,
+                                contentDir,
+                                componentsDir,
+                                userComponents,
+                                snippets,
+                            });
+                        }
+                        catch (error) {
+                            logger.warn(`Failed to read content for ${pagePath}: ${error}`);
+                        }
+                    }),
+                ]);
                 logger.info(`Synced ${pagePaths.length} pages`);
             },
             'astro:server:setup': ({ server }) => {

package/dist/utils/mintlify-components.d.ts

@@ -4,9 +4,11 @@ export declare const components: {
     Accordion: (({ title, description, defaultOpen, icon, iconType, children, className, _disabled, trackOpen, trackClose, onMount, topOffset, getInitialOpenFromUrl, onUrlStateChange, _onKeyDownCapture, }: import("@mintlify/components").AccordionProps) => import("react/jsx-runtime").JSX.Element) & {
         Group: ({ children, className }: import("@mintlify/components").AccordionGroupProps) => import("react/jsx-runtime").JSX.Element;
     };
+    AccordionGroup: ({ children, className }: import("@mintlify/components").AccordionGroupProps) => import("react/jsx-runtime").JSX.Element;
     Badge: ({ children, className, color, shape, variant: variantProp, stroke, disabled, size, leadIcon, tailIcon: tailIconProp, icon, iconType, iconLibrary, onClick, href, }: import("@mintlify/components").BadgeProps) => import("react/jsx-runtime").JSX.Element;
     Callout: ({ children, variant, icon, iconType, iconLibrary, color, className, ariaLabel, }: import("@mintlify/components").CalloutProps) => import("react/jsx-runtime").JSX.Element;
     Card: ({ title, icon, iconType, iconLibrary, color, horizontal, href, img, children, disabled, cta, arrow, as, className, }: import("@mintlify/components").CardComponentProps) => import("react/jsx-runtime").JSX.Element;
+    CardGroup: ({ children, className, cols }: import("@mintlify/components").ColumnsProps) => import("react/jsx-runtime").JSX.Element;
     Check: (props: {
         children: ReactNode;
         className?: string | undefined;
@@ -57,6 +59,7 @@ export declare const components: {
     }) => import("react/jsx-runtime").JSX.Element;
     Panel: ({ children, className, ...props }: import("@mintlify/components").PanelProps) => import("react/jsx-runtime").JSX.Element;
     Property: ({ name, type, location, hidden, default: defaultValue, required, deprecated, children, id, pre, post, className, onMount, navigateToHeaderAriaLabel, defaultLabel, requiredLabel, deprecatedLabel, }: import("@mintlify/components").PropertyProps) => import("react/jsx-runtime").JSX.Element | null;
+    ResponseField: ({ name, type, location, hidden, default: defaultValue, required, deprecated, children, id, pre, post, className, onMount, navigateToHeaderAriaLabel, defaultLabel, requiredLabel, deprecatedLabel, }: import("@mintlify/components").PropertyProps) => import("react/jsx-runtime").JSX.Element | null;
     Steps: {
         ({ children, titleSize, className }: import("@mintlify/components").StepsProps): import("react/jsx-runtime").JSX.Element;
         Item: ({ stepNumber, icon, iconType, iconLibrary, title, children, titleSize, className, isLast, id, noAnchor, scrollElementIntoView, onRegisterHeading, onUnregisterHeading, _hasContext, onCopyAnchorLink, }: import("@mintlify/components").StepsItemProps) => import("react/jsx-runtime").JSX.Element;

package/dist/utils/mintlify-components.js

@@ -3,9 +3,11 @@ import { Accordion, Badge, Callout, Card, Check, CodeBlock, CodeGroup, Color, Co
 const Wrapper = ({ children }) => (_jsx("div", { children: children }));
 const MintlifyComponents = {
     Accordion,
+    AccordionGroup: Accordion.Group,
     Badge,
     Callout,
     Card,
+    CardGroup: Columns,
     Check,
     CodeBlock,
     CodeGroup,
@@ -20,6 +22,7 @@ const MintlifyComponents = {
     Note,
     Panel,
     Property,
+    ResponseField: Property,
     Steps,
     Tabs,
     Tile,
@@ -30,10 +33,8 @@ const MintlifyComponents = {
     Warning,
 };
 const placeholderComponents = {
-    AccordionGroup: Wrapper,
-    ApiPlayground: Wrapper,
-    CardGroup: Wrapper,
     Column: Wrapper,
+    ApiPlayground: Wrapper,
     CustomCode: Wrapper,
     CustomComponent: Wrapper,
     DynamicCustomComponent: Wrapper,
@@ -47,7 +48,6 @@ const placeholderComponents = {
     PreviewButton: Wrapper,
     RequestExample: Wrapper,
     ResponseExample: Wrapper,
-    ResponseField: Wrapper,
     Snippet: Wrapper,
     SnippetGroup: Wrapper,
     View: Wrapper,

package/dist/utils/serve-docs-assets.js

@@ -14,7 +14,9 @@ export function createStaticAssetMiddleware(staticDir) {
         catch {
             return next();
         }
-        const relativePath = pathname.startsWith('/') ? pathname.slice(1) : pathname;
+        const relativePath = pathname.startsWith('/')
+            ? pathname.slice(1)
+            : pathname;
         if (!relativePath)
             return next();
         if (!isSupportedStaticAsset(relativePath))

package/dist/utils/static-assets.js

@@ -16,6 +16,7 @@ const SUPPORTED_STATIC_ASSETS = {
     '.woff2': 'font/woff2',
     '.ttf': 'font/ttf',
     '.eot': 'application/vnd.ms-fontobject',
+    '.md': 'text/plain',
 };
 export function isSupportedStaticAsset(pathname) {
     const extension = posix.extname(pathname).toLowerCase();

package/dist/utils/write-raw-md.d.ts

@@ -0,0 +1 @@
+export declare function writeRawMd(pagePaths: string[], docsDir: string, outputDir: string): Promise<void>;

package/dist/utils/write-raw-md.js

@@ -0,0 +1,34 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parseFrontmatter } from '@mintlify/common';
+export async function writeRawMd(pagePaths, docsDir, outputDir) {
+    await Promise.all(pagePaths.map(async (pagePath) => {
+        let content;
+        try {
+            content = await readFile(join(docsDir, `${pagePath}.mdx`));
+        }
+        catch {
+            try {
+                content = await readFile(join(docsDir, `${pagePath}.md`));
+            }
+            catch {
+                return;
+            }
+        }
+        let filePath;
+        if (pagePath === 'index') {
+            filePath = join(outputDir, 'index.md');
+        }
+        else {
+            const parts = pagePath.split('/');
+            const fileName = parts.pop() + '.md';
+            const dirPath = join(outputDir, ...parts);
+            if (parts.length > 0) {
+                await mkdir(dirPath, { recursive: true });
+            }
+            filePath = join(dirPath, fileName);
+        }
+        const { body } = parseFrontmatter(content.toString());
+        await writeFile(filePath, body);
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/astro",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Mintlify integration for Astro",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,7 +26,8 @@
   "scripts": {
     "prepare": "npm run build",
     "build": "tsc",
-    "type": "tsc --noEmit"
+    "type": "tsc --noEmit",
+    "format": "prettier --write ."
   },
   "author": "Mintlify, Inc.",
   "license": "ISC",
@@ -47,6 +48,7 @@
     "astro": "^5.17.1",
     "mdast": "^2.3.2",
     "mdast-util-mdx": "^3.0.0",
+    "prettier": "^3.8.1",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "typescript": "^5.9.3"