gtx-cli 2.5.21 → 2.5.22

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.5.22
+
+### Patch Changes
+
+- [#870](https://github.com/generaltranslation/gt/pull/870) [`4291258`](https://github.com/generaltranslation/gt/commit/42912587a51da045c0b578ac71699fda4a8fcc26) Thanks [@fernando-aviles](https://github.com/fernando-aviles)! - Persist style of YAML frontmatter when applying Mintlify OpenAPI postprocessing
+
 ## 2.5.21
 
 ### Patch Changes

package/dist/utils/processOpenApi.js

@@ -3,7 +3,7 @@ import path from 'node:path';
 import { unified } from 'unified';
 import remarkParse from 'remark-parse';
 import remarkFrontmatter from 'remark-frontmatter';
-import YAML from 'yaml';
+import YAML, { isMap, isScalar } from 'yaml';
 import { logger } from '../console/logger.js';
 import { createFileMapping } from '../formats/files/fileMapping.js';
 const HTTP_METHODS = new Set([
@@ -184,18 +184,18 @@ function rewriteFrontmatter(content, filePath, locale, specs, fileMapping, warni
     const start = yamlNode.position.start.offset;
     const end = yamlNode.position.end.offset;
     const frontmatterRaw = yamlNode.value || '';
-    let parsed;
-    try {
-        parsed = YAML.parse(frontmatterRaw, { prettyErrors: false }) || {};
-    }
-    catch {
+    const doc = YAML.parseDocument(frontmatterRaw, {
+        prettyErrors: false,
+        keepSourceTokens: true,
+    });
+    if (doc.errors?.length)
         return null;
-    }
-    if (!parsed || typeof parsed !== 'object')
+    if (!isMap(doc.contents))
         return null;
     let changed = false;
-    if (typeof parsed.openapi === 'string') {
-        const parsedValue = parseOpenApiValue(parsed.openapi);
+    const openapiNode = doc.get('openapi', true);
+    if (isScalar(openapiNode) && typeof openapiNode.value === 'string') {
+        const parsedValue = parseOpenApiValue(openapiNode.value);
         if (parsedValue) {
             const matchKey = parsedValue.kind === 'operation'
                 ? {
@@ -208,22 +208,23 @@ function rewriteFrontmatter(content, filePath, locale, specs, fileMapping, warni
                 const descriptor = formatOpenApiDescriptor(parsedValue);
                 const localizedSpecPath = resolveLocalizedSpecPath(spec, locale, fileMapping, configDir, parsedValue.specPath || spec.configPath);
                 const newValue = `${localizedSpecPath} ${descriptor}`.trim();
-                if (newValue !== parsed.openapi) {
-                    parsed.openapi = newValue;
+                if (newValue !== openapiNode.value) {
+                    doc.set('openapi', newValue);
                     changed = true;
                 }
             }
         }
     }
-    if (typeof parsed['openapi-schema'] === 'string') {
-        const parsedValue = parseSchemaValue(parsed['openapi-schema']);
+    const schemaNode = doc.get('openapi-schema', true);
+    if (isScalar(schemaNode) && typeof schemaNode.value === 'string') {
+        const parsedValue = parseSchemaValue(schemaNode.value);
         if (parsedValue) {
             const spec = resolveSpec(parsedValue.specPath, specs, filePath, configDir, warnings, `schema "${parsedValue.schemaName}"`, { type: 'schema', key: parsedValue.schemaName });
             if (spec) {
                 const localizedSpecPath = resolveLocalizedSpecPath(spec, locale, fileMapping, configDir, parsedValue.specPath || spec.configPath);
                 const newValue = `${localizedSpecPath} ${parsedValue.schemaName}`.trim();
-                if (newValue !== parsed['openapi-schema']) {
-                    parsed['openapi-schema'] = newValue;
+                if (newValue !== schemaNode.value) {
+                    doc.set('openapi-schema', newValue);
                     changed = true;
                 }
             }
@@ -231,7 +232,7 @@ function rewriteFrontmatter(content, filePath, locale, specs, fileMapping, warni
     }
     if (!changed)
         return null;
-    const fmString = YAML.stringify(parsed).trimEnd();
+    const fmString = doc.toString().trimEnd();
     const rebuilt = `${content.slice(0, start)}---\n${fmString}\n---${content.slice(end)}`;
     return { changed, content: rebuilt };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtx-cli",
-  "version": "2.5.21",
+  "version": "2.5.22",
   "main": "dist/index.js",
   "bin": "dist/main.js",
   "files": [