@bfra.me/doc-sync 0.1.1 → 0.1.3

package/lib/{chunk-LOB73H77.js → chunk-CUBMCGAY.js}

@@ -497,6 +497,9 @@ function isFeatureSection(heading, featureSections) {
 function isInstallationSection(heading, tabSections) {
   return tabSections.some((tab) => heading.includes(tab.toLowerCase()));
 }
+function escapeAngleBrackets(text) {
+  return text.replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
 function mapFeatureSection(section) {
   const lines = [];
   lines.push(`## ${section.heading}`);
@@ -507,7 +510,7 @@ function mapFeatureSection(section) {
     for (const feature of features) {
       const icon = inferFeatureIcon(feature.title, feature.emoji);
       lines.push(`  <Card title="${sanitizeAttribute(feature.title)}" icon="${icon}">`);
-      lines.push(`    ${feature.description}`);
+      lines.push(`    ${escapeAngleBrackets(feature.description)}`);
       lines.push("  </Card>");
     }
     lines.push("</CardGrid>");
@@ -1315,4 +1318,4 @@ export {
   sanitizeTextContent,
   validateMDXSyntax
 };
-//# sourceMappingURL=chunk-LOB73H77.js.map
+//# sourceMappingURL=chunk-CUBMCGAY.js.map

package/lib/{chunk-NC7YTZAL.js → chunk-DTXB5PMR.js}

@@ -2,12 +2,12 @@ import {
   generateMDXDocument,
   mergeContent,
   validateMDXSyntax
-} from "./chunk-LOB73H77.js";
+} from "./chunk-CUBMCGAY.js";
 import {
   analyzePublicAPI,
   parsePackageComplete,
   parseReadmeFile
-} from "./chunk-6NKAJT2M.js";
+} from "./chunk-VHUUC45J.js";
 import {
   createHeadingPattern,
   extractCodeBlocks,
@@ -710,4 +710,4 @@ export {
   createSyncOrchestrator,
   isValidFilePath
 };
-//# sourceMappingURL=chunk-NC7YTZAL.js.map
+//# sourceMappingURL=chunk-DTXB5PMR.js.map

package/lib/{chunk-6NKAJT2M.js → chunk-VHUUC45J.js}

@@ -1074,11 +1074,11 @@ function extractTextFromNode(node) {
 }
 function serializeNode(node) {
   if (node.type === "paragraph") {
-    return extractTextFromNode(node);
+    return serializeInlineContent(node);
   }
   if (node.type === "heading") {
     const prefix = "#".repeat(node.depth);
-    return `${prefix} ${extractTextFromNode(node)}`;
+    return `${prefix} ${serializeInlineContent(node)}`;
   }
   if (node.type === "code") {
     return `\`\`\`${node.lang ?? ""}
@@ -1108,6 +1108,38 @@ ${node.value}
   }
   return extractTextFromNode(node);
 }
+function serializeInlineContent(node) {
+  if ("value" in node && typeof node.value === "string") {
+    return node.value;
+  }
+  if (!("children" in node) || !Array.isArray(node.children)) {
+    return "";
+  }
+  return node.children.map((child) => {
+    if (child.type === "strong") {
+      return `**${serializeInlineContent(child)}**`;
+    }
+    if (child.type === "emphasis") {
+      return `*${serializeInlineContent(child)}*`;
+    }
+    if (child.type === "inlineCode") {
+      return `\`${"value" in child ? child.value : ""}\``;
+    }
+    if (child.type === "link") {
+      const text = serializeInlineContent(child);
+      return `[${text}](${"url" in child ? child.url : ""})`;
+    }
+    if (child.type === "image") {
+      const alt = "alt" in child ? child.alt : "";
+      const url = "url" in child ? child.url : "";
+      return `![${alt}](${url})`;
+    }
+    if ("value" in child && typeof child.value === "string") {
+      return child.value;
+    }
+    return serializeInlineContent(child);
+  }).join("");
+}
 function serializeTable(node) {
   if (node.type !== "table" || !("children" in node)) {
     return "";
@@ -1230,4 +1262,4 @@ export {
   flattenSections,
   getTableOfContents
 };
-//# sourceMappingURL=chunk-6NKAJT2M.js.map
+//# sourceMappingURL=chunk-VHUUC45J.js.map

package/lib/cli/index.js

@@ -3,15 +3,15 @@ import {
   createPackageScanner,
   createSyncOrchestrator,
   createValidationPipeline
-} from "../chunk-NC7YTZAL.js";
+} from "../chunk-DTXB5PMR.js";
 import {
   generateMDXDocument,
   mergeContent
-} from "../chunk-LOB73H77.js";
+} from "../chunk-CUBMCGAY.js";
 import "../chunk-ROLA7SBB.js";
 import {
   getUnscopedName
-} from "../chunk-6NKAJT2M.js";
+} from "../chunk-VHUUC45J.js";
 import "../chunk-GZ2MP3VN.js";
 import "../chunk-45NROJIG.js";
 

package/lib/generators/index.js

@@ -34,7 +34,7 @@ import {
   validateMarkerPairing,
   wrapAutoSection,
   wrapManualSection
-} from "../chunk-LOB73H77.js";
+} from "../chunk-CUBMCGAY.js";
 import "../chunk-ROLA7SBB.js";
 import "../chunk-GZ2MP3VN.js";
 export {

package/lib/index.js

@@ -8,7 +8,7 @@ import {
   isValidFilePath,
   validateContentString,
   validateDocument
-} from "./chunk-NC7YTZAL.js";
+} from "./chunk-DTXB5PMR.js";
 import {
   cleanCodeExample,
   createBadge,
@@ -45,7 +45,7 @@ import {
   validateMarkerPairing,
   wrapAutoSection,
   wrapManualSection
-} from "./chunk-LOB73H77.js";
+} from "./chunk-CUBMCGAY.js";
 import {
   SENTINEL_MARKERS
 } from "./chunk-ROLA7SBB.js";
