@emailens/engine 0.9.0 → 0.9.2

package/dist/index.d.cts

@@ -301,7 +301,10 @@ declare function auditEmail(html: string, options?: AuditOptions): AuditReport;
 
 /**
  * Convert HTML email to plain text suitable for multipart/alternative emails.
- * Uses cheerio for parsing (already a dependency — no new deps needed).
+ *
+ * Walks the DOM tree node-by-node, emitting text content with proper
+ * line breaks for block elements. Avoids cheerio's `.text()` which
+ * preserves all source whitespace from deeply nested email tables.
  */
 declare function toPlainText(html: string): string;
 

package/dist/index.d.ts

@@ -301,7 +301,10 @@ declare function auditEmail(html: string, options?: AuditOptions): AuditReport;
 
 /**
  * Convert HTML email to plain text suitable for multipart/alternative emails.
- * Uses cheerio for parsing (already a dependency — no new deps needed).
+ *
+ * Walks the DOM tree node-by-node, emitting text content with proper
+ * line breaks for block elements. Avoids cheerio's `.text()` which
+ * preserves all source whitespace from deeply nested email tables.
  */
 declare function toPlainText(html: string): string;
 

package/dist/index.js

@@ -10015,45 +10015,104 @@ function auditEmail(html, options) {
 import * as cheerio13 from "cheerio";
 function toPlainText(html) {
   const $ = cheerio13.load(html);
-  $("style, script").remove();
+  $("style, script, head").remove();
   $("[data-skip-in-text='true']").remove();
-  $("hr").replaceWith("\n---\n");
-  $("br").replaceWith("\n");
-  $("img").each((_, el) => {
-    const alt = $(el).attr("alt");
-    $(el).replaceWith(alt ? alt : "");
-  });
-  $("a").each((_, el) => {
-    const $el = $(el);
-    const href = $el.attr("href") || "";
-    const text2 = $el.text().trim();
-    if (!href || href === text2) {
-      $el.replaceWith(text2 || href);
-    } else if (!text2) {
-      $el.replaceWith(href);
-    } else {
-      $el.replaceWith(`${text2} (${href})`);
+  const lines = [];
+  let currentLine = "";
+  const BLOCK_TAGS = /* @__PURE__ */ new Set([
+    "p",
+    "div",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "tr",
+    "table",
+    "blockquote",
+    "ul",
+    "ol",
+    "li",
+    "section",
+    "article",
+    "header",
+    "footer",
+    "main",
+    "td",
+    "th"
+    // treat cells as blocks to avoid run-on text
+  ]);
+  const SKIP_TAGS = /* @__PURE__ */ new Set(["style", "script", "head"]);
+  function flushLine() {
+    const trimmed = currentLine.trim();
+    if (trimmed) lines.push(trimmed);
+    currentLine = "";
+  }
+  function walk5(node) {
+    var _a;
+    if (node.type === "text") {
+      const text = node.data.replace(/\s+/g, " ");
+      if (text.trim()) {
+        currentLine += text;
+      }
+      return;
+    }
+    if (node.type !== "tag") return;
+    const el = node;
+    const tag = el.tagName.toLowerCase();
+    if (SKIP_TAGS.has(tag)) return;
+    if (tag === "br") {
+      flushLine();
+      return;
+    }
+    if (tag === "hr") {
+      flushLine();
+      lines.push("---");
+      return;
+    }
+    if (tag === "img") {
+      const alt = (_a = $(el).attr("alt")) == null ? void 0 : _a.trim();
+      if (alt) currentLine += alt;
+      return;
+    }
+    if (tag === "a") {
+      const href = $(el).attr("href") || "";
+      const text = $(el).text().trim();
+      if (!href || href === "#" || href === text) {
+        currentLine += text || href;
+      } else if (!text) {
+        currentLine += href;
+      } else {
+        currentLine += `${text} (${href})`;
+      }
+      return;
+    }
+    const isBlock = BLOCK_TAGS.has(tag);
+    if (isBlock) {
+      flushLine();
+    } else if (currentLine && !currentLine.endsWith(" ")) {
+      currentLine += " ";
+    }
+    if (tag === "li") {
+      currentLine = "- ";
+    }
+    for (const child of el.children) {
+      walk5(child);
+    }
+    if (isBlock) flushLine();
+  }
+  const body = $("body");
+  const root = body.length ? body[0] : $.root()[0];
+  if (root && "children" in root) {
+    for (const child of root.children) {
+      walk5(child);
     }
-  });
-  $("li").each((_, el) => {
-    const $el = $(el);
-    const text2 = $el.text().trim();
-    $el.replaceWith(`
-- ${text2}
-`);
-  });
-  const blockTags = "p, div, h1, h2, h3, h4, h5, h6, tr, blockquote, ul, ol";
-  $(blockTags).each((_, el) => {
-    const $el = $(el);
-    $el.prepend("\n\n");
-    $el.append("\n\n");
-  });
-  let text = $("body").text();
-  if (!text.trim()) {
-    text = $.root().text();
   }
-  text = text.replace(/\n{3,}/g, "\n\n");
-  return text.trim();
+  flushLine();
+  let result = lines.join("\n");
+  result = result.replace(/\n{3,}/g, "\n\n");
+  return result.trim();
 }
 
 // src/session.ts