@clidey/dory 0.12.0 → 0.13.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@clidey/dory",
   "private": false,
-  "version": "0.12.0",
+  "version": "0.13.0",
   "type": "module",
   "description": "A CLI tool for building and previewing documentation sites",
   "keywords": [

package/src/plugins/sanitize.ts

@@ -1,10 +1,10 @@
 import { visit } from 'unist-util-visit';
 
+// This plugin replaces mdxTextExpression nodes with inlineCode for safety.
 export const remarkSafeVars = () => {
   return (tree: any) => {
     visit(tree, 'mdxTextExpression', (node: any, index: number | undefined, parent: any) => {
       if (parent && typeof index === 'number') {
-        // Replace mdxTextExpression with inlineCode node for code formatting
         parent.children[index] = {
           type: 'inlineCode',
           value: node.value
@@ -33,6 +33,16 @@ const KNOWN_COMPONENTS = [
   'address', 'cite', 'q', 'dfn'
 ];
 
+// Helper: returns true if the given code string is inside a code block (```)
+function isInsideCodeBlock(code: string, idx: number): boolean {
+  // Count the number of ``` before idx
+  const before = code.slice(0, idx);
+  const codeBlockMatches = before.match(/```/g);
+  // Odd number of ``` means inside a code block
+  return codeBlockMatches ? codeBlockMatches.length % 2 === 1 : false;
+}
+
+// Allow <service> and any <[a-z][a-z0-9]*> tag inside code blocks to be left as-is (not parsed as JSX).
 export function preprocessMdxTags() {
   return {
     name: 'preprocess-mdx-tags',
@@ -43,10 +53,23 @@ export function preprocessMdxTags() {
       // Remove leading whitespace from code fence blocks
       let processed = code.replace(/^(\s+)(```\w*)/gm, '$2');
 
-      // Replace unrecognized <someTag> with `"<someTag>"`
-      processed = processed.replace(/<([a-z][a-z0-9]+)>/gi, (match, tag) => {
-        const known = KNOWN_COMPONENTS.includes(tag);
-        return known ? match : `\`<${tag}>\``; // wrap in backticks to keep as code
+      // Only replace unrecognized <someTag> with `"<someTag>"` if NOT inside a code block
+      // This regex finds all <tag> occurrences
+      processed = processed.replace(/<([a-z][a-z0-9]*)>/gi, (match, tag, offset) => {
+        // If inside a code block, do not touch
+        if (isInsideCodeBlock(processed, offset)) {
+          return match;
+        }
+        // If known component, leave as-is
+        if (KNOWN_COMPONENTS.includes(tag)) {
+          return match;
+        }
+        // If tag is 'service', always leave as-is (do not wrap in backticks)
+        if (tag === 'service') {
+          return match;
+        }
+        // Otherwise, wrap in backticks to prevent JSX parsing
+        return `\`<${tag}>\``;
       });
 
       return {