writr 6.0.1 → 6.1.1

package/README.md

@@ -22,6 +22,7 @@
 * Github Flavor Markdown (remark-gfm).
 * Emoji Support (remark-emoji).
 * MDX Support (remark-mdx).
+* Raw HTML Passthrough (rehype-raw).
 * Built in Hooks for adding code to render pipeline.
 * AI-powered metadata generation, SEO, and translation via the [Vercel AI SDK](https://sdk.vercel.ai).
 
@@ -118,6 +119,7 @@ const writrOptions = {
     gfm: true,
     math: true,
     mdx: true,
+    rawHtml: false,
     caching: true,
   }
 };
@@ -142,6 +144,7 @@ const writrOptions = {
     gfm: true,
     math: true,
     mdx: true,
+    rawHtml: false,
     caching: true,
   }
 };
@@ -190,14 +193,19 @@ Accessing the default options for this instance of Writr. Here is the default se
     gfm: true,
     math: true,
     mdx: false,
+    rawHtml: false,
     caching: true,
   }
 }
 ```
 
+By default, raw HTML in markdown (such as `<iframe>`, `<video>`, or `<div>` tags) is stripped during rendering. Set `rawHtml: true` to preserve raw HTML elements and their attributes in the rendered output. This is useful for embedding videos, widgets, or custom HTML in your markdown content.
+
+**Note:** Setting `mdx: true` also enables raw HTML passthrough as part of the MDX specification. The `rawHtml` option is for enabling raw HTML in standard markdown without using MDX.
+
 ## `.frontmatter`
 
-Accessing the frontmatter for this instance of Writr. This is a `Record<string, any>` and can be set via the `.content` property.
+Accessing the frontmatter for this instance of Writr. This is a `Record&lt;string, any&gt;` and can be set via the `.content` property.
 
 ```javascript
 import { Writr } from 'writr';
@@ -247,7 +255,7 @@ const html = await writr.render(options); // <h1>Hello World ::-):</h1><p>This i
 
 ## `.engine`
 
