@mintlify/common 1.0.934 → 1.0.935

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

@@ -22,25 +22,110 @@ function getVisibilityFor(node) {
     }
     return undefined;
 }
-function transformChildren(children) {
-    return children.flatMap((child) => transformNode(child));
+function getStringAttribute(node, name) {
+    for (const attr of node.attributes) {
+        if (attr.type === 'mdxJsxAttribute' && attr.name === name && typeof attr.value === 'string') {
+            return attr.value;
+        }
+    }
+    return undefined;
+}
+// `export * from` is intentionally ignored: it exposes no statically-knowable
+// names and creates no page-local JSX bindings in MDX, so there is nothing to
+// collect for ghost-tag stripping.
+function collectEsmIdentifiers(children) {
+    var _a, _b, _c;
+    const names = new Set();
+    for (const child of children) {
+        if (child.type !== 'mdxjsEsm')
+            continue;
+        for (const statement of (_c = (_b = (_a = child.data) === null || _a === void 0 ? void 0 : _a.estree) === null || _b === void 0 ? void 0 : _b.body) !== null && _c !== void 0 ? _c : []) {
+            if (statement.type === 'ImportDeclaration') {
+                for (const specifier of statement.specifiers) {
+                    names.add(specifier.local.name);
+                }
+            }
+            if (statement.type === 'ExportNamedDeclaration') {
+                if (statement.declaration) {
+                    if (statement.declaration.type === 'VariableDeclaration') {
+                        for (const declarator of statement.declaration.declarations) {
+                            if (declarator.id.type === 'Identifier') {
+                                names.add(declarator.id.name);
+                            }
+                        }
+                    }
+                    else if (statement.declaration.id) {
+                        names.add(statement.declaration.id.name);
+                    }
+                }
+                // Re-exports: `export { Panel } from '...'` keep names in specifiers
+                for (const specifier of statement.specifiers) {
+                    if (specifier.local.type === 'Identifier') {
+                        names.add(specifier.local.name);
+                    }
+                    if (specifier.exported.type === 'Identifier') {
+                        names.add(specifier.exported.name);
+                    }
+                }
+            }
+            if (statement.type === 'ExportDefaultDeclaration') {
+                const declaration = statement.declaration;
+                if ((declaration.type === 'FunctionDeclaration' || declaration.type === 'ClassDeclaration') &&
+                    declaration.id) {
+                    names.add(declaration.id.name);
+                }
+            }
+        }
+    }
+    return names;
 }
-function transformNode(node) {
-    if (isMdxJsxElement(node) && node.name === 'Visibility') {
-        const audience = getVisibilityFor(node);
-        if (audience === 'humans') {
-            return [];
+function transformChildren(children, strippedNames) {
+    return children.flatMap((child) => transformNode(child, strippedNames));
+}
+function transformNode(node, strippedNames) {
+    var _a;
+    // The output is terminal agent-facing markdown, never re-parsed as MDX, so
+    // ESM is dropped wholesale even when kept content references its components.
+    if (node.type === 'mdxjsEsm') {
+        return [];
+    }
+    if (isMdxJsxElement(node)) {
+        if (node.name === 'Visibility') {
+            const audience = getVisibilityFor(node);
+            if (audience === 'humans') {
+                return [];
+            }
+            if (audience === 'agents') {
+                return transformChildren(node.children, strippedNames);
+            }
         }
-        if (audience === 'agents') {
-            return transformChildren(node.children);
+        // Usages of components whose page-local definition was stripped above
+        // would serialize as unresolvable ghost tags; unwrap them so only their
+        // real child content (if any) survives. A title attribute often labels
+        // that content, so carry it over as emphasized text.
+        const baseName = (_a = node.name) === null || _a === void 0 ? void 0 : _a.split('.')[0];
+        if (baseName && strippedNames.has(baseName)) {
+            const unwrapped = transformChildren(node.children, strippedNames);
+            const title = getStringAttribute(node, 'title');
+            if (node.type === 'mdxJsxFlowElement' && title) {
+                return [
+                    {
+                        type: 'paragraph',
+                        children: [{ type: 'strong', children: [{ type: 'text', value: title }] }],
+                    },
+                    ...unwrapped,
+                ];
+            }
+            return unwrapped;
         }
     }
     if ('children' in node && Array.isArray(node.children)) {
-        const next = transformChildren(node.children);
+        const next = transformChildren(node.children, strippedNames);
         node.children = next;
     }
     return [node];
 }
 export const remarkVisibilityForMarkdown = () => (tree) => {
-    tree.children = transformChildren(tree.children);
+    const strippedNames = collectEsmIdentifiers(tree.children);
+    tree.children = transformChildren(tree.children, strippedNames);
 };