@mintlify/common 1.0.847 → 1.0.848

package/dist/openapi/generateOpenApiPages.js

@@ -5,6 +5,7 @@ import { slugToTitle } from '../slug/slugToTitle.js';
 import { buildOpenApiMetaTag } from './buildOpenApiMetaTag.js';
 import { prepareStringToBeValidFilename, generateUniqueFilenameWithoutExtension, } from './filenameUtils.js';
 import { getOpenApiTitleAndDescription } from './getOpenApiTitleAndDescription.js';
+import { getTagDisplayName } from './getTagDisplayName.js';
 /**
  * Build MDX content string matching what createOpenApiFrontmatter produces in prebuild.
  * Includes title, description, openapi tag, version, deprecated, and all x-mint metadata
@@ -103,9 +104,10 @@ export function generateOpenApiPages(opts) {
                 continue;
             const xMint = operation['x-mint'];
             const xMintGroups = getXMintGroups(pathItem, operation);
-            const groupName = (_b = operation.tags) === null || _b === void 0 ? void 0 : _b[0];
+            const tagName = (_b = operation.tags) === null || _b === void 0 ? void 0 : _b[0];
+            const groupName = getTagDisplayName(tagName, spec);
             let title = (_c = prepareStringToBeValidFilename(operation.summary)) !== null && _c !== void 0 ? _c : `${method}-${prepareStringToBeValidFilename(apiPath)}`;
-            let folder = (_d = prepareStringToBeValidFilename(groupName)) !== null && _d !== void 0 ? _d : '';
+            let folder = (_d = prepareStringToBeValidFilename(tagName)) !== null && _d !== void 0 ? _d : '';
             let base = posixJoin(outDir, folder, title);
             if (xMint === null || xMint === void 0 ? void 0 : xMint.href) {
                 const href = xMint.href.startsWith('/') ? xMint.href.slice(1) : xMint.href;
@@ -167,9 +169,10 @@ export function generateOpenApiPages(opts) {
                 if (operation['x-excluded'])
                     continue;
                 const xMint = operation['x-mint'];
-                const groupName = (_j = operation.tags) === null || _j === void 0 ? void 0 : _j[0];
+                const tagName = (_j = operation.tags) === null || _j === void 0 ? void 0 : _j[0];
+                const groupName = getTagDisplayName(tagName, spec);
                 let title = (_k = prepareStringToBeValidFilename(operation.summary)) !== null && _k !== void 0 ? _k : `${prepareStringToBeValidFilename(webhook)}`;
-                let folder = (_l = prepareStringToBeValidFilename(groupName)) !== null && _l !== void 0 ? _l : '';
+                let folder = (_l = prepareStringToBeValidFilename(tagName)) !== null && _l !== void 0 ? _l : '';
                 let base = posixJoin(outDir, folder, title);
                 if (xMint === null || xMint === void 0 ? void 0 : xMint.href) {
                     const href = xMint.href.startsWith('/') ? xMint.href.slice(1) : xMint.href;

package/dist/openapi/getTagDisplayName.d.ts

@@ -0,0 +1,5 @@
+import { OpenAPI } from 'openapi-types';
+/**
+ * Resolves the display name for a tag. Prioritizes x-group extension, falls back to tag name.
+ */
+export declare const getTagDisplayName: (tagName: string | undefined, schema: OpenAPI.Document) => string | undefined;

package/dist/openapi/getTagDisplayName.js

@@ -0,0 +1,13 @@
+/**
+ * Resolves the display name for a tag. Prioritizes x-group extension, falls back to tag name.
+ */
+export const getTagDisplayName = (tagName, schema) => {
+    var _a;
+    if (!tagName)
+        return undefined;
+    const tags = schema.tags;
+    if (!tags)
+        return tagName;
+    const tagDef = tags.find((t) => t.name === tagName);
+    return (_a = tagDef === null || tagDef === void 0 ? void 0 : tagDef['x-group']) !== null && _a !== void 0 ? _a : tagName;
+};

package/dist/openapi/index.d.ts

@@ -12,3 +12,4 @@ export { openApiMetaTagToEndpointRef } from './endpointRef.js';
 export { prepareStringToBeValidFilename, generateUniqueFilenameWithoutExtension, } from './filenameUtils.js';
 export { findNavGroup, DEFAULT_API_GROUP_NAME, DEFAULT_WEBSOCKETS_GROUP_NAME, } from './findNavGroup.js';
 export { generateOpenApiPages, buildGeneratedMdxContent, type GeneratedApiPage, type GenerateOpenApiPagesOptions, } from './generateOpenApiPages.js';
+export { getTagDisplayName } from './getTagDisplayName.js';

package/dist/openapi/index.js

@@ -12,3 +12,4 @@ export { openApiMetaTagToEndpointRef } from './endpointRef.js';
 export { prepareStringToBeValidFilename, generateUniqueFilenameWithoutExtension, } from './filenameUtils.js';
 export { findNavGroup, DEFAULT_API_GROUP_NAME, DEFAULT_WEBSOCKETS_GROUP_NAME, } from './findNavGroup.js';
 export { generateOpenApiPages, buildGeneratedMdxContent, } from './generateOpenApiPages.js';
+export { getTagDisplayName } from './getTagDisplayName.js';