@emailens/engine 0.10.3 → 0.10.4

package/README.md

@@ -7,9 +7,10 @@
 
 **The rendering linter for email**
 
+[![CI](https://github.com/emailens/engine/actions/workflows/ci.yml/badge.svg)](https://github.com/emailens/engine/actions/workflows/ci.yml)
 [![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-719%20passing-brightgreen)]()
+[![tests](https://img.shields.io/badge/tests-910%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)
 [![GitHub stars](https://img.shields.io/github/stars/emailens/engine?style=flat)](https://github.com/emailens/engine/stargazers)
@@ -20,9 +21,11 @@
 
 **Your email looks perfect in Apple Mail. Gmail strips half the CSS. Outlook renders it in Word.**
 
-`@emailens/engine` analyzes your HTML against 250+ CSS properties across 21 email clients, scores compatibility, and shows you exactly what to fix — before you hit send.
+`@emailens/engine` analyzes your email against 255 CSS and HTML features across 21 email clients, scores compatibility, and shows you exactly what to fix — before you hit send.
 
-Our data says you need this: across the 255 CSS and HTML features we track, **only 6 are fully supported in every major email client**. See [The State of Email CSS](https://emailens.dev/email-css/report).
+Write it however you like. **HTML, MJML, Maizzle and React Email** all go in the front: the engine compiles the template with your own compiler and lints the HTML that actually gets sent, which is the only version your reader sees.
+
+Our data says you need this: of those 255 features, **only 6 are fully supported in every major email client**. See [The State of Email CSS](https://emailens.dev/email-css/report).
 
 ![emailens lint output showing errors and warnings across email clients](./docs/lint-demo.png)
 
@@ -105,7 +108,7 @@ const { code } = await generateAiFix({
 
 10 analysis engines, one `auditEmail()` call.
 
-- **CSS compatibility** — 250+ properties tested across 21 email clients, with fix snippets and AI-powered auto-fix
+- **CSS compatibility** — 255 CSS and HTML features tested across 21 email clients, with fix snippets and AI-powered auto-fix
 - **Content overflow** — fixed widths wider than the email frame and unbreakable strings that force horizontal scrolling
 - **Visual bugs** — gradients/background images with no color fallback (invisible content in Outlook) and fonts with no web-safe fallback, each with a concrete fix
 - **Spam scoring** — 45+ signals modeled after SpamAssassin, CAN-SPAM, and GDPR

package/dist/index.cjs

@@ -68,6 +68,7 @@ __export(index_exports, {
   CompileError: () => CompileError,
   EMAIL_CLIENTS: () => EMAIL_CLIENTS,
   EMPTY_DELIVERABILITY: () => EMPTY_DELIVERABILITY,
+  FEATURE_URLS: () => FEATURE_URLS,
   GENERIC_LINK_TEXT: () => GENERIC_LINK_TEXT,
   HTML_ELEMENT_FEATURES: () => HTML_ELEMENT_FEATURES,
   MAX_HTML_SIZE: () => MAX_HTML_SIZE,
@@ -92,6 +93,7 @@ __export(index_exports, {
   errorWarnings: () => errorWarnings,
   estimateAiFixTokens: () => estimateAiFixTokens,
   extractInboxPreview: () => extractInboxPreview,
+  featureUrl: () => featureUrl,
   formatRgb: () => formatRgb,
   generateAiFix: () => generateAiFix,
   generateCompatibilityScore: () => generateCompatibilityScore,
@@ -12159,6 +12161,263 @@ function extractCode(response) {
   return response.trim();
 }
 
+// src/rules/feature-urls.ts
+var FEATURE_URLS = {
+  "!important": "https://www.caniemail.com/features/css-important/",
+  "::after": "https://www.caniemail.com/features/css-pseudo-element-after/",
+  "::before": "https://www.caniemail.com/features/css-pseudo-element-before/",
+  "::first-letter": "https://www.caniemail.com/features/css-pseudo-element-first-letter/",
+  "::first-line": "https://www.caniemail.com/features/css-pseudo-element-first-line/",
+  "::marker": "https://www.caniemail.com/features/css-pseudo-element-marker/",
+  "::placeholder": "https://www.caniemail.com/features/css-pseudo-element-placeholder/",
+  ":adjacent-sibling": "https://www.caniemail.com/features/css-selector-adjacent-sibling/",
+  ":attribute-selector": "https://www.caniemail.com/features/css-selector-attribute/",
+  ":chaining": "https://www.caniemail.com/features/css-selector-chaining/",
+  ":checked": "https://www.caniemail.com/features/css-pseudo-class-checked/",
+  ":child-combinator": "https://www.caniemail.com/features/css-selector-child/",
+  ":class-selector": "https://www.caniemail.com/features/css-selector-class/",
+  ":descendant-combinator": "https://www.caniemail.com/features/css-selector-descendant/",
+  ":first-child": "https://www.caniemail.com/features/css-pseudo-class-first-child/",
+  ":first-of-type": "https://www.caniemail.com/features/css-pseudo-class-first-of-type/",
+  ":focus": "https://www.caniemail.com/features/css-pseudo-class-focus/",
+  ":focus-visible": "https://www.caniemail.com/features/css-pseudo-class-focus-visible/",
+  ":focus-within": "https://www.caniemail.com/features/css-pseudo-class-focus-within/",
+  ":general-sibling": "https://www.caniemail.com/features/css-selector-general-sibling/",
+  ":grouping": "https://www.caniemail.com/features/css-selector-grouping/",
+  ":has": "https://www.caniemail.com/features/css-pseudo-class-has/",
+  ":hover": "https://www.caniemail.com/features/css-pseudo-class-hover/",
+  ":id-selector": "https://www.caniemail.com/features/css-selector-id/",
+  ":lang": "https://www.caniemail.com/features/css-pseudo-class-lang/",
+  ":last-child": "https://www.caniemail.com/features/css-pseudo-class-last-child/",
+  ":last-of-type": "https://www.caniemail.com/features/css-pseudo-class-last-of-type/",
+  ":link": "https://www.caniemail.com/features/css-pseudo-class-link/",
+  ":not": "https://www.caniemail.com/features/css-pseudo-class-not/",
+  ":nth-child": "https://www.caniemail.com/features/css-pseudo-class-nth-child/",
+  ":nth-last-child": "https://www.caniemail.com/features/css-pseudo-class-nth-last-child/",
+  ":nth-of-type": "https://www.caniemail.com/features/css-pseudo-class-nth-of-type/",
+  ":only-child": "https://www.caniemail.com/features/css-pseudo-class-only-child/",
+  ":only-of-type": "https://www.caniemail.com/features/css-pseudo-class-only-of-type/",
+  ":target": "https://www.caniemail.com/features/css-pseudo-class-target/",
+  ":type-selector": "https://www.caniemail.com/features/css-selector-type/",
+  ":universal-selector": "https://www.caniemail.com/features/css-selector-universal/",
+  ":visited": "https://www.caniemail.com/features/css-pseudo-class-visited/",
+  "<abbr>": "https://www.caniemail.com/features/html-abbr/",
+  "<acronym>": "https://www.caniemail.com/features/html-acronym/",
+  "<address>": "https://www.caniemail.com/features/html-address/",
+  "<audio>": "https://www.caniemail.com/features/html-audio/",
+  "<base>": "https://www.caniemail.com/features/html-base/",
+  "<bdi>": "https://www.caniemail.com/features/html-bdi/",
+  "<blockquote>": "https://www.caniemail.com/features/html-blockquote/",
+  "<body>": "https://www.caniemail.com/features/html-body/",
+  "<code>": "https://www.caniemail.com/features/html-code/",
+  "<del>": "https://www.caniemail.com/features/html-del/",
+  "<dfn>": "https://www.caniemail.com/features/html-dfn/",
+  "<dialog>": "https://www.caniemail.com/features/html-dialog/",
+  "<div>": "https://www.caniemail.com/features/html-div/",
+  "<form>": "https://www.caniemail.com/features/html-form/",
+  "<h1>": "https://www.caniemail.com/features/html-h1-h6/",
+  "<hr>": "https://www.caniemail.com/features/html-hr/",
+  "<img>": "https://www.caniemail.com/features/html-img/",
+  "<link>": "https://www.caniemail.com/features/html-link/",
+  "<marquee>": "https://www.caniemail.com/features/html-marquee/",
+  "<meter>": "https://www.caniemail.com/features/html-meter/",
+  "<object>": "https://www.caniemail.com/features/html-object/",
+  "<p>": "https://www.caniemail.com/features/html-p/",
+  "<picture>": "https://www.caniemail.com/features/html-picture/",
+  "<pre>": "https://www.caniemail.com/features/html-pre/",
+  "<progress>": "https://www.caniemail.com/features/html-progress/",
+  "<rp>": "https://www.caniemail.com/features/html-rp/",
+  "<rt>": "https://www.caniemail.com/features/html-rt/",
+  "<ruby>": "https://www.caniemail.com/features/html-ruby/",
+  "<select>": "https://www.caniemail.com/features/html-select/",
+  "<small>": "https://www.caniemail.com/features/html-small/",
+  "<span>": "https://www.caniemail.com/features/html-span/",
+  "<strike>": "https://www.caniemail.com/features/html-strike/",
+  "<strong>": "https://www.caniemail.com/features/html-strong/",
+  "<style>": "https://www.caniemail.com/features/html-style/",
+  "<svg>": "https://www.caniemail.com/features/html-svg/",
+  "<table>": "https://www.caniemail.com/features/html-table/",
+  "<textarea>": "https://www.caniemail.com/features/html-textarea/",
+  "<ul>": "https://www.caniemail.com/features/html-lists/",
+  "<video>": "https://www.caniemail.com/features/html-video/",
+  "<wbr>": "https://www.caniemail.com/features/html-wbr/",
+  "@font-face": "https://www.caniemail.com/features/css-at-font-face/",
+  "@import": "https://www.caniemail.com/features/css-at-import/",
+  "@keyframes": "https://www.caniemail.com/features/css-at-keyframes/",
+  "@media": "https://www.caniemail.com/features/css-at-media/",
+  "@supports": "https://www.caniemail.com/features/css-at-supports/",
+  "accent-color": "https://www.caniemail.com/features/css-accent-color/",
+  "align-items": "https://www.caniemail.com/features/css-align-items/",
+  "animation": "https://www.caniemail.com/features/css-animation/",
+  "aspect-ratio": "https://www.caniemail.com/features/css-aspect-ratio/",
+  "backdrop-filter": "https://www.caniemail.com/features/css-backdrop-filter/",
+  "background": "https://www.caniemail.com/features/css-background/",
+  "background-blend-mode": "https://www.caniemail.com/features/css-background-blend-mode/",
+  "background-clip": "https://www.caniemail.com/features/css-background-clip/",
+  "background-color": "https://www.caniemail.com/features/css-background-color/",
+  "background-image": "https://www.caniemail.com/features/css-background-image/",
+  "background-origin": "https://www.caniemail.com/features/css-background-origin/",
+  "background-position": "https://www.caniemail.com/features/css-background-position/",
+  "background-repeat": "https://www.caniemail.com/features/css-background-repeat/",
+  "background-size": "https://www.caniemail.com/features/css-background-size/",
+  "bimi": "https://www.caniemail.com/features/bimi/",
+  "block-size": "https://www.caniemail.com/features/css-block-inline-size/",
+  "border": "https://www.caniemail.com/features/css-border/",
+  "border-collapse": "https://www.caniemail.com/features/css-border-collapse/",
+  "border-image": "https://www.caniemail.com/features/css-border-image/",
+  "border-inline": "https://www.caniemail.com/features/css-border-inline-block/",
+  "border-inline-individual": "https://www.caniemail.com/features/css-border-inline-block-individual/",
+  "border-inline-longhand": "https://www.caniemail.com/features/css-border-inline-block-longhand/",
+  "border-radius": "https://www.caniemail.com/features/css-border-radius/",
+  "border-radius-logical": "https://www.caniemail.com/features/css-border-radius-logical/",
+  "border-spacing": "https://www.caniemail.com/features/css-border-spacing/",
+  "box-shadow": "https://www.caniemail.com/features/css-box-shadow/",
+  "box-sizing": "https://www.caniemail.com/features/css-box-sizing/",
+  "calc": "https://www.caniemail.com/features/css-unit-calc/",
+  "caption-side": "https://www.caniemail.com/features/css-caption-side/",
+  "clamp": "https://www.caniemail.com/features/css-function-clamp/",
+  "clear": "https://www.caniemail.com/features/css-clear/",
+  "clip-path": "https://www.caniemail.com/features/css-clip-path/",
+  "color-scheme": "https://www.caniemail.com/features/css-color-scheme/",
+  "column-count": "https://www.caniemail.com/features/css-column-count/",
+  "columns": "https://www.caniemail.com/features/css-column-layout-properties/",
+  "conic-gradient": "https://www.caniemail.com/features/css-conic-gradient/",
+  "css-comments": "https://www.caniemail.com/features/css-comments/",
+  "cursor": "https://www.caniemail.com/features/css-cursor/",
+  "custom-properties": "https://www.caniemail.com/features/css-variables/",
+  "direction": "https://www.caniemail.com/features/css-direction/",
+  "display": "https://www.caniemail.com/features/css-display/",
+  "display:flex": "https://www.caniemail.com/features/css-display-flex/",
+  "display:grid": "https://www.caniemail.com/features/css-display-grid/",
+  "display:none": "https://www.caniemail.com/features/css-display-none/",
+  "empty-cells": "https://www.caniemail.com/features/css-empty-cells/",
+  "filter": "https://www.caniemail.com/features/css-filter/",
+  "fit-content": "https://www.caniemail.com/features/css-intrinsic-size/",
+  "flex-direction": "https://www.caniemail.com/features/css-flex-direction/",
+  "flex-wrap": "https://www.caniemail.com/features/css-flex-wrap/",
+  "float": "https://www.caniemail.com/features/css-float/",
+  "font": "https://www.caniemail.com/features/css-font/",
+  "font-kerning": "https://www.caniemail.com/features/css-font-kerning/",
+  "font-size": "https://www.caniemail.com/features/css-font-size/",
+  "font-size-adjust": "https://www.caniemail.com/features/css-font-size-adjust/",
+  "font-stretch": "https://www.caniemail.com/features/css-font-stretch/",
+  "font-weight": "https://www.caniemail.com/features/css-font-weight/",
+  "gap": "https://www.caniemail.com/features/css-gap/",
+  "grid-template-columns": "https://www.caniemail.com/features/css-grid-template/",
+  "height": "https://www.caniemail.com/features/css-height/",
+  "hyphenate-character": "https://www.caniemail.com/features/css-hyphenate-character/",
+  "hyphenate-limit-chars": "https://www.caniemail.com/features/css-hyphenate-limit-chars/",
+  "hyphens": "https://www.caniemail.com/features/css-hyphens/",
+  "inert": "https://www.caniemail.com/features/css-inert-attribute/",
+  "inline-size": "https://www.caniemail.com/features/css-inline-size/",
+  "inset": "https://www.caniemail.com/features/css-inset/",
+  "justify-content": "https://www.caniemail.com/features/css-justify-content/",
+  "left": "https://www.caniemail.com/features/css-left-right-top-bottom/",
+  "letter-spacing": "https://www.caniemail.com/features/css-letter-spacing/",
+  "light-dark": "https://www.caniemail.com/features/css-function-light-dark/",
+  "line-height": "https://www.caniemail.com/features/css-line-height/",
+  "linear-gradient": "https://www.caniemail.com/features/css-linear-gradient/",
+  "list-style": "https://www.caniemail.com/features/css-list-style/",
+  "list-style-image": "https://www.caniemail.com/features/css-list-style-image/",
+  "list-style-position": "https://www.caniemail.com/features/css-list-style-position/",
+  "list-style-type": "https://www.caniemail.com/features/css-list-style-type/",
+  "margin": "https://www.caniemail.com/features/css-margin/",
+  "margin-block-start-end": "https://www.caniemail.com/features/css-margin-block-start-end/",
+  "margin-inline-block": "https://www.caniemail.com/features/css-margin-inline-block/",
+  "margin-inline-start-end": "https://www.caniemail.com/features/css-margin-inline-start-end/",
+  "mask-image": "https://www.caniemail.com/features/css-mask-image/",
+  "max": "https://www.caniemail.com/features/css-function-max/",
+  "max-block-size": "https://www.caniemail.com/features/css-max-block-size/",
+  "max-height": "https://www.caniemail.com/features/css-max-height/",
+  "max-inline-size": "https://www.caniemail.com/features/css-max-inline-size/",
+  "max-width": "https://www.caniemail.com/features/css-max-width/",
+  "min": "https://www.caniemail.com/features/css-function-min/",
+  "min-block-size": "https://www.caniemail.com/features/css-min-block-size/",
+  "min-height": "https://www.caniemail.com/features/css-min-height/",
+  "min-inline-size": "https://www.caniemail.com/features/css-min-inline-size/",
+  "min-width": "https://www.caniemail.com/features/css-min-width/",
+  "mix-blend-mode": "https://www.caniemail.com/features/css-mix-blend-mode/",
+  "modern-color": "https://www.caniemail.com/features/css-modern-color/",
+  "nesting": "https://www.caniemail.com/features/css-nesting/",
+  "object-fit": "https://www.caniemail.com/features/css-object-fit/",
+  "object-position": "https://www.caniemail.com/features/css-object-position/",
+  "opacity": "https://www.caniemail.com/features/css-opacity/",
+  "orphans": "https://www.caniemail.com/features/css-orphans/",
+  "outline": "https://www.caniemail.com/features/css-outline/",
+  "outline-offset": "https://www.caniemail.com/features/css-outline-offset/",
+  "overflow": "https://www.caniemail.com/features/css-overflow/",
+  "overflow-wrap": "https://www.caniemail.com/features/css-word-wrap/",
+  "padding": "https://www.caniemail.com/features/css-padding/",
+  "padding-block-start-end": "https://www.caniemail.com/features/css-padding-block-start-end/",
+  "padding-inline-block": "https://www.caniemail.com/features/css-padding-inline-block/",
+  "padding-inline-start-end": "https://www.caniemail.com/features/css-padding-inline-start-end/",
+  "position": "https://www.caniemail.com/features/css-position/",
+  "pseudo-class-active": "https://www.caniemail.com/features/css-pseudo-class-active/",
+  "pseudo-class-default": "https://www.caniemail.com/features/css-pseudo-class-default/",
+  "pseudo-class-nth-last-of-type": "https://www.caniemail.com/features/css-pseudo-class-nth-last-of-type/",
+  "radial-gradient": "https://www.caniemail.com/features/css-radial-gradient/",
+  "resize": "https://www.caniemail.com/features/css-resize/",
+  "rgb": "https://www.caniemail.com/features/css-rgb/",
+  "rgba": "https://www.caniemail.com/features/css-rgba/",
+  "scroll-snap": "https://www.caniemail.com/features/css-scroll-snap/",
+  "shape-margin": "https://www.caniemail.com/features/css-shape-margin/",
+  "shape-outside": "https://www.caniemail.com/features/css-shape-outside/",
+  "system-ui": "https://www.caniemail.com/features/css-sytem-ui/",
+  "tab-size": "https://www.caniemail.com/features/css-tab-size/",
+  "table-layout": "https://www.caniemail.com/features/css-table-layout/",
+  "text-align": "https://www.caniemail.com/features/css-text-align/",
+  "text-align-last": "https://www.caniemail.com/features/css-text-align-last/",
+  "text-decoration": "https://www.caniemail.com/features/css-text-decoration/",
+  "text-decoration-color": "https://www.caniemail.com/features/css-text-decoration-color/",
+  "text-decoration-line": "https://www.caniemail.com/features/css-text-decoration-line/",
+  "text-decoration-skip-ink": "https://www.caniemail.com/features/css-text-decoration-skip-ink/",
+  "text-decoration-style": "https://www.caniemail.com/features/css-text-decoration-style/",
+  "text-decoration-thickness": "https://www.caniemail.com/features/css-text-decoration-thickness/",
+  "text-emphasis": "https://www.caniemail.com/features/css-text-emphasis/",
+  "text-emphasis-position": "https://www.caniemail.com/features/css-text-emphasis-position/",
+  "text-indent": "https://www.caniemail.com/features/css-text-indent/",
+  "text-justify": "https://www.caniemail.com/features/css-text-justify/",
+  "text-orientation": "https://www.caniemail.com/features/css-text-orientation/",
+  "text-overflow": "https://www.caniemail.com/features/css-text-overflow/",
+  "text-shadow": "https://www.caniemail.com/features/css-text-shadow/",
+  "text-transform": "https://www.caniemail.com/features/css-text-transform/",
+  "text-underline-offset": "https://www.caniemail.com/features/css-text-underline-offset/",
+  "text-underline-position": "https://www.caniemail.com/features/css-text-underline-position/",
+  "text-wrap": "https://www.caniemail.com/features/css-text-wrap/",
+  "transform": "https://www.caniemail.com/features/css-transform/",
+  "transition": "https://www.caniemail.com/features/css-transition/",
+  "unit-ch": "https://www.caniemail.com/features/css-unit-ch/",
+  "unit-cm": "https://www.caniemail.com/features/css-unit-cm/",
+  "unit-em": "https://www.caniemail.com/features/css-unit-em/",
+  "unit-ex": "https://www.caniemail.com/features/css-unit-ex/",
+  "unit-in": "https://www.caniemail.com/features/css-unit-in/",
+  "unit-initial": "https://www.caniemail.com/features/css-unit-initial/",
+  "unit-mm": "https://www.caniemail.com/features/css-unit-mm/",
+  "unit-pc": "https://www.caniemail.com/features/css-unit-pc/",
+  "unit-percent": "https://www.caniemail.com/features/css-unit-percent/",
+  "unit-pt": "https://www.caniemail.com/features/css-unit-pt/",
+  "unit-px": "https://www.caniemail.com/features/css-unit-px/",
+  "unit-rem": "https://www.caniemail.com/features/css-unit-rem/",
+  "unit-vh": "https://www.caniemail.com/features/css-unit-vh/",
+  "unit-vmax": "https://www.caniemail.com/features/css-unit-vmax/",
+  "unit-vmin": "https://www.caniemail.com/features/css-unit-vmin/",
+  "unit-vw": "https://www.caniemail.com/features/css-unit-vw/",
+  "user-select": "https://www.caniemail.com/features/css-user-select/",
+  "vertical-align": "https://www.caniemail.com/features/css-vertical-align/",
+  "visibility": "https://www.caniemail.com/features/css-visibility/",
+  "white-space": "https://www.caniemail.com/features/css-white-space/",
+  "white-space-collapse": "https://www.caniemail.com/features/css-white-space-collapse/",
+  "widows": "https://www.caniemail.com/features/css-widows/",
+  "width": "https://www.caniemail.com/features/css-width/",
+  "word-break": "https://www.caniemail.com/features/css-word-break/",
+  "word-spacing": "https://www.caniemail.com/features/css-word-spacing/",
+  "writing-mode": "https://www.caniemail.com/features/css-writing-mode/",
+  "z-index": "https://www.caniemail.com/features/css-z-index/"
+};
+function featureUrl(code) {
+  return FEATURE_URLS[code];
+}
+
 // src/spam-scorer.ts
 var SPAM_TRIGGER_PHRASES = [
   "act now",
@@ -14134,6 +14393,7 @@ var CompileError = class extends Error {
   CompileError,
   EMAIL_CLIENTS,
   EMPTY_DELIVERABILITY,
+  FEATURE_URLS,
   GENERIC_LINK_TEXT,
   HTML_ELEMENT_FEATURES,
   MAX_HTML_SIZE,
@@ -14158,6 +14418,7 @@ var CompileError = class extends Error {
   errorWarnings,
   estimateAiFixTokens,
   extractInboxPreview,
+  featureUrl,
   formatRgb,
   generateAiFix,
   generateCompatibilityScore,