@mintlify/common 1.0.1019 → 1.0.1020

package/dist/mdx/componentIds.js

@@ -38,6 +38,7 @@ export const COMPONENTS_WITHOUT_ID = new Set([
     'Tile',
     'Tooltip',
     'Tree',
+    'FileTree',
     'Visibility',
     'Badge',
     'Color',

package/dist/mdx/getMDXOptions.js

@@ -1,4 +1,4 @@
-import { rehypeCodeBlocks, rehypeDynamicTailwindCss, rehypeKeyboardSymbols, rehypeListItemText, rehypeMdxExtractEndpoint, rehypeMdxExtractExamples, rehypeParamFieldIds, rehypeRawComponents, rehypeTable, rehypeUnicodeIds, rehypeZoomImages, remarkExtractChangelogFilters, remarkExtractTableOfContents, remarkFrames, remarkComponentIds, remarkMdxInjectSnippets, remarkMdxRemoveUnusedVariables, remarkRemoveImports, remarkMdxExtractPanel, remarkResolveRelativeLinks, remarkVideo, remarkMdxClientComponentBoundaries, remarkExtractMultiView, remarkPrompt, remarkUnwrapJsxHeadings, } from './plugins/index.js';
+import { rehypeCodeBlocks, rehypeDynamicTailwindCss, rehypeKeyboardSymbols, rehypeListItemText, rehypeMdxExtractEndpoint, rehypeMdxExtractExamples, rehypeParamFieldIds, rehypeRawComponents, rehypeTable, rehypeUnicodeIds, rehypeZoomImages, remarkExtractChangelogFilters, remarkExtractTableOfContents, remarkFileTree, remarkFrames, remarkComponentIds, remarkMdxInjectSnippets, remarkMdxRemoveUnusedVariables, remarkRemoveImports, remarkMdxExtractPanel, remarkResolveRelativeLinks, remarkVideo, remarkMdxClientComponentBoundaries, remarkExtractMultiView, remarkPrompt, remarkUnwrapJsxHeadings, } from './plugins/index.js';
 import { remarkMdxRemoveUnknownJsx } from './plugins/remark/remarkMdxRemoveUnknownJsx/index.js';
 import { remarkMermaid } from './plugins/remark/remarkMermaid.js';
 // avoid running extractors unnecessarily
@@ -24,6 +24,7 @@ export const getMDXOptions = ({ data, remarkPlugins = [], rehypePlugins = [], md
             [remarkExtractMultiView, mdxExtracts],
             remarkMdxRemoveUnusedVariables,
             remarkFrames,
+            remarkFileTree,
             remarkRemoveImports,
             remarkMermaid,
             remarkVideo,

package/dist/mdx/plugins/remark/index.d.ts

@@ -1,4 +1,5 @@
 export * from './remarkMdxInjectSnippets.js';
+export * from './remarkFileTree.js';
 export * from './remarkFrames.js';
 export * from './remarkRemoveImports.js';
 export * from './remarkExtractTableOfContents.js';

package/dist/mdx/plugins/remark/index.js

@@ -1,4 +1,5 @@
 export * from './remarkMdxInjectSnippets.js';
+export * from './remarkFileTree.js';
 export * from './remarkFrames.js';
 export * from './remarkRemoveImports.js';
 export * from './remarkExtractTableOfContents.js';

package/dist/mdx/plugins/remark/remarkFileTree.d.ts

@@ -0,0 +1,2 @@
+import type { Root } from 'mdast';
+export declare const remarkFileTree: () => (tree: Root) => void;

package/dist/mdx/plugins/remark/remarkFileTree.js

@@ -0,0 +1,73 @@
+import { visit } from 'unist-util-visit';
+const isList = (node) => node.type === 'list';
+const isTreeItemElement = (node) => node.type === 'mdxJsxFlowElement' &&
+    'name' in node &&
+    (node.name === 'Tree.Folder' ||
+        node.name === 'Tree.File');
+const isExpression = (node) => node.type === 'mdxFlowExpression' || node.type === 'mdxTextExpression';
+const getNodeText = (node) => {
+    var _a;
+    if (typeof node.value === 'string')
+        return node.value;
+    return ((_a = node.children) !== null && _a !== void 0 ? _a : []).map(getNodeText).join('');
+};
+const describeNode = (node) => {
+    if (node.type === 'mdxJsxFlowElement' && 'name' in node && node.name) {
+        return `<${String(node.name)}>`;
+    }
+    const text = getNodeText(node).trim().replace(/\s+/g, ' ');
+    const preview = text.length > 40 ? `${text.slice(0, 40)}…` : text;
+    return preview ? `Text ("${preview}")` : `A ${node.type} node`;
+};
+const parseListItems = (list) => list.children.map((item) => {
+    const nestedList = item.children.find(isList);
+    const name = item.children
+        .filter((child) => !isList(child))
+        .map(getNodeText)
+        .join('')
+        .trim();
+    return {
+        name: name.replace(/\/+$/, ''),
+        isFolder: name.endsWith('/') || nestedList !== undefined,
+        children: nestedList ? parseListItems(nestedList) : [],
+    };
+});
+const buildTreeElement = (node) => ({
+    type: 'mdxJsxFlowElement',
+    name: node.isFolder ? 'Tree.Folder' : 'Tree.File',
+    attributes: [
+        { type: 'mdxJsxAttribute', name: 'name', value: node.name },
+        ...(node.isFolder
+            ? [{ type: 'mdxJsxAttribute', name: 'defaultOpen', value: null }]
+            : []),
+    ],
+    children: node.children.map(buildTreeElement),
+});
+const collectSalvageableEntries = (node) => {
+    var _a;
+    if (isList(node))
+        return [node];
+    if (isTreeItemElement(node))
+        return [node];
+    return ((_a = node.children) !== null && _a !== void 0 ? _a : []).flatMap(collectSalvageableEntries);
+};
+const sanitizeEntries = (children, componentName) => children.flatMap((child) => {
+    if (isList(child))
+        return parseListItems(child).map(buildTreeElement);
+    if (isTreeItemElement(child)) {
+        child.children = sanitizeEntries(child.children, componentName);
+        return [child];
+    }
+    if (isExpression(child))
+        return [child];
+    const entries = sanitizeEntries(collectSalvageableEntries(child), componentName);
+    console.warn(`${describeNode(child)} cannot be a child of <${componentName}> and was removed.`);
+    return entries;
+});
+export const remarkFileTree = () => (tree) => {
+    visit(tree, 'mdxJsxFlowElement', (node) => {
+        if (node.name !== 'FileTree' && node.name !== 'Tree')
+            return;
+        node.children = sanitizeEntries(node.children, node.name);
+    });
+};

package/dist/mdx/utils.js

@@ -66,6 +66,7 @@ export const allowedComponents = [
     'Tree',
     'Tree.Folder',
     'Tree.File',
+    'FileTree',
     'SnippetGroup',
     'Panel',
     'RequestExample',