@emailens/engine 0.9.5 → 0.10.0

package/dist/{react-email-WFdbEleP.d.cts → react-email-B1Rd5itD.d.cts}

@@ -1,4 +1,4 @@
-import { u as InputFormat } from './types-p9e1n-G_.cjs';
+import { u as InputFormat } from './types-DEAn3IiX.cjs';
 
 /**
  * Unified error class for all email compilation failures.

package/dist/{react-email-CkBByvBK.d.ts → react-email-D4XyNztP.d.ts}

@@ -1,4 +1,4 @@
-import { u as InputFormat } from './types-p9e1n-G_.js';
+import { u as InputFormat } from './types-DEAn3IiX.js';
 
 /**
  * Unified error class for all email compilation failures.

package/dist/server.d.cts

@@ -1,5 +1,5 @@
 import { promises } from 'node:dns';
-import { j as DeliverabilityReport } from './types-p9e1n-G_.cjs';
+import { j as DeliverabilityReport } from './types-DEAn3IiX.cjs';
 
 /**
  * DNS-based email deliverability checker.

package/dist/server.d.ts

@@ -1,5 +1,5 @@
 import { promises } from 'node:dns';
-import { j as DeliverabilityReport } from './types-p9e1n-G_.js';
+import { j as DeliverabilityReport } from './types-DEAn3IiX.js';
 
 /**
  * DNS-based email deliverability checker.

package/dist/{types-p9e1n-G_.d.cts → types-DEAn3IiX.d.cts}

@@ -13,6 +13,10 @@ interface ExportPromptOptions {
     format?: "html" | "jsx" | "mjml" | "maizzle";
     /** Optional user goal for the fix (e.g. "keep the gradient header"). */
     intent?: string;
+    /** Content-overflow findings (from checkOverflow) — folded into the fix prompt. */
+    overflow?: OverflowIssue[];
+    /** Visual-bug findings with fixes (from checkVisual) — folded into the fix prompt. */
+    visual?: VisualIssue[];
 }
 declare function generateFixPrompt(options: ExportPromptOptions): string;
 
@@ -106,6 +110,13 @@ interface EmailClient {
     icon: string;
     deprecated?: string;
 }
