@emailens/engine 0.9.0 → 0.9.2

package/README.md

@@ -2,8 +2,9 @@
 
 [![npm](https://img.shields.io/npm/v/@emailens/engine)](https://www.npmjs.com/package/@emailens/engine)
 [![license](https://img.shields.io/npm/l/@emailens/engine)](./LICENSE)
-[![tests](https://img.shields.io/badge/tests-574%20passing-brightgreen)]()
+[![tests](https://img.shields.io/badge/tests-653%20passing-brightgreen)]()
 [![node](https://img.shields.io/node/v/@emailens/engine)](https://nodejs.org/)
+[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://github.com/emailens/mcp)
 
 **Your email looks perfect in Apple Mail. Gmail strips half the CSS. Outlook renders it in Word.**
 
@@ -119,6 +120,21 @@ Three entry points:
 | AI auto-fix | Yes | No | No | No |
 | Open source | MIT | No | No | Yes (data) |
 
+### vs other email libraries
+
+`@emailens/engine` sits in the **QA / lint / scoring** slot — it analyzes finished HTML. It's complementary to (not a replacement for) composition and inlining libraries.
+
+| | @emailens/engine | [juice](https://github.com/automattic/juice) | [email-comb](https://github.com/codsen/email-comb) | [mjml](https://mjml.io/) | [maizzle](https://maizzle.com/) |
+|---|---|---|---|---|---|
+| Purpose | QA / lint / score | CSS inliner | Unused CSS pruner | MJML → HTML | Tailwind → HTML |
+| Per-client compatibility scoring | Yes | No | No | No | No |
+| Spam / a11y / link / image analysis | Yes | No | No | No | No |
+| AI-powered fix generation | Yes | No | No | No | No |
+| Compose emails | Reads only | Reads only | Reads only | Yes | Yes |
+| CSS inlining | No (pair with juice) | Yes | No | Yes (built-in) | Yes (built-in) |
+
+A typical pipeline: write in **mjml** or **maizzle** → inline with **juice** → audit with **@emailens/engine** → ship.
+
 ## Supported Email Clients
 
 | Client | ID | Category | Engine | Dark Mode |
@@ -129,6 +145,8 @@ Three entry points:
 | Outlook 365 | `outlook-web` | Webmail | Outlook Web | Yes |
 | Outlook (New) | `outlook-windows` | Desktop | Outlook Web | Yes |
 | Outlook Classic | `outlook-windows-legacy` | Desktop | Microsoft Word | Yes |
+| Outlook iOS | `outlook-ios` | Mobile | Outlook Mobile | Yes |
+| Outlook Android | `outlook-android` | Mobile | Outlook Mobile | Yes |
 | Apple Mail | `apple-mail-macos` | Desktop | WebKit | Yes |
 | Apple Mail iOS | `apple-mail-ios` | Mobile | WebKit | Yes |
 | Yahoo Mail | `yahoo-mail` | Webmail | Yahoo | Yes |
@@ -154,19 +172,20 @@ Covers:
 
 ## Roadmap
 
-- [ ] Outlook VML auto-generation
-- [ ] GitHub Actions integration (score thresholds in CI)
-- [x] Automated caniemail.com data sync
-- [ ] Real-time rendering previews
-- [ ] MJML/Maizzle source-level linting
-- [ ] Plugin system for custom analyzers
+See [ROADMAP.md](./ROADMAP.md) for the full picture (shipped items + items under consideration with rationale).
+
+**Shipped:** automated caniemail.com data sync · GitHub Actions integration via `@emailens/cli` and the [Marketplace Action](https://github.com/marketplace/actions/emailens-email-preview-check) · AI-powered fix generation · compile module for JSX/MJML/Maizzle.
+
+**Considering:** Outlook VML auto-generation · plugin system for custom analyzers · MJML/Maizzle source-level linting · ESLint plugin · spam corpus tuning · dark-mode accuracy tests.
+
+Concrete bugs go in [Issues](https://github.com/emailens/engine/issues). Open-ended ideas live in the roadmap.
 
 ## Contributing
 
 Contributions are welcome! See **[CONTRIBUTING.md](./CONTRIBUTING.md)** for architecture overview, setup instructions, and PR guidelines.
 
 ```bash
-bun install && bun test   # 580 tests
+bun install && bun test   # 653 tests
 ```
 
 ### Data Maintenance

package/dist/index.cjs

@@ -10115,45 +10115,104 @@ function auditEmail(html, options) {
 var cheerio13 = __toESM(require("cheerio"), 1);
 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