-Accessing the underlying engine for this instance of Writr. This is a `Processor<Root, Root, Root, undefined, undefined>` from the core [`unified`](https://github.com/unifiedjs/unified) project and uses the familiar `.use()` plugin pattern. You can chain additional unified plugins on this processor to customize the render pipeline. Learn more about the unified engine at [unifiedjs.com](https://unifiedjs.com/) and check out the [getting started guide](https://unifiedjs.com/learn/guide/using-unified/) for examples.
+Accessing the underlying engine for this instance of Writr. This is a `Processor&lt;Root, Root, Root, undefined, undefined&gt;` from the core [`unified`](https://github.com/unifiedjs/unified) project and uses the familiar `.use()` plugin pattern. You can chain additional unified plugins on this processor to customize the render pipeline. Learn more about the unified engine at [unifiedjs.com](https://unifiedjs.com/) and check out the [getting started guide](https://unifiedjs.com/learn/guide/using-unified/) for examples.
 
 
 ## `.render(options?: RenderOptions)`

package/dist/writr.d.ts

@@ -26,6 +26,7 @@ type WritrOptions = {
  * @property {boolean} [gfm] - Github flavor markdown (default: true)
  * @property {boolean} [math] - Math support (default: true)
  * @property {boolean} [mdx] - MDX support (default: false)
+ * @property {boolean} [rawHtml] - Raw HTML passthrough (default: false)
  * @property {boolean} [caching] - Caching (default: true)
  */
 type RenderOptions = {
@@ -36,6 +37,7 @@ type RenderOptions = {
     gfm?: boolean;
     math?: boolean;
     mdx?: boolean;
+    rawHtml?: boolean;
     caching?: boolean;
 };
 /**

package/dist/writr.js

@@ -6,6 +6,7 @@ import parse from "html-react-parser";
 import * as yaml from "js-yaml";
 import rehypeHighlight from "rehype-highlight";
 import rehypeKatex from "rehype-katex";
+import rehypeRaw from "rehype-raw";
 import rehypeSlug from "rehype-slug";
 import rehypeStringify from "rehype-stringify";
 import remarkEmoji from "remark-emoji";
@@ -461,6 +462,7 @@ var Writr = class extends Hookified {
       gfm: true,
       math: true,
       mdx: false,
+      rawHtml: false,
       caching: true
     }
   };
@@ -942,7 +944,23 @@ ${yamlString}---
     if (options.emoji) {
       processor.use(remarkEmoji);
     }
-    processor.use(remarkRehype);
+    if (options.mdx) {
+      processor.use(remarkMDX);
+    }
+    const rehypeOptions = {};
+    if (options.rawHtml) {
+      rehypeOptions.allowDangerousHtml = true;
+    }
+    if (options.mdx) {
+      rehypeOptions.handlers = {
+        mdxJsxFlowElement: mdxJsxHandler,
+        mdxJsxTextElement: mdxJsxHandler
+      };
+    }
+    processor.use(remarkRehype, rehypeOptions);
+    if (options.rawHtml) {
+      processor.use(rehypeRaw);
+    }
     if (options.slug) {
       processor.use(rehypeSlug);
     }
@@ -952,9 +970,6 @@ ${yamlString}---
     if (options.math) {
       processor.use(remarkMath).use(rehypeKatex);
     }
-    if (options.mdx) {
-      processor.use(remarkMDX);
-    }
     processor.use(rehypeStringify);
     return processor;
   }
@@ -980,12 +995,33 @@ ${yamlString}---
     if (options.mdx !== void 0) {
       current.mdx = options.mdx;
     }
+    if (options.rawHtml !== void 0) {
+      current.rawHtml = options.rawHtml;
+    }
     if (options.caching !== void 0) {
       current.caching = options.caching;
     }
     return current;
   }
 };
+function mdxJsxHandler(state, node) {
+  const properties = {};
+  for (const attr of node.attributes) {
+    if (attr.type === "mdxJsxAttribute") {
+      if (attr.value === null) {
+        properties[attr.name] = true;
+      } else if (typeof attr.value === "string") {
+        properties[attr.name] = attr.value;
+      }
+    }
+  }
+  return {
+    type: "element",
+    tagName: node.name ?? "div",
+    properties,
+    children: state.all(node)
+  };
+}
 export {
   Writr,
   WritrAI,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "writr",
-  "version": "6.0.1",
+  "version": "6.1.1",
   "description": "Markdown Rendering Simplified",
   "type": "module",
   "main": "./dist/writr.js",
@@ -49,15 +49,16 @@
     "markdown-to-react"
   ],
   "dependencies": {
-    "ai": "^6.0.116",
-    "cacheable": "^2.3.3",
-    "hashery": "^1.5.0",
+    "ai": "^6.0.138",
+    "cacheable": "^2.3.4",
+    "hashery": "^1.5.1",
     "hookified": "^2.1.0",
     "html-react-parser": "^5.2.17",
     "js-yaml": "^4.1.1",
     "react": "^19.2.4",
     "rehype-highlight": "^7.0.2",
     "rehype-katex": "^7.0.1",
+    "rehype-raw": "^7.0.0",
     "rehype-slug": "^6.0.0",
     "rehype-stringify": "^10.0.1",
     "remark-emoji": "^5.0.2",
@@ -72,26 +73,26 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@ai-sdk/anthropic": "^3.0.58",
-    "@ai-sdk/google": "^3.0.43",
-    "@ai-sdk/openai": "^3.0.41",
-    "@biomejs/biome": "^2.4.7",
+    "@ai-sdk/anthropic": "^3.0.64",
+    "@ai-sdk/google": "^3.0.53",
+    "@ai-sdk/openai": "^3.0.48",
+    "@biomejs/biome": "^2.4.8",
     "@monstermann/tinybench-pretty-printer": "^0.3.0",
     "@types/js-yaml": "^4.0.9",
     "@types/markdown-it": "^14.1.2",
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
-    "@vitest/coverage-v8": "^4.1.0",
-    "docula": "^0.40.0",
+    "@vitest/coverage-v8": "^4.1.1",
+    "docula": "^1.10.0",
     "dotenv": "^17.3.1",
     "markdown-it": "^14.1.1",
-    "marked": "^17.0.4",
+    "marked": "^17.0.5",
     "rimraf": "^6.1.3",
     "tinybench": "^6.0.0",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.1"
   },
   "files": [
     "dist",
@@ -106,7 +107,7 @@
     "test": "pnpm lint && vitest run --coverage",
     "test:ci": "biome check --error-on-warnings && vitest run --coverage",
     "test:integration": "vitest run --config vitest.integration.config.ts",
-    "website:build": "rimraf ./site/README.md ./site/dist && npx docula build -s ./site -o ./site/dist",
-    "website:serve": "rimraf ./site/README.md ./site/dist && npx docula serve -s ./site -o ./site/dist"
+    "website:build": "rimraf ./site/README.md ./site/dist && pnpm docula build",
+    "website:serve": "rimraf ./site/README.md ./site/dist && pnpm docula dev"
   }
 }