@emailens/engine 0.8.2 → 0.8.4

package/dist/index.d.cts

@@ -41,6 +41,9 @@ declare function structuralWarnings(warnings: CSSWarning[]): CSSWarning[];
  * - Some invert colors (Gmail Android)
  * - Some use prefers-color-scheme media query (Apple Mail)
  * - Some do partial inversion (Outlook.com)
+ *
+ * Last verified: 2026-03-04
+ * Sources: Litmus dark mode guide, caniemail.com, Parcel dark mode guide
  */
 declare function simulateDarkMode(html: string, clientId: string): {
     html: string;

package/dist/index.d.ts

@@ -41,6 +41,9 @@ declare function structuralWarnings(warnings: CSSWarning[]): CSSWarning[];
  * - Some invert colors (Gmail Android)
  * - Some use prefers-color-scheme media query (Apple Mail)
  * - Some do partial inversion (Outlook.com)
+ *
+ * Last verified: 2026-03-04
+ * Sources: Litmus dark mode guide, caniemail.com, Parcel dark mode guide
  */
 declare function simulateDarkMode(html: string, clientId: string): {
     html: string;

package/dist/index.js

@@ -5509,7 +5509,7 @@ var GMAIL_CLIP_THRESHOLD = 102 * 1024;
 var GMAIL_CLIP_WARNING_THRESHOLD = 90 * 1024;
 var CLIENT_DISPLAY_LIMITS = [
   { client: "Gmail (Web)", subjectLimit: 70, preheaderLimit: 90 },
-  { client: "Gmail (Mobile)", subjectLimit: 40, preheaderLimit: 90 },
+  { client: "Gmail (Mobile)", subjectLimit: 40, preheaderLimit: 45 },
   { client: "Outlook (Web)", subjectLimit: 60, preheaderLimit: 90 },
   { client: "Outlook (Desktop)", subjectLimit: 55, preheaderLimit: 35 },
   { client: "Apple Mail (macOS)", subjectLimit: 78, preheaderLimit: 140 },
@@ -6323,10 +6323,13 @@ function generateCompatibilityScore(warnings) {
   const result = {};
   for (const client of EMAIL_CLIENTS) {
     const clientWarnings = warnings.filter((w) => w.client === client.id);
-    const errors = clientWarnings.filter((w) => w.severity === "error").length;
-    const warns = clientWarnings.filter((w) => w.severity === "warning").length;
-    const info = clientWarnings.filter((w) => w.severity === "info").length;
-    const score = Math.max(0, Math.min(100, 100 - errors * 15 - warns * 5 - info * 1));
+    const errorProps = new Set(clientWarnings.filter((w) => w.severity === "error").map((w) => w.property));
+    const warnProps = new Set(clientWarnings.filter((w) => w.severity === "warning").map((w) => w.property));
+    const infoProps = new Set(clientWarnings.filter((w) => w.severity === "info").map((w) => w.property));
+    const errors = errorProps.size;
+    const warns = warnProps.size;
+    const info = infoProps.size;
+    const score = Math.max(0, Math.min(100, 100 - errors * 10 - warns * 3));
     result[client.id] = { score, errors, warnings: warns, info };
   }
   return result;
@@ -6610,6 +6613,15 @@ function simulateDarkMode(html, clientId) {
       break;
     case "outlook-web":
       applyColorInversion($, "partial");
+      if (!html.includes("prefers-color-scheme")) {
+        warnings.push({
+          severity: "info",
+          client: clientId,
+          property: "dark-mode",
+          message: "Outlook.com applies partial color inversion in dark mode.",
+          suggestion: "Use [data-ogsc] or [data-ogsb] CSS attribute selectors to override Outlook.com's dark mode color changes."
+        });
+      }
       break;
     case "outlook-windows":
       applyColorInversion($, "full");
@@ -6619,19 +6631,18 @@ function simulateDarkMode(html, clientId) {
           client: clientId,
           property: "dark-mode",
           message: "Outlook Windows applies full color inversion in dark mode. Colors may shift unexpectedly.",
-          suggestion: "Test with dark mode enabled. Use [data-ogsc] or [data-ogsb] overrides to control Outlook dark mode rendering."
+          suggestion: "Test with dark mode enabled. The Word rendering engine offers limited control over dark mode color shifts."
         });
       }
       break;
     case "apple-mail-macos":
     case "apple-mail-ios":
       if (!html.includes("prefers-color-scheme")) {
-        applyColorInversion($, "partial");
         warnings.push({
           severity: "info",
           client: clientId,
           property: "dark-mode",
-          message: "Apple Mail supports @media (prefers-color-scheme: dark). Consider adding dark mode styles.",
+          message: "Apple Mail supports @media (prefers-color-scheme: dark). Without it, email content renders unchanged in dark mode.",
           suggestion: "Add a @media (prefers-color-scheme: dark) block with inverted colors for the best dark mode experience."
         });
       }