gt 2.17.2 → 2.17.3

package/dist/utils/mdxAnchorSyntax.js

@@ -0,0 +1,113 @@
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkMdx from "remark-mdx";
+import remarkFrontmatter from "remark-frontmatter";
+//#region src/utils/mdxAnchorSyntax.ts
+/**
+* Custom heading IDs (`## Heading {#id}`) break MDX parsing: remark-mdx passes
+* `{#id}` to acorn. Escaping the braces makes the document parse without
+* changing its line count, so mdast line positions still map 1:1 (columns do
+* not). https://mintlify.com/docs/create/headers#custom-heading-ids
+*/
+/** A heading line ending in an unescaped `{#id}`. */
+const UNESCAPED_ANCHOR = /^([ \t]*#{1,6}[ \t]+.*?)[ \t]*\{#([A-Za-z0-9_-]+)\}[ \t]*$/;
+/** A heading line ending in an escaped `\{#id\}`. */
+const ESCAPED_ANCHOR = /^([ \t]*#{1,6}[ \t]+.*?)[ \t]*\\\{#([A-Za-z0-9_-]+)\\\}[ \t]*$/;
+/** Matches an opening or closing fenced-code-block marker. */
+const CODE_FENCE = /^\s*(`{3,}|~{3,})/;
+/** Returns a predicate telling whether a line sits outside a code fence. */
+function createFenceTracker() {
+	let inFence = false;
+	let fence = null;
+	return (line) => {
+		const match = line.match(CODE_FENCE);
+		if (!match) return !inFence;
+		const marker = match[1];
+		if (!inFence) {
+			inFence = true;
+			fence = marker;
+		} else if (fence && marker[0] === fence[0] && marker.length >= fence.length) {
+			inFence = false;
+			fence = null;
+		}
+		return false;
+	};
+}
+/** Maps over a document's lines, leaving fenced code blocks untouched. */
+function mapLinesOutsideCodeFences(content, mapLine) {
+	const isContent = createFenceTracker();
+	return content.split("\n").map((line) => isContent(line) ? mapLine(line) : line).join("\n");
+}
+/** Visits a document's lines with their 0-based index, skipping code fences. */
+function forEachLineOutsideCodeFences(content, visitLine) {
+	const isContent = createFenceTracker();
+	content.split("\n").forEach((line, index) => {
+		if (isContent(line)) visitLine(line, index);
+	});
+}
+/**
+* Escapes `## Heading {#id}` to `## Heading \{#id\}` so MDX can parse it.
+*/
+function neutralizeAnchorIds(content) {
+	let changed = false;
+	return {
+		content: mapLinesOutsideCodeFences(content, (line) => {
+			const match = line.match(UNESCAPED_ANCHOR);
+			if (!match) return line;
+			changed = true;
+			return `${match[1]} \\{#${match[2]}\\}`;
+		}),
+		changed
+	};
+}
+/**
+* Unescapes anchors back to `{#id}`; Mintlify renders `\{` as a literal brace.
+*/
+function restoreAnchorIds(content) {
+	return mapLinesOutsideCodeFences(content, (line) => {
+		const match = line.match(ESCAPED_ANCHOR);
+		if (!match) return line;
+		return `${match[1]} {#${match[2]}}`;
+	});
+}
+/** Builds the parse-only MDX processor shared by every parse site. */
+function createMdxParseProcessor() {
+	return unified().use(remarkParse).use(remarkFrontmatter, ["yaml", "toml"]).use(remarkMdx);
+}
+/**
+* Parses MDX, retrying with anchors escaped; rethrows any other parse error.
+*/
+function parseMdxTolerantly(content) {
+	const processor = createMdxParseProcessor();
+	try {
+		return processor.runSync(processor.parse(content));
+	} catch (error) {
+		const { content: neutralized, changed } = neutralizeAnchorIds(content);
+		if (!changed) throw error;
+		return processor.runSync(processor.parse(neutralized));
+	}
+}
+/**
+* Parses MDX for a pass that stringifies the tree back out. `neutralized` tells
+* the caller whether to run {@link restoreAnchorIds} on its output.
+*/
+function parseMdxForRoundTrip(content) {
+	const processor = createMdxParseProcessor();
+	try {
+		return {
+			ast: processor.runSync(processor.parse(content)),
+			neutralized: false
+		};
+	} catch (error) {
+		const { content: neutralized, changed } = neutralizeAnchorIds(content);
+		if (!changed) throw error;
+		return {
+			ast: processor.runSync(processor.parse(neutralized)),
+			neutralized: true
+		};
+	}
+}
+//#endregion
+export { createMdxParseProcessor, forEachLineOutsideCodeFences, mapLinesOutsideCodeFences, neutralizeAnchorIds, parseMdxForRoundTrip, parseMdxTolerantly, restoreAnchorIds };
+
+//# sourceMappingURL=mdxAnchorSyntax.js.map

package/dist/utils/mdxAnchorSyntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdxAnchorSyntax.js","names":[],"sources":["../../src/utils/mdxAnchorSyntax.ts"],"sourcesContent":["import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkMdx from 'remark-mdx';\nimport remarkFrontmatter from 'remark-frontmatter';\nimport type { Root } from 'mdast';\n\n/**\n * Custom heading IDs (`## Heading {#id}`) break MDX parsing: remark-mdx passes\n * `{#id}` to acorn. Escaping the braces makes the document parse without\n * changing its line count, so mdast line positions still map 1:1 (columns do\n * not). https://mintlify.com/docs/create/headers#custom-heading-ids\n */\n\n/** A heading line ending in an unescaped `{#id}`. */\nconst UNESCAPED_ANCHOR =\n  /^([ \\t]*#{1,6}[ \\t]+.*?)[ \\t]*\\{#([A-Za-z0-9_-]+)\\}[ \\t]*$/;\n\n/** A heading line ending in an escaped `\\{#id\\}`. */\nconst ESCAPED_ANCHOR =\n  /^([ \\t]*#{1,6}[ \\t]+.*?)[ \\t]*\\\\\\{#([A-Za-z0-9_-]+)\\\\\\}[ \\t]*$/;\n\n/** Matches an opening or closing fenced-code-block marker. */\nconst CODE_FENCE = /^\\s*(`{3,}|~{3,})/;\n\n/** Returns a predicate telling whether a line sits outside a code fence. */\nfunction createFenceTracker(): (line: string) => boolean {\n  let inFence = false;\n  let fence: string | null = null;\n\n  return (line: string): boolean => {\n    const match = line.match(CODE_FENCE);\n    if (!match) return !inFence;\n\n    const marker = match[1];\n    if (!inFence) {\n      inFence = true;\n      fence = marker;\n    } else if (\n      fence &&\n      marker[0] === fence[0] &&\n      marker.length >= fence.length\n    ) {\n      inFence = false;\n      fence = null;\n    }\n    return false;\n  };\n}\n\n/** Maps over a document's lines, leaving fenced code blocks untouched. */\nexport function mapLinesOutsideCodeFences(\n  content: string,\n  mapLine: (line: string) => string\n): string {\n  const isContent = createFenceTracker();\n  return content\n    .split('\\n')\n    .map((line) => (isContent(line) ? mapLine(line) : line))\n    .join('\\n');\n}\n\n/** Visits a document's lines with their 0-based index, skipping code fences. */\nexport function forEachLineOutsideCodeFences(\n  content: string,\n  visitLine: (line: string, index: number) => void\n): void {\n  const isContent = createFenceTracker();\n  content.split('\\n').forEach((line, index) => {\n    if (isContent(line)) visitLine(line, index);\n  });\n}\n\n/**\n * Escapes `## Heading {#id}` to `## Heading \\{#id\\}` so MDX can parse it.\n */\nexport function neutralizeAnchorIds(content: string): {\n  content: string;\n  changed: boolean;\n} {\n  let changed = false;\n\n  const next = mapLinesOutsideCodeFences(content, (line) => {\n    const match = line.match(UNESCAPED_ANCHOR);\n    if (!match) return line;\n    changed = true;\n    return `${match[1]} \\\\{#${match[2]}\\\\}`;\n  });\n\n  return { content: next, changed };\n}\n\n/**\n * Unescapes anchors back to `{#id}`; Mintlify renders `\\{` as a literal brace.\n */\nexport function restoreAnchorIds(content: string): string {\n  return mapLinesOutsideCodeFences(content, (line) => {\n    const match = line.match(ESCAPED_ANCHOR);\n    if (!match) return line;\n    return `${match[1]} {#${match[2]}}`;\n  });\n}\n\n/** Builds the parse-only MDX processor shared by every parse site. */\nexport function createMdxParseProcessor() {\n  return unified()\n    .use(remarkParse)\n    .use(remarkFrontmatter, ['yaml', 'toml'])\n    .use(remarkMdx);\n}\n\n/**\n * Parses MDX, retrying with anchors escaped; rethrows any other parse error.\n */\nexport function parseMdxTolerantly(content: string): Root {\n  const processor = createMdxParseProcessor();\n  try {\n    return processor.runSync(processor.parse(content)) as Root;\n  } catch (error) {\n    const { content: neutralized, changed } = neutralizeAnchorIds(content);\n    if (!changed) throw error;\n    return processor.runSync(processor.parse(neutralized)) as Root;\n  }\n}\n\n/**\n * Parses MDX for a pass that stringifies the tree back out. `neutralized` tells\n * the caller whether to run {@link restoreAnchorIds} on its output.\n */\nexport function parseMdxForRoundTrip(content: string): {\n  ast: Root;\n  neutralized: boolean;\n} {\n  const processor = createMdxParseProcessor();\n  try {\n    return {\n      ast: processor.runSync(processor.parse(content)) as Root,\n      neutralized: false,\n    };\n  } catch (error) {\n    const { content: neutralized, changed } = neutralizeAnchorIds(content);\n    if (!changed) throw error;\n    return {\n      ast: processor.runSync(processor.parse(neutralized)) as Root,\n      neutralized: true,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAcA,MAAM,mBACJ;;AAGF,MAAM,iBACJ;;AAGF,MAAM,aAAa;;AAGnB,SAAS,qBAAgD;CACvD,IAAI,UAAU;CACd,IAAI,QAAuB;AAE3B,SAAQ,SAA0B;EAChC,MAAM,QAAQ,KAAK,MAAM,WAAW;AACpC,MAAI,CAAC,MAAO,QAAO,CAAC;EAEpB,MAAM,SAAS,MAAM;AACrB,MAAI,CAAC,SAAS;AACZ,aAAU;AACV,WAAQ;aAER,SACA,OAAO,OAAO,MAAM,MACpB,OAAO,UAAU,MAAM,QACvB;AACA,aAAU;AACV,WAAQ;;AAEV,SAAO;;;;AAKX,SAAgB,0BACd,SACA,SACQ;CACR,MAAM,YAAY,oBAAoB;AACtC,QAAO,QACJ,MAAM,KAAK,CACX,KAAK,SAAU,UAAU,KAAK,GAAG,QAAQ,KAAK,GAAG,KAAM,CACvD,KAAK,KAAK;;;AAIf,SAAgB,6BACd,SACA,WACM;CACN,MAAM,YAAY,oBAAoB;AACtC,SAAQ,MAAM,KAAK,CAAC,SAAS,MAAM,UAAU;AAC3C,MAAI,UAAU,KAAK,CAAE,WAAU,MAAM,MAAM;GAC3C;;;;;AAMJ,SAAgB,oBAAoB,SAGlC;CACA,IAAI,UAAU;AASd,QAAO;EAAE,SAPI,0BAA0B,UAAU,SAAS;GACxD,MAAM,QAAQ,KAAK,MAAM,iBAAiB;AAC1C,OAAI,CAAC,MAAO,QAAO;AACnB,aAAU;AACV,UAAO,GAAG,MAAM,GAAG,OAAO,MAAM,GAAG;IAGf;EAAE;EAAS;;;;;AAMnC,SAAgB,iBAAiB,SAAyB;AACxD,QAAO,0BAA0B,UAAU,SAAS;EAClD,MAAM,QAAQ,KAAK,MAAM,eAAe;AACxC,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,GAAG,MAAM,GAAG,KAAK,MAAM,GAAG;GACjC;;;AAIJ,SAAgB,0BAA0B;AACxC,QAAO,SAAS,CACb,IAAI,YAAY,CAChB,IAAI,mBAAmB,CAAC,QAAQ,OAAO,CAAC,CACxC,IAAI,UAAU;;;;;AAMnB,SAAgB,mBAAmB,SAAuB;CACxD,MAAM,YAAY,yBAAyB;AAC3C,KAAI;AACF,SAAO,UAAU,QAAQ,UAAU,MAAM,QAAQ,CAAC;UAC3C,OAAO;EACd,MAAM,EAAE,SAAS,aAAa,YAAY,oBAAoB,QAAQ;AACtE,MAAI,CAAC,QAAS,OAAM;AACpB,SAAO,UAAU,QAAQ,UAAU,MAAM,YAAY,CAAC;;;;;;;AAQ1D,SAAgB,qBAAqB,SAGnC;CACA,MAAM,YAAY,yBAAyB;AAC3C,KAAI;AACF,SAAO;GACL,KAAK,UAAU,QAAQ,UAAU,MAAM,QAAQ,CAAC;GAChD,aAAa;GACd;UACM,OAAO;EACd,MAAM,EAAE,SAAS,aAAa,YAAY,oBAAoB,QAAQ;AACtE,MAAI,CAAC,QAAS,OAAM;AACpB,SAAO;GACL,KAAK,UAAU,QAAQ,UAAU,MAAM,YAAY,CAAC;GACpD,aAAa;GACd"}

package/dist/utils/validateMdx.d.ts

@@ -1,5 +1,10 @@
 /**
  * Validates if an MDX file content can be parsed as a valid AST
+ *
+ * Mintlify-style custom heading IDs (`## Heading {#id}`) are tolerated: they are
+ * not valid MDX expressions, but the CLI supports them end-to-end, so a document
+ * whose only parse error comes from them is considered valid.
+ *
  * @param content - The MDX file content to validate
  * @param filePath - The file path for error reporting
  * @returns object with isValid boolean and optional error message

package/dist/utils/validateMdx.js

@@ -1,19 +1,19 @@
-import { unified } from "unified";
-import remarkParse from "remark-parse";
-import remarkMdx from "remark-mdx";
-import remarkFrontmatter from "remark-frontmatter";
+import { parseMdxTolerantly } from "./mdxAnchorSyntax.js";
 //#region src/utils/validateMdx.ts
 /**
 * Validates if an MDX file content can be parsed as a valid AST
+*
+* Mintlify-style custom heading IDs (`## Heading {#id}`) are tolerated: they are
+* not valid MDX expressions, but the CLI supports them end-to-end, so a document
+* whose only parse error comes from them is considered valid.
+*
 * @param content - The MDX file content to validate
 * @param filePath - The file path for error reporting
 * @returns object with isValid boolean and optional error message
 */
 function isValidMdx(content, _filePath) {
 	try {
-		const parseProcessor = unified().use(remarkParse).use(remarkFrontmatter, ["yaml", "toml"]).use(remarkMdx);
-		const ast = parseProcessor.parse(content);
-		parseProcessor.runSync(ast);
+		parseMdxTolerantly(content);
 		return { isValid: true };
 	} catch (error) {
 		return {

package/dist/utils/validateMdx.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateMdx.js","names":[],"sources":["../../src/utils/validateMdx.ts"],"sourcesContent":["import { unified } from 'unified';\nimport remarkParse from 'remark-parse';\nimport remarkMdx from 'remark-mdx';\nimport remarkFrontmatter from 'remark-frontmatter';\n\n/**\n * Validates if an MDX file content can be parsed as a valid AST\n * @param content - The MDX file content to validate\n * @param filePath - The file path for error reporting\n * @returns object with isValid boolean and optional error message\n */\nexport function isValidMdx(\n  content: string,\n  _filePath: string\n): {\n  isValid: boolean;\n  error?: string;\n} {\n  try {\n    const parseProcessor = unified()\n      .use(remarkParse)\n      .use(remarkFrontmatter, ['yaml', 'toml'])\n      .use(remarkMdx);\n\n    const ast = parseProcessor.parse(content);\n    parseProcessor.runSync(ast);\n    return { isValid: true };\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    return { isValid: false, error: errorMessage };\n  }\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,WACd,SACA,WAIA;AACA,KAAI;EACF,MAAM,iBAAiB,SAAS,CAC7B,IAAI,YAAY,CAChB,IAAI,mBAAmB,CAAC,QAAQ,OAAO,CAAC,CACxC,IAAI,UAAU;EAEjB,MAAM,MAAM,eAAe,MAAM,QAAQ;AACzC,iBAAe,QAAQ,IAAI;AAC3B,SAAO,EAAE,SAAS,MAAM;UACjB,OAAO;AAEd,SAAO;GAAE,SAAS;GAAO,OADJ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC7B"}
+{"version":3,"file":"validateMdx.js","names":[],"sources":["../../src/utils/validateMdx.ts"],"sourcesContent":["import { parseMdxTolerantly } from './mdxAnchorSyntax.js';\n\n/**\n * Validates if an MDX file content can be parsed as a valid AST\n *\n * Mintlify-style custom heading IDs (`## Heading {#id}`) are tolerated: they are\n * not valid MDX expressions, but the CLI supports them end-to-end, so a document\n * whose only parse error comes from them is considered valid.\n *\n * @param content - The MDX file content to validate\n * @param filePath - The file path for error reporting\n * @returns object with isValid boolean and optional error message\n */\nexport function isValidMdx(\n  content: string,\n  _filePath: string\n): {\n  isValid: boolean;\n  error?: string;\n} {\n  try {\n    parseMdxTolerantly(content);\n    return { isValid: true };\n  } catch (error) {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    return { isValid: false, error: errorMessage };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,WACd,SACA,WAIA;AACA,KAAI;AACF,qBAAmB,QAAQ;AAC3B,SAAO,EAAE,SAAS,MAAM;UACjB,OAAO;AAEd,SAAO;GAAE,SAAS;GAAO,OADJ,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAC7B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gt",
-  "version": "2.17.2",
+  "version": "2.17.3",
   "main": "dist/index.js",
   "bin": "bin/main.js",
   "files": [
@@ -117,10 +117,10 @@
     "yaml": "^2.8.0",
     "@generaltranslation/icu": "0.1.2",
     "@generaltranslation/format": "0.1.8",
-    "@generaltranslation/python-extractor": "0.2.42",
-    "@generaltranslation/supported-locales": "2.1.22",
-    "@generaltranslation/vue-extractor": "0.1.2",
-    "generaltranslation": "9.1.9",
+    "@generaltranslation/python-extractor": "0.2.43",
+    "@generaltranslation/supported-locales": "2.1.23",
+    "@generaltranslation/vue-extractor": "0.1.3",
+    "generaltranslation": "9.1.10",
     "gt-remark": "1.0.12"
   },
   "devDependencies": {