@emailens/engine 0.8.2 → 0.8.4

package/README.md

@@ -155,7 +155,7 @@ Covers:
 
 - [ ] Outlook VML auto-generation
 - [ ] GitHub Actions integration (score thresholds in CI)
-- [ ] Automated caniemail.com data sync
+- [x] Automated caniemail.com data sync
 - [ ] Real-time rendering previews
 - [ ] MJML/Maizzle source-level linting
 - [ ] Plugin system for custom analyzers
@@ -165,9 +165,20 @@ Covers:
 Contributions are welcome! See **[CONTRIBUTING.md](./CONTRIBUTING.md)** for architecture overview, setup instructions, and PR guidelines.
 
 ```bash
-bun install && bun test   # 574 tests
+bun install && bun test   # 580 tests
 ```
 
+### Data Maintenance
+
+CSS support data is auto-synced from [caniemail.com](https://www.caniemail.com/). Other data (dark mode behavior, display limits, Superhuman overrides) is manually curated and tracked with verification dates.
+
+```bash
+bun run sync:caniemail    # Refresh CSS support matrix from caniemail.com
+bun run check:freshness   # Flag stale data sources (exits 1 if any overdue)
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md#data-sources-and-freshness) for full details on data sources and verification procedures.
+
 ## License
 
 MIT — Copyright 2025 [Emailens](https://emailens.dev)

package/dist/index.cjs

@@ -5606,7 +5606,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 },
@@ -6420,10 +6420,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;
@@ -6707,6 +6710,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");
@@ -6716,19 +6728,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."
         });
       }