@mintlify/common 1.0.844 → 1.0.846

package/dist/divisions/generatePathToHiddenDict.js

@@ -1,6 +1,7 @@
 import { divisions } from '@mintlify/validation';
 import { isPage } from '../navigation/isPage.js';
 import { optionallyRemoveLeadingSlash } from '../optionallyRemoveLeadingSlash.js';
+import { iterateObjectArrayProperty } from './iterateObjectArrayProperty.js';
 /**
  * Generates a map from page paths to their hidden status based on navigation hierarchy.
  * A page is hidden if any parent group/division has hidden: true
@@ -38,13 +39,6 @@ function generatePathToHiddenDictRecursive(pathToHiddenDict, nav, parentHidden)
         }
     }
     for (const key of ['groups', ...divisions]) {
-        if (key in nav) {
-            const items = nav[key];
-            if (Array.isArray(items)) {
-                for (const item of items) {
-                    generatePathToHiddenDictRecursive(pathToHiddenDict, item, effectiveHidden);
-                }
-            }
-        }
+        iterateObjectArrayProperty(nav, key, (item) => generatePathToHiddenDictRecursive(pathToHiddenDict, item, effectiveHidden));
     }
 }

package/dist/divisions/generatePathToLanguageDict.js

@@ -1,5 +1,6 @@
 import { divisions, } from '@mintlify/validation';
 import { optionallyRemoveLeadingSlash } from '../optionallyRemoveLeadingSlash.js';
+import { iterateObjectArrayProperty } from './iterateObjectArrayProperty.js';
 export function generatePathToLanguageDict(nav) {
     const pathToLanguageDict = new Map();
     traverseNavigation(pathToLanguageDict, nav, undefined);
@@ -15,10 +16,7 @@ function traverseNavigation(pathToLanguageDict, nav, nearestLanguage) {
         return;
     }
     for (const division of ['groups', ...divisions]) {
-        if (division in nav && Array.isArray(nav[division])) {
-            const items = nav[division];
-            items.forEach((item) => traverseNavigation(pathToLanguageDict, item, currentLanguage));
-        }
+        iterateObjectArrayProperty(nav, division, (item) => traverseNavigation(pathToLanguageDict, item, currentLanguage));
     }
 }
 function traverseGroup(pathToLanguageDict, entry, nearestLanguage) {

package/dist/divisions/generatePathToPublicDict.js

@@ -1,6 +1,7 @@
 import { divisions } from '@mintlify/validation';
 import { isPage } from '../navigation/isPage.js';
 import { optionallyRemoveLeadingSlash } from '../optionallyRemoveLeadingSlash.js';
+import { iterateObjectArrayProperty } from './iterateObjectArrayProperty.js';
 /**
  * Generates a map from page paths to their public status based on navigation hierarchy.
  * A page is public if it or any parent group/division has public: true.
@@ -37,13 +38,6 @@ function generatePathToPublicDictRecursive(pathToPublicDict, nav, parentPublic)
         }
     }
     for (const key of ['groups', ...divisions]) {
-        if (key in nav) {
-            const items = nav[key];
-            if (Array.isArray(items)) {
-                for (const item of items) {
-                    generatePathToPublicDictRecursive(pathToPublicDict, item, effectivePublic);
-                }
-            }
-        }
+        iterateObjectArrayProperty(nav, key, (item) => generatePathToPublicDictRecursive(pathToPublicDict, item, effectivePublic));
     }
 }

package/dist/divisions/generatePathToVersionDict.js

@@ -1,6 +1,7 @@
 import { divisions, } from '@mintlify/validation';
 import { isPage } from '../navigation/isPage.js';
 import { optionallyRemoveLeadingSlash } from '../optionallyRemoveLeadingSlash.js';
+import { iterateObjectArrayProperty } from './iterateObjectArrayProperty.js';
 /**
  * Assumes page hrefs in navWithPageContext have a leading / but config page paths do not.
  * Outputted dictionary will NOT have a leading / in the dictionary keys.
@@ -34,16 +35,11 @@ function generatePathToVersionDictRecursive(pathToVersionDict, nav, nearestVersi
         }
     }
     for (const key of ['groups', ...divisions]) {
-        if (key in nav) {
-            const items = nav[key];
-            if (Array.isArray(items)) {
-                for (const item of items) {
-                    let version = nearestVersion;
-                    if (key === 'versions')
-                        version = item.version;
-                    generatePathToVersionDictRecursive(pathToVersionDict, item, version);
-                }
-            }
-        }
+        iterateObjectArrayProperty(nav, key, (item) => {
+            let version = nearestVersion;
+            if (key === 'versions')
+                version = item.version;
+            generatePathToVersionDictRecursive(pathToVersionDict, item, version);
+        });
     }
 }

package/dist/divisions/generatePathToVersionDictForDocsConfig.js

@@ -1,5 +1,6 @@
 import { divisions } from '@mintlify/validation';
 import { optionallyRemoveLeadingSlash } from '../optionallyRemoveLeadingSlash.js';
+import { iterateObjectArrayProperty } from './iterateObjectArrayProperty.js';
 export function generatePathToVersionDictForDocsConfig(nav) {
     const pathToVersionDict = new Map();
     traverseNavigation(pathToVersionDict, nav, undefined);
@@ -15,10 +16,7 @@ function traverseNavigation(pathToVersionDict, nav, nearestVersion) {
         return;
     }
     for (const division of ['groups', 'tabs', ...divisions]) {
-        if (division in nav) {
-            const items = nav[division];
-            items.forEach((item) => traverseNavigation(pathToVersionDict, item, currentVersion));
-        }
+        iterateObjectArrayProperty(nav, division, (item) => traverseNavigation(pathToVersionDict, item, currentVersion));
     }
 }
 function traverseGroup(pathToVersionDict, entry, nearestVersion) {

package/dist/divisions/index.d.ts

@@ -1,3 +1,4 @@
+export * from './iterateObjectArrayProperty.js';
 export * from './generatePathToHiddenDict.js';
 export * from './generatePathToVersionDict.js';
 export * from './generatePathToVersionDictForDocsConfig.js';

package/dist/divisions/index.js

@@ -1,3 +1,4 @@
+export * from './iterateObjectArrayProperty.js';
 export * from './generatePathToHiddenDict.js';
 export * from './generatePathToVersionDict.js';
 export * from './generatePathToVersionDictForDocsConfig.js';

package/dist/divisions/iterateObjectArrayProperty.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reads `obj[key]` when `key` is only known at runtime.
+ *
+ * Navigation config types such as `DecoratedNavigationConfig` are large discriminated unions
+ * (`{ languages: … } | { versions: … } | …`). TypeScript cannot type `obj[key]` for `key: string`
+ * without collapsing the union. Call sites pass validated config from Zod; we narrow with
+ * `Array.isArray` and `typeof item === 'object'`, then assert each element to `T` once.
+ */
+export declare function readObjectArrayProperty<T extends object>(obj: object, key: string): T[] | undefined;
+export declare function iterateObjectArrayProperty<T extends object>(obj: object, key: string, visit: (element: T) => void): void;

