@mintlify/common 1.0.1176 → 1.0.1178

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

@@ -1,4 +1,4 @@
 import type { Root } from 'mdast';
 export declare const remarkMdxRemoveUnknownJsx: ({ allowlist }?: {
     allowlist?: string[];
-}) => (tree: Root) => Root | import("mdast-util-mdxjs-esm").MdxjsEsm | import("mdast-util-mdx-expression").MdxFlowExpression | import("mdast-util-mdx-expression").MdxTextExpression | import("mdast").Code | import("mdast").Delete | import("mdast").Link | import("mdast-util-mdx").MdxJsxFlowElement | import("mdast").Table | import("mdast").Blockquote | import("mdast").Break | import("mdast").Definition | import("mdast").Emphasis | import("mdast").FootnoteDefinition | import("mdast").FootnoteReference | import("mdast").Heading | import("mdast").Html | import("mdast").Image | import("mdast").ImageReference | import("mdast").InlineCode | import("mdast").LinkReference | import("mdast").List | import("mdast").ListItem | import("mdast").Paragraph | import("mdast").Strong | import("mdast").TableCell | import("mdast").TableRow | import("mdast").Text | import("mdast").ThematicBreak | import("mdast").Yaml | import("mdast-util-math").InlineMath | import("mdast-util-math").Math | import("mdast-util-mdx").MdxJsxTextElement;
+}) => (tree: Root) => Root | import("mdast").Link | import("mdast").Delete | import("mdast").Code | import("mdast").Text | import("mdast").Heading | import("mdast-util-mdx").MdxJsxFlowElement | import("mdast-util-mdx").MdxJsxTextElement | import("mdast").Blockquote | import("mdast").Break | import("mdast").Definition | import("mdast").Emphasis | import("mdast").FootnoteDefinition | import("mdast").FootnoteReference | import("mdast").Html | import("mdast").Image | import("mdast").ImageReference | import("mdast").InlineCode | import("mdast").LinkReference | import("mdast").List | import("mdast").ListItem | import("mdast").Paragraph | import("mdast").Strong | import("mdast").Table | import("mdast").TableCell | import("mdast").TableRow | import("mdast").ThematicBreak | import("mdast").Yaml | import("mdast-util-math").InlineMath | import("mdast-util-math").Math | import("mdast-util-mdx-expression").MdxTextExpression | import("mdast-util-mdx-expression").MdxFlowExpression | import("mdast-util-mdxjs-esm").MdxjsEsm;

package/dist/mdx/remark.d.ts

@@ -5,5 +5,6 @@ export declare const coreRemarkMdxPlugins: PluggableList;
 export declare const coreRemark: import("unified").Processor<Root, undefined, undefined, Root, string>;
 export declare const getAST: (str: string, filePath?: string) => Root;
 export declare const stringifyTree: (tree: Root) => string;
+export declare const stringifyTreeForAgents: (tree: Root) => string;
 export declare function stripVisibilityForMarkdown(mdx: string): string;
 export declare function transformContentForMarkdown(mdx: string, mentionOptions?: RemarkUserMentionsOptions): string;

package/dist/mdx/remark.js

@@ -17,6 +17,13 @@ export const coreRemarkMdxPlugins = [
     remarkMath,
 ];
 export const coreRemark = remark().use(coreRemarkMdxPlugins).freeze();
+const agentRemarkMdxPlugins = [
+    remarkMdx,
+    [remarkGfm, { tablePipeAlign: false }],
+    [remarkFrontmatter, ['yaml', 'toml']],
+    remarkMath,
+];
+const agentRemark = remark().use(agentRemarkMdxPlugins).freeze();
 export const getAST = (str, filePath) => {
     if (isJsxOrTsx(filePath)) {
         return getJsxEsmTree(str, filePath);
@@ -24,14 +31,15 @@ export const getAST = (str, filePath) => {
     return coreRemark().parse(preprocessCustomHeadingIds(preprocessMdxFragmentCode(str)));
 };
 export const stringifyTree = (tree) => coreRemark().use(remarkStringify).stringify(tree);
+export const stringifyTreeForAgents = (tree) => agentRemark().use(remarkStringify).stringify(tree);
 export function stripVisibilityForMarkdown(mdx) {
     const tree = getAST(mdx);
     remarkVisibilityForMarkdown()(tree);
-    return stringifyTree(tree);
+    return stringifyTreeForAgents(tree);
 }
 export function transformContentForMarkdown(mdx, mentionOptions = {}) {
     const tree = getAST(mdx);
     remarkVisibilityForMarkdown()(tree);
     remarkUserMentions(mentionOptions)(tree);
-    return stringifyTree(tree);
+    return stringifyTreeForAgents(tree);
 }

package/dist/navigation/decoratedNavTree.js

@@ -54,8 +54,14 @@ function findPage(node, path) {
 }
 export const decoratedNavContains = (node, path) => contains(node, normalizeNavPath(path));
 export const findDecoratedNavPage = (node, path) => findPage(node, normalizeNavPath(path));
+// reachable through groups and pages alone, without entering a division
+function containsDirect(node, path) {
+    return matches(node, path) || decoratedNavChildren(node).some((c) => containsDirect(c, path));
+}
 // the nodes whose own pages (not a nested division's) hold the path: the
-// root for a flat nav, else the innermost division chain down to the page
+// root for a flat nav, else the innermost division chain down to the page.
+// a child that only reaches the path through divisions of its own (a menu
+// item split by version) is passed through, never the owner itself
 export function decoratedNavSections(nav, path) {
     const target = normalizeNavPath(path);
     const out = [];
@@ -64,8 +70,13 @@ export function decoratedNavSections(nav, path) {
             if (contains(division, target))
                 walk(division);
         }
-        if (decoratedNavChildren(node).some((c) => contains(c, target)))
+        const children = decoratedNavChildren(node);
+        if (children.some((c) => containsDirect(c, target)))
             out.push(node);
+        for (const child of children) {
+            if (!containsDirect(child, target) && contains(child, target))
+                walk(child);
+        }
     };
     walk(nav);
     return out;

package/dist/navigation/decoratedNavTree.test.js

@@ -48,4 +48,16 @@ describe('decoratedNavSections', () => {
         };
         expect(decoratedNavSections(flat, '/a')).toEqual([flat]);
     });
+    it('passes through a menu item split by version to the version that owns the page', () => {
+        const v3 = {
+            version: 'v3',
+            groups: [{ group: 'Start', pages: [{ href: '/studio/v3', title: 'Overview' }] }],
+        };
+        const v1 = { version: 'v1', pages: [{ href: '/studio/v1', title: 'v1' }] };
+        const menuNav = {
+            tabs: [{ tab: 'Studio', menu: [{ item: 'Studio', versions: [v3, v1] }] }],
+        };
+        expect(decoratedNavSections(menuNav, '/studio/v3')).toEqual([v3]);
+        expect(decoratedNavSections(menuNav, '/studio/v1')).toEqual([v1]);
+    });
 });