@@ -104,7 +104,7 @@ import {
   parseReadmeFile,
   parseSourceContent,
   parseSourceFile
-} from "./chunk-6NKAJT2M.js";
+} from "./chunk-VHUUC45J.js";
 import "./chunk-DRBRT57F.js";
 import {
   createHeadingPattern,

package/lib/orchestrator/index.js

@@ -8,10 +8,10 @@ import {
   isValidFilePath,
   validateContentString,
   validateDocument
-} from "../chunk-NC7YTZAL.js";
-import "../chunk-LOB73H77.js";
+} from "../chunk-DTXB5PMR.js";
+import "../chunk-CUBMCGAY.js";
 import "../chunk-ROLA7SBB.js";
-import "../chunk-6NKAJT2M.js";
+import "../chunk-VHUUC45J.js";
 import "../chunk-GZ2MP3VN.js";
 import "../chunk-45NROJIG.js";
 export {

package/lib/parsers/index.js

@@ -53,7 +53,7 @@ import {
   parseReadmeFile,
   parseSourceContent,
   parseSourceFile
-} from "../chunk-6NKAJT2M.js";
+} from "../chunk-VHUUC45J.js";
 export {
   analyzePublicAPI,
   analyzeTypeScriptContent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bfra.me/doc-sync",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Intelligent documentation synchronization engine for automatic Astro Starlight site updates",
   "keywords": [
     "astro",
@@ -82,7 +82,7 @@
     "remark-parse": "11.0.0",
     "ts-morph": "27.0.2",
     "unified": "11.0.5",
-    "zod": "4.1.13",
+    "zod": "4.2.1",
     "@bfra.me/es": "0.1.0"
   },
   "devDependencies": {

package/src/generators/component-mapper.ts

@@ -111,6 +111,16 @@ function isInstallationSection(heading: string, tabSections: readonly string[]):
   return tabSections.some(tab => heading.includes(tab.toLowerCase()))
 }
 
+/**
+ * Escape angle brackets in text to prevent MDX JSX tag misinterpretation
+ * This is applied to section content to prevent TypeScript generics like Result<T, E>
+ * from being interpreted as unclosed JSX tags
+ */
+function escapeAngleBrackets(text: string): string {
+  // Escape all < and > to HTML entities
+  return text.replaceAll('<', '&lt;').replaceAll('>', '&gt;')
+}
+
 function mapFeatureSection(section: ReadmeSection): string {
   const lines: string[] = []
 
@@ -124,7 +134,7 @@ function mapFeatureSection(section: ReadmeSection): string {
     for (const feature of features) {
       const icon = inferFeatureIcon(feature.title, feature.emoji)
       lines.push(`  <Card title="${sanitizeAttribute(feature.title)}" icon="${icon}">`)
-      lines.push(`    ${feature.description}`)
+      lines.push(`    ${escapeAngleBrackets(feature.description)}`)
       lines.push('  </Card>')
     }
     lines.push('</CardGrid>')

package/src/parsers/readme-parser.ts

@@ -183,12 +183,12 @@ function extractTextFromNode(node: RootContent): string {
 
 function serializeNode(node: RootContent): string {
   if (node.type === 'paragraph') {
-    return extractTextFromNode(node)
+    return serializeInlineContent(node)
   }
 
   if (node.type === 'heading') {
     const prefix = '#'.repeat(node.depth)
-    return `${prefix} ${extractTextFromNode(node)}`
+    return `${prefix} ${serializeInlineContent(node)}`
   }
 
   if (node.type === 'code') {
@@ -227,6 +227,59 @@ function serializeNode(node: RootContent): string {
   return extractTextFromNode(node)
 }
 
+/**
+ * Serialize inline content preserving markdown formatting like **bold**, *italic*, `code`, etc.
+ */
+function serializeInlineContent(node: RootContent): string {
+  if ('value' in node && typeof node.value === 'string') {
+    return node.value
+  }
+
+  if (!('children' in node) || !Array.isArray(node.children)) {
+    return ''
+  }
+
+  return (node.children as RootContent[])
+    .map(child => {
+      // Handle strong (bold) text
+      if (child.type === 'strong') {
+        return `**${serializeInlineContent(child)}**`
+      }
+
+      // Handle emphasis (italic) text
+      if (child.type === 'emphasis') {
+        return `*${serializeInlineContent(child)}*`
+      }
+
+      // Handle inline code
+      if (child.type === 'inlineCode') {
+        return `\`${'value' in child ? child.value : ''}\``
+      }
+
+      // Handle links
+      if (child.type === 'link') {
+        const text = serializeInlineContent(child)
+        return `[${text}](${'url' in child ? child.url : ''})`
+      }
+
+      // Handle images
+      if (child.type === 'image') {
+        const alt = 'alt' in child ? child.alt : ''
+        const url = 'url' in child ? child.url : ''
+        return `![${alt}](${url})`
+      }
+
+      // Handle plain text
+      if ('value' in child && typeof child.value === 'string') {
+        return child.value
+      }
+
+      // Recursively handle other inline elements
+      return serializeInlineContent(child)
+    })
+    .join('')
+}
+
 function serializeTable(node: RootContent): string {
   if (node.type !== 'table' || !('children' in node)) {
     return ''