Add @effectionx/mdx package

[taras]

Summary

Extracts MDX/Markdown processing utilities from effection/www into a reusable @effectionx/mdx package.

Features

• useMDX(markdown, options) - Low-level MDX evaluation with Effection

  • User provides JSX runtime (jsx, jsxs, Fragment)
  • Supports remark/rehype plugins

• useMarkdown(markdown, options) - Convenience wrapper with common plugins

  • GFM (GitHub Flavored Markdown)
  • Prism syntax highlighting
  • Slug generation
  • Autolink headings

• replaceAll(input, regex, replacer) - Async regex replacement helper

• createJsDocSanitizer(resolver) - Convert JSDoc {@link X} syntax to markdown links

Design Decisions

• No default JSX runtime - User must provide their own runtime, making the package framework-agnostic
• Common plugins included in useMarkdown but no site-specific CSS classes
• Effection Operations - uses operations instead of async/await.

Tests

30 tests covering:

• Effection integration (yield, spawn)
• JSX runtime usage verification
• Error handling (invalid MDX, runtime errors)
• Plugin support (remark and rehype)
• JSDoc sanitizer patterns
• Async replacement

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/thefrontside/effectionx/@effectionx/mdx@132

commit: ba4d9c7

[cowboyd]

All async functions return Effection Operations for structured concurrency

What does that mean?

[taras]

It just means it uses operations everywhere instead of async/await. it's a bit of friendly AI slop. It generated this PR description from commit.