+type Severity = "error" | "warning" | "info";
+/** Shared shape for every analyzer's issue objects. */
+interface BaseIssue {
+    rule: string;
+    severity: Severity;
+    message: string;
+}
 interface CodeFix {
     before: string;
     after: string;
@@ -114,7 +125,7 @@ interface CodeFix {
 }
 type FixType = "css" | "structural";
 interface CSSWarning {
-    severity: "error" | "warning" | "info";
+    severity: Severity;
     client: string;
     property: string;
     message: string;
@@ -163,10 +174,7 @@ interface DiffResult {
     introduced: CSSWarning[];
     unchanged: CSSWarning[];
 }
-interface SpamIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface SpamIssue extends BaseIssue {
     detail?: string;
 }
 interface SpamReport {
@@ -182,10 +190,7 @@ interface SpamAnalysisOptions {
     /** Type of email — transactional emails are exempt from unsubscribe requirements */
     emailType?: "marketing" | "transactional";
 }
-interface LinkIssue {
-    severity: "error" | "warning" | "info";
-    rule: string;
-    message: string;
+interface LinkIssue extends BaseIssue {
     href?: string;
     text?: string;
 }
@@ -203,10 +208,7 @@ interface LinkReport {
         other: number;
     };
 }
-interface AccessibilityIssue {
-    severity: "error" | "warning" | "info";
-    rule: string;
-    message: string;
+interface AccessibilityIssue extends BaseIssue {
     element?: string;
     details?: string;
 }
@@ -214,10 +216,7 @@ interface AccessibilityReport {
     score: number;
     issues: AccessibilityIssue[];
 }
-interface ImageIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface ImageIssue extends BaseIssue {
     src?: string;
 }
 interface ImageInfo {
@@ -235,10 +234,7 @@ interface ImageReport {
     issues: ImageIssue[];
     images: ImageInfo[];
 }
-interface InboxPreviewIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface InboxPreviewIssue extends BaseIssue {
 }
 interface ClientTruncation {
     client: string;
@@ -257,10 +253,7 @@ interface InboxPreview {
     truncation: ClientTruncation[];
     issues: InboxPreviewIssue[];
 }
-interface SizeIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface SizeIssue extends BaseIssue {
     detail?: string;
 }
 interface SizeReport {
@@ -269,10 +262,23 @@ interface SizeReport {
     clipped: boolean;
     issues: SizeIssue[];
 }
-interface TemplateIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface OverflowIssue extends BaseIssue {
+    detail?: string;
+}
+interface OverflowReport {
+    /** True when any content is likely to overflow the email frame / viewport. */
+    hasOverflow: boolean;
+    issues: OverflowIssue[];
+}
+interface VisualIssue extends BaseIssue {
+    detail?: string;
+    /** Concrete correction to apply (e.g. a background-color / font-family line). */
+    fix?: string;
+}
+interface VisualReport {
+    issues: VisualIssue[];
+}
+interface TemplateIssue extends BaseIssue {
     variable: string;
     location: "text" | "attribute";
 }
@@ -293,11 +299,8 @@ interface DeliverabilityReport {
     score: number;
     issues: DeliverabilityIssue[];
 }
-interface DeliverabilityIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface DeliverabilityIssue extends BaseIssue {
     detail?: string;
 }
 
-export { type AiProvider as A, type TokenEstimateWithWarnings as B, type CSSWarning as C, type DiffResult as D, type EmailClient as E, type Framework as F, estimateAiFixTokens as G, generateFixPrompt as H, type ImageReport as I, heuristicTokenCount as J, type LinkReport as L, type PreviewResult as P, type SupportLevel as S, type TransformResult as T, type CodeFix as a, type ExportPromptOptions as b, type AiFixResult as c, type SpamAnalysisOptions as d, type SpamReport as e, type AccessibilityReport as f, type InboxPreview as g, type SizeReport as h, type TemplateReport as i, type DeliverabilityReport as j, type AccessibilityIssue as k, type ClientTruncation as l, type DeliverabilityCheck as m, type DeliverabilityIssue as n, type EstimateOptions as o, type ExportScope as p, type FixType as q, type ImageInfo as r, type ImageIssue as s, type InboxPreviewIssue as t, type InputFormat as u, type LinkIssue as v, type SizeIssue as w, type SpamIssue as x, type TemplateIssue as y, type TokenEstimate as z };
+export { type AiProvider as A, type BaseIssue as B, type CSSWarning as C, type DiffResult as D, type EmailClient as E, type Framework as F, type TemplateIssue as G, type TokenEstimate as H, type ImageReport as I, type TokenEstimateWithWarnings as J, type VisualIssue as K, type LinkReport as L, estimateAiFixTokens as M, generateFixPrompt as N, type OverflowReport as O, type PreviewResult as P, heuristicTokenCount as Q, type SupportLevel as S, type TransformResult as T, type VisualReport as V, type CodeFix as a, type ExportPromptOptions as b, type AiFixResult as c, type SpamAnalysisOptions as d, type SpamReport as e, type AccessibilityReport as f, type InboxPreview as g, type SizeReport as h, type TemplateReport as i, type DeliverabilityReport as j, type AccessibilityIssue as k, type ClientTruncation as l, type DeliverabilityCheck as m, type DeliverabilityIssue as n, type EstimateOptions as o, type ExportScope as p, type FixType as q, type ImageInfo as r, type ImageIssue as s, type InboxPreviewIssue as t, type InputFormat as u, type LinkIssue as v, type OverflowIssue as w, type Severity as x, type SizeIssue as y, type SpamIssue as z };

package/dist/{types-p9e1n-G_.d.ts → types-DEAn3IiX.d.ts}

@@ -13,6 +13,10 @@ interface ExportPromptOptions {
     format?: "html" | "jsx" | "mjml" | "maizzle";
     /** Optional user goal for the fix (e.g. "keep the gradient header"). */
     intent?: string;
+    /** Content-overflow findings (from checkOverflow) — folded into the fix prompt. */
+    overflow?: OverflowIssue[];
+    /** Visual-bug findings with fixes (from checkVisual) — folded into the fix prompt. */
+    visual?: VisualIssue[];
 }
 declare function generateFixPrompt(options: ExportPromptOptions): string;
 
@@ -106,6 +110,13 @@ interface EmailClient {
     icon: string;
     deprecated?: string;
 }
+type Severity = "error" | "warning" | "info";
+/** Shared shape for every analyzer's issue objects. */
+interface BaseIssue {
+    rule: string;
+    severity: Severity;
+    message: string;
+}
 interface CodeFix {
     before: string;
     after: string;
@@ -114,7 +125,7 @@ interface CodeFix {
 }
 type FixType = "css" | "structural";
 interface CSSWarning {
-    severity: "error" | "warning" | "info";
+    severity: Severity;
     client: string;
     property: string;
     message: string;
@@ -163,10 +174,7 @@ interface DiffResult {
     introduced: CSSWarning[];
     unchanged: CSSWarning[];
 }
-interface SpamIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface SpamIssue extends BaseIssue {
     detail?: string;
 }
 interface SpamReport {
@@ -182,10 +190,7 @@ interface SpamAnalysisOptions {
     /** Type of email — transactional emails are exempt from unsubscribe requirements */
     emailType?: "marketing" | "transactional";
 }
-interface LinkIssue {
-    severity: "error" | "warning" | "info";
-    rule: string;
-    message: string;
+interface LinkIssue extends BaseIssue {
     href?: string;
     text?: string;
 }
@@ -203,10 +208,7 @@ interface LinkReport {
         other: number;
     };
 }
-interface AccessibilityIssue {
-    severity: "error" | "warning" | "info";
-    rule: string;
-    message: string;
+interface AccessibilityIssue extends BaseIssue {
     element?: string;
     details?: string;
 }
@@ -214,10 +216,7 @@ interface AccessibilityReport {
     score: number;
     issues: AccessibilityIssue[];
 }
-interface ImageIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface ImageIssue extends BaseIssue {
     src?: string;
 }
 interface ImageInfo {
@@ -235,10 +234,7 @@ interface ImageReport {
     issues: ImageIssue[];
     images: ImageInfo[];
 }
-interface InboxPreviewIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface InboxPreviewIssue extends BaseIssue {
 }
 interface ClientTruncation {
     client: string;
@@ -257,10 +253,7 @@ interface InboxPreview {
     truncation: ClientTruncation[];
     issues: InboxPreviewIssue[];
 }
-interface SizeIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface SizeIssue extends BaseIssue {
     detail?: string;
 }
 interface SizeReport {
@@ -269,10 +262,23 @@ interface SizeReport {
     clipped: boolean;
     issues: SizeIssue[];
 }
-interface TemplateIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface OverflowIssue extends BaseIssue {
+    detail?: string;
+}
+interface OverflowReport {
+    /** True when any content is likely to overflow the email frame / viewport. */
+    hasOverflow: boolean;
+    issues: OverflowIssue[];
+}
+interface VisualIssue extends BaseIssue {
+    detail?: string;
+    /** Concrete correction to apply (e.g. a background-color / font-family line). */
+    fix?: string;
+}
+interface VisualReport {
+    issues: VisualIssue[];
+}
+interface TemplateIssue extends BaseIssue {
     variable: string;
     location: "text" | "attribute";
 }
@@ -293,11 +299,8 @@ interface DeliverabilityReport {
     score: number;
     issues: DeliverabilityIssue[];
 }
-interface DeliverabilityIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface DeliverabilityIssue extends BaseIssue {
     detail?: string;
 }
 
-export { type AiProvider as A, type TokenEstimateWithWarnings as B, type CSSWarning as C, type DiffResult as D, type EmailClient as E, type Framework as F, estimateAiFixTokens as G, generateFixPrompt as H, type ImageReport as I, heuristicTokenCount as J, type LinkReport as L, type PreviewResult as P, type SupportLevel as S, type TransformResult as T, type CodeFix as a, type ExportPromptOptions as b, type AiFixResult as c, type SpamAnalysisOptions as d, type SpamReport as e, type AccessibilityReport as f, type InboxPreview as g, type SizeReport as h, type TemplateReport as i, type DeliverabilityReport as j, type AccessibilityIssue as k, type ClientTruncation as l, type DeliverabilityCheck as m, type DeliverabilityIssue as n, type EstimateOptions as o, type ExportScope as p, type FixType as q, type ImageInfo as r, type ImageIssue as s, type InboxPreviewIssue as t, type InputFormat as u, type LinkIssue as v, type SizeIssue as w, type SpamIssue as x, type TemplateIssue as y, type TokenEstimate as z };
+export { type AiProvider as A, type BaseIssue as B, type CSSWarning as C, type DiffResult as D, type EmailClient as E, type Framework as F, type TemplateIssue as G, type TokenEstimate as H, type ImageReport as I, type TokenEstimateWithWarnings as J, type VisualIssue as K, type LinkReport as L, estimateAiFixTokens as M, generateFixPrompt as N, type OverflowReport as O, type PreviewResult as P, heuristicTokenCount as Q, type SupportLevel as S, type TransformResult as T, type VisualReport as V, type CodeFix as a, type ExportPromptOptions as b, type AiFixResult as c, type SpamAnalysisOptions as d, type SpamReport as e, type AccessibilityReport as f, type InboxPreview as g, type SizeReport as h, type TemplateReport as i, type DeliverabilityReport as j, type AccessibilityIssue as k, type ClientTruncation as l, type DeliverabilityCheck as m, type DeliverabilityIssue as n, type EstimateOptions as o, type ExportScope as p, type FixType as q, type ImageInfo as r, type ImageIssue as s, type InboxPreviewIssue as t, type InputFormat as u, type LinkIssue as v, type OverflowIssue as w, type Severity as x, type SizeIssue as y, type SpamIssue as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emailens/engine",
-  "version": "0.9.5",
+  "version": "0.10.0",
   "description": "Email compatibility engine — transforms CSS per email client, scores compatibility, simulates dark mode, suggests fixes, and runs spam, accessibility, link, and image quality analysis.",
   "type": "module",
   "exports": {
@@ -36,6 +36,7 @@
     "sync:caniemail": "bun run scripts/sync-caniemail.ts",
     "check:freshness": "bun run scripts/check-data-freshness.ts",
     "test": "bun test",
+    "test:render": "RENDER_TESTS=1 bun test src/__tests__/render.e2e.test.ts",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
@@ -89,6 +90,7 @@
     "@types/react": "^19.2.14",
     "bun-types": "^1.3.9",
     "mjml": "^4.15.0",
+    "playwright": "^1.62.0",
     "react": "^19.0.0",
     "sucrase": "^3.35.0",
     "tsup": "^8.4.0",