gtx-cli 2.1.18 → 2.1.19

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # gtx-cli
 
+## 2.1.19
+
+### Patch Changes
+
+- [#641](https://github.com/generaltranslation/gt/pull/641) [`4c67f77`](https://github.com/generaltranslation/gt/commit/4c67f775ee892b47eebcc3178c00ad6547a84d84) Thanks [@fernando-aviles](https://github.com/fernando-aviles)! - Encoding placeholders that break MDX parse
+
 ## 2.1.18
 
 ### Patch Changes

package/dist/utils/addExplicitAnchorIds.js

@@ -5,6 +5,7 @@ import remarkFrontmatter from 'remark-frontmatter';
 import remarkStringify from 'remark-stringify';
 import { visit } from 'unist-util-visit';
 import { logWarning } from '../console/logging.js';
+import { encodeAnglePlaceholders } from './encodePlaceholders.js';
 /**
  * Generates a slug from heading text
  */
@@ -173,6 +174,9 @@ function applyInlineIds(translatedContent, idMappings) {
     // Convert the modified AST back to MDX string
     try {
         const stringifyProcessor = unified()
+            .use(remarkFrontmatter, ['yaml', 'toml'])
+            .use(remarkMdx)
+            .use(encodeAnglePlaceholders)
             .use(remarkStringify, {
             bullet: '-',
             emphasis: '_',
@@ -186,10 +190,9 @@ function applyInlineIds(translatedContent, idMappings) {
                     return node.value;
                 },
             },
-        })
-            .use(remarkFrontmatter, ['yaml', 'toml'])
-            .use(remarkMdx);
-        let content = stringifyProcessor.stringify(processedAst);
+        });
+        const outTree = stringifyProcessor.runSync(processedAst);
+        let content = stringifyProcessor.stringify(outTree);
         // Handle newline formatting to match original input
         if (content.endsWith('\n') && !translatedContent.endsWith('\n')) {
             content = content.slice(0, -1);

package/dist/utils/encodePlaceholders.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from 'unified';
+import type { Root } from 'mdast';
+/**
+ * Re-encode angle-bracket placeholders like <accountName> -> &lt;accountName&gt;
+ * in plain text, to prevent MDX JSX parsing on re-parse.
+ *
+ * - Only touches Text nodes.
+ * - Idempotent: already-encoded entities are left unchanged.
+ * - Does NOT affect actual MDX/JSX elements because those are not text nodes.
+ */
+export declare const encodeAnglePlaceholders: Plugin<[], Root>;

package/dist/utils/encodePlaceholders.js

@@ -0,0 +1,30 @@
+import { findAndReplace } from 'mdast-util-find-and-replace';
+const IGNORE_PARENTS = [
+    'code',
+    'inlineCode',
+    'mdxFlowExpression',
+    'mdxTextExpression',
+    'mdxjsEsm',
+    'yaml',
+    'toml',
+    'math',
+    'inlineMath',
+];
+/**
+ * Re-encode angle-bracket placeholders like <accountName> -> &lt;accountName&gt;
+ * in plain text, to prevent MDX JSX parsing on re-parse.
+ *
+ * - Only touches Text nodes.
+ * - Idempotent: already-encoded entities are left unchanged.
+ * - Does NOT affect actual MDX/JSX elements because those are not text nodes.
+ */
+export const encodeAnglePlaceholders = function () {
+    return (tree) => {
+        findAndReplace(tree, [
+            [
+                /<([A-Za-z][\w.-]*)>/g, // <content>, <con-tent>, <con.tent>, <con_tent>
+                (_match, name) => `&lt;${name}&gt;`,
+            ],
+        ], { ignore: IGNORE_PARENTS });
+    };
+};

package/dist/utils/localizeStaticUrls.js

@@ -7,6 +7,7 @@ import remarkMdx from 'remark-mdx';
 import remarkFrontmatter from 'remark-frontmatter';
 import remarkStringify from 'remark-stringify';
 import { visit } from 'unist-util-visit';
+import { encodeAnglePlaceholders } from './encodePlaceholders.js';
 const { isMatch } = micromatch;
 /**
  * Localizes static urls in content files.
@@ -370,6 +371,9 @@ function transformMdxUrls(mdxContent, defaultLocale, targetLocale, hideDefaultLo
     let content;
     try {
         const stringifyProcessor = unified()
+            .use(remarkFrontmatter, ['yaml', 'toml'])
+            .use(remarkMdx)
+            .use(encodeAnglePlaceholders)
             .use(remarkStringify, {
             bullet: '-',
             emphasis: '_',
@@ -377,10 +381,15 @@ function transformMdxUrls(mdxContent, defaultLocale, targetLocale, hideDefaultLo
             rule: '-',
             ruleRepetition: 3,
             ruleSpaces: false,
-        })
-            .use(remarkFrontmatter, ['yaml', 'toml'])
-            .use(remarkMdx);
-        content = stringifyProcessor.stringify(processedAst);
+            handlers: {
+                // Handler to prevent escaping (avoids '<' -> '\<')
+                text(node) {
+                    return node.value;
+                },
+            },
+        });
+        const outTree = stringifyProcessor.runSync(processedAst);
+        content = stringifyProcessor.stringify(outTree);
     }
     catch (error) {
         console.warn(`Failed to stringify MDX content: ${error instanceof Error ? error.message : String(error)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtx-cli",
-  "version": "2.1.18",
+  "version": "2.1.19",
   "main": "dist/index.js",
   "bin": "dist/main.js",
   "files": [
@@ -91,6 +91,7 @@
     "json-pointer": "^0.6.2",
     "jsonpath-plus": "^10.3.0",
     "jsonpointer": "^5.0.1",
+    "mdast-util-find-and-replace": "^3.0.2",
     "micromatch": "^4.0.8",
     "open": "^10.1.1",
     "ora": "^8.2.0",