package/dist/divisions/iterateObjectArrayProperty.js

@@ -0,0 +1,30 @@
+/**
+ * Reads `obj[key]` when `key` is only known at runtime.
+ *
+ * Navigation config types such as `DecoratedNavigationConfig` are large discriminated unions
+ * (`{ languages: … } | { versions: … } | …`). TypeScript cannot type `obj[key]` for `key: string`
+ * without collapsing the union. Call sites pass validated config from Zod; we narrow with
+ * `Array.isArray` and `typeof item === 'object'`, then assert each element to `T` once.
+ */
+export function readObjectArrayProperty(obj, key) {
+    if (!(key in obj))
+        return undefined;
+    const raw = obj[key];
+    if (!Array.isArray(raw))
+        return undefined;
+    const out = [];
+    for (const item of raw) {
+        if (typeof item === 'object' && item !== null) {
+            out.push(item);
+        }
+    }
+    return out;
+}
+export function iterateObjectArrayProperty(obj, key, visit) {
+    const items = readObjectArrayProperty(obj, key);
+    if (!items)
+        return;
+    for (const item of items) {
+        visit(item);
+    }
+}

package/dist/getFileCategory.d.ts

@@ -1,7 +1,7 @@
 export type FileCategoryOptions = {
     importedFiles?: Set<string>;
 };
-export type PotentialFileCategory = 'page' | 'snippet' | 'mintConfig' | 'potentialYamlOpenApiSpec' | 'potentialJsonOpenApiSpec' | 'staticFile' | 'snippet-v2' | 'css' | 'js' | 'docsConfig' | 'generatedStaticFile' | 'mintIgnore' | null;
+export type PotentialFileCategory = 'page' | 'snippet' | 'mintConfig' | 'potentialYamlOpenApiSpec' | 'potentialJsonOpenApiSpec' | 'staticFile' | 'snippet-v2' | 'css' | 'js' | 'docsConfig' | 'generatedStaticFile' | 'skillFile' | 'mintIgnore' | null;
 export type FileCategory = Omit<PotentialFileCategory, 'potentialYamlOpenApiSpec' | 'potentialJsonOpenApiSpec'> | 'openApi' | null;
 export declare const generatedStaticFiles: readonly ["llms.txt", "robots.txt", "sitemap.xml", "llms-full.txt"];
 export type GeneratedStaticFile = (typeof generatedStaticFiles)[number];

