Merge branch 'next'

Author: runnabro

__tests__/lib/mdxish/magic-blocks.test.ts

@@ -143,6 +143,88 @@ ${JSON.stringify(
       expect((cell0.children[0] as Element).tagName).toBe('strong');
       expect((cell1.children[0] as Element).tagName).toBe('em');
     });
+
+    it('should preserve multiple paragraphs with links in table cells', () => {
+      const md = `
+[block:parameters]
+${JSON.stringify(
+  {
+    data: {
+      'h-0': 'Feature',
+      'h-1': 'Description',
+      '0-0':
+        '**Webhooks**  \nProfile activity event delivery service to your listener endpoint. Configured via API: you provide the endpoint and then consume webhook notifications.  \n  \n[Introduction to Webhooks v3](doc:an-introduction-to-webhooks-v3-1)',
+      '0-1': 'Available',
+    },
+    cols: 2,
+    rows: 1,
+    align: ['left', 'left'],
+  },
+  null,
+  2,
+)}
+[/block]`;
+
+      const ast = mdxish(md);
+      expect(ast.children).toHaveLength(4);
+
+      // Table is the 3rd child
+      const element = ast.children[2] as Element;
+      expect(element.tagName).toBe('table');
+
+      const tbody = element.children[1] as Element;
+      const row = tbody.children[0] as Element;
+      const cell = row.children[0] as Element;
+
+      expect(cell.children.length).toBeGreaterThan(1);
+      expect(cell.children[0].type).toBe('element');
+      expect((cell.children[0] as Element).tagName).toBe('p');
+
+      const lastParagraph = cell.children[cell.children.length - 1] as Element;
+      expect(lastParagraph.tagName).toBe('p');
+      expect((lastParagraph.children[0] as Element).tagName).toBe('a');
+      expect((lastParagraph.children[0] as Element).properties.href).toBe('doc:an-introduction-to-webhooks-v3-1');
+    });
+  });
+
+  describe('recipe block', () => {
+    it('should restore tutorial-tile block to Recipe component', () => {
+      const md = `[block:tutorial-tile]
+{
+  "emoji": "🦉",
+  "slug": "whoaaa",
+  "title": "WHOAAA"
+}
+[/block]`;
+
+      const ast = mdxish(md);
+      expect(ast.children).toHaveLength(1);
+      expect(ast.children[0].type).toBe('element');
+
+      const recipeElement = ast.children[0] as Element;
+      expect(recipeElement.tagName).toBe('Recipe');
+      expect(recipeElement.properties.slug).toBe('whoaaa');
+      expect(recipeElement.properties.title).toBe('WHOAAA');
+    });
+
+    it('should restore recipe block to Recipe component', () => {
+      const md = `[block:recipe]
+{
+  "slug": "test-recipe",
+  "title": "Test Recipe",
+  "emoji": "👉"
+}
+[/block]`;
+
+      const ast = mdxish(md);
+      expect(ast.children).toHaveLength(1);
+      expect(ast.children[0].type).toBe('element');
+
+      const recipeElement = ast.children[0] as Element;
+      expect(recipeElement.tagName).toBe('Recipe');
+      expect(recipeElement.properties.slug).toBe('test-recipe');
+      expect(recipeElement.properties.title).toBe('Test Recipe');
+    });
   });
 
   describe('callout block', () => {

processor/transform/mdxish/mdxish-magic-blocks.ts

@@ -79,6 +79,15 @@ interface HtmlJson extends MagicBlockJson {
   html: string;
 }
 
+interface RecipeJson extends MagicBlockJson {
+  backgroundColor?: string;
+  emoji?: string;
+  id?: string;
+  link?: string;
+  slug: string;
+  title: string;
+}
+
 export interface ParseMagicBlockOptions {
   alwaysThrow?: boolean;
   compatibilityMode?: boolean;
@@ -129,6 +138,12 @@ const textToBlock = (text: string): MdastNode[] => [{ children: textToInline(tex
 const parseInline = (text: string): MdastNode[] => {
   if (!text.trim()) return [{ type: 'text', value: '' }];
   const tree = cellParser.runSync(cellParser.parse(text)) as MdastRoot;
+  
+  // If there are multiple block-level nodes, keep them as-is to preserve the document structure and spacing
+  if (tree.children.length > 1) {
+    return tree.children as MdastNode[];
+  }
+  
   return tree.children.flatMap(n =>
     // This unwraps the extra p node that might appear & wrapping the content
     n.type === 'paragraph' && 'children' in n ? (n.children as MdastNode[]) : [n as MdastNode],
@@ -379,6 +394,27 @@ function parseMagicBlock(raw: string, options: ParseMagicBlockOptions = {}): Mda
       ];
     }
 
+    // Recipe/TutorialTile: renders as Recipe component
+    case 'recipe':
+    case 'tutorial-tile': {
+      const recipeJson = json as RecipeJson;
+      if (!recipeJson.slug || !recipeJson.title) return [];
+
+      // Create mdxJsxFlowElement directly for mdxish flow
+      // Note: Don't wrap in pinned blocks for mdxish - rehypeMdxishComponents handles component resolution
+      // The node structure matches what mdxishComponentBlocks creates for JSX tags
+      const recipeNode: MdxJsxFlowElement = {
+        type: 'mdxJsxFlowElement',
+        name: 'Recipe',
+        attributes: toAttributes(recipeJson, ['slug', 'title']),
+        children: [],
+        // Position is optional but helps with debugging
+        position: undefined,
+      };
+
+      return [recipeNode as unknown as MdastNode];
+    }
+
     // Unknown block types: render as generic div with JSON properties
     default: {
       const text = (json as { html?: string; text?: string }).text || (json as { html?: string }).html || '';