package/dist/getFileCategory.js

@@ -92,6 +92,10 @@ export const getFileCategory = (filePath, options) => {
     if (generatedStaticFiles.includes(parsed.base)) {
         return 'generatedStaticFile';
     }
+    if (normalizedFilePath === 'skill.md' ||
+        (normalizedFilePath.startsWith('.mintlify/skills/') && parsed.base === 'skill.md')) {
+        return 'skillFile';
+    }
     if ((normalizedFilePath.startsWith('_snippets/') || normalizedFilePath.startsWith('snippets/')) &&
         SNIPPET_EXTENSIONS.some((ext) => extension === ext)) {
         if (normalizedFilePath.startsWith('_snippets/')) {

package/dist/navigation/getAllPathsInDocsNav.js

@@ -1,4 +1,5 @@
 import { divisions } from '@mintlify/validation';
+import { readObjectArrayProperty } from '../divisions/iterateObjectArrayProperty.js';
 export function getAllPathsInDocsNav(nav, paths = []) {
     if ('pages' in nav) {
         if ('root' in nav && typeof nav.root === 'string') {
@@ -8,10 +9,10 @@ export function getAllPathsInDocsNav(nav, paths = []) {
         return paths;
     }
     for (const division of ['groups', ...divisions]) {
-        if (division in nav) {
-            const items = nav[division];
-            items.forEach((item) => getAllPathsInDocsNav(item, paths));
-        }
+        const items = readObjectArrayProperty(nav, division);
+        if (!items)
+            continue;
+        items.forEach((item) => getAllPathsInDocsNav(item, paths));
     }
     return paths;
 }

package/dist/navigation/getFirstPageFromNavConfig.js

@@ -1,4 +1,5 @@
 import { divisions, } from '@mintlify/validation';
+import { readObjectArrayProperty } from '../divisions/iterateObjectArrayProperty.js';
 import { replaceSlashIndex } from '../slug/replaceSlashIndex.js';
 function getFirstFromPageOrGroup(entry) {
     if (typeof entry === 'string') {
@@ -31,17 +32,15 @@ export function getFirstPageFromNavConfig(nav) {
         }
     }
     for (const key of divisions) {
-        if (key in nav) {
-            const items = nav[key];
-            if (Array.isArray(items)) {
-                for (const item of items) {
-                    if (typeof item === 'object' && 'hidden' in item && item.hidden)
-                        continue;
-                    const result = getFirstPageFromNavConfig(item);
-                    if (result !== undefined)
-                        return result;
-                }
-            }
+        const items = readObjectArrayProperty(nav, key);
+        if (!items)
+            continue;
+        for (const item of items) {
+            if (typeof item === 'object' && 'hidden' in item && item.hidden)
+                continue;
+            const result = getFirstPageFromNavConfig(item);
+            if (result !== undefined)
+                return result;
         }
     }
     return undefined;

package/dist/navigation/getFirstPageFromNavigation.js

@@ -1,4 +1,5 @@
 import { divisions, } from '@mintlify/validation';
+import { readObjectArrayProperty } from '../divisions/iterateObjectArrayProperty.js';
 import { replaceSlashIndex } from '../slug/replaceSlashIndex.js';
 import { checkNavAccess, isPage } from './index.js';
 import { prioritizeDefaultDivisionItem } from './prioritize-default-division-item.js';
@@ -42,19 +43,17 @@ export function getFirstPageFromNavigation(node, userGroups, shouldCheckNavAcces
         }
     }
     for (const key of divisions) {
-        if (key in node) {
-            const items = node[key];
-            if (Array.isArray(items)) {
-                const orderedItems = prioritizeDefaultDivisionItem(items, key);
-                for (const item of orderedItems) {
-                    if (typeof item === 'object' && 'hidden' in item && item.hidden)
-                        continue;
-                    const page = getFirstPageFromNavigation(item, userGroups, shouldCheckNavAccess, isPreview);
-                    if (page) {
-                        page.href = replaceSlashIndex(page.href);
-                        return page;
-                    }
-                }
+        const items = readObjectArrayProperty(node, key);
+        if (!items)
+            continue;
+        const orderedItems = prioritizeDefaultDivisionItem(items, key);
+        for (const item of orderedItems) {
+            if (typeof item === 'object' && 'hidden' in item && item.hidden)
+                continue;
+            const page = getFirstPageFromNavigation(item, userGroups, shouldCheckNavAccess, isPreview);
+            if (page) {
+                page.href = replaceSlashIndex(page.href);
+                return page;
             }
         }
     }