@emailens/engine 0.9.4 → 0.9.6

package/dist/{react-email-BFwlVmzZ.d.cts → react-email-M23kFFxl.d.cts}

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

package/dist/{react-email-BENS7LIn.d.ts → react-email-TJF6usIm.d.ts}

@@ -1,4 +1,4 @@
-import { u as InputFormat } from './types-Duj14jTL.js';
+import { u as InputFormat } from './types-WvVf2OXX.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-Duj14jTL.cjs';
+import { j as DeliverabilityReport } from './types-WvVf2OXX.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-Duj14jTL.js';
+import { j as DeliverabilityReport } from './types-WvVf2OXX.js';
 
 /**
  * DNS-based email deliverability checker.

package/dist/{types-Duj14jTL.d.cts → types-WvVf2OXX.d.cts}

@@ -11,6 +11,8 @@ interface ExportPromptOptions {
     scope: ExportScope;
     selectedClientId?: string;
     format?: "html" | "jsx" | "mjml" | "maizzle";
+    /** Optional user goal for the fix (e.g. "keep the gradient header"). */
+    intent?: string;
 }
 declare function generateFixPrompt(options: ExportPromptOptions): string;
 
@@ -104,6 +106,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;
@@ -112,7 +121,7 @@ interface CodeFix {
 }
 type FixType = "css" | "structural";
 interface CSSWarning {
-    severity: "error" | "warning" | "info";
+    severity: Severity;
     client: string;
     property: string;
     message: string;
@@ -161,10 +170,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 {
@@ -180,10 +186,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;
 }
@@ -201,10 +204,7 @@ interface LinkReport {
         other: number;
     };
 }
-interface AccessibilityIssue {
-    severity: "error" | "warning" | "info";
-    rule: string;
-    message: string;
+interface AccessibilityIssue extends BaseIssue {
     element?: string;
     details?: string;
 }
@@ -212,10 +212,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 {
@@ -233,10 +230,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;
@@ -255,10 +249,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 {
@@ -267,10 +258,7 @@ interface SizeReport {
     clipped: boolean;
     issues: SizeIssue[];
 }
-interface TemplateIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface TemplateIssue extends BaseIssue {
     variable: string;
     location: "text" | "attribute";
 }
@@ -291,11 +279,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 TokenEstimate as G, type TokenEstimateWithWarnings as H, type ImageReport as I, estimateAiFixTokens as J, generateFixPrompt as K, type LinkReport as L, heuristicTokenCount as M, 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 Severity as w, type SizeIssue as x, type SpamIssue as y, type TemplateIssue as z };

package/dist/{types-Duj14jTL.d.ts → types-WvVf2OXX.d.ts}

@@ -11,6 +11,8 @@ interface ExportPromptOptions {
     scope: ExportScope;
     selectedClientId?: string;
     format?: "html" | "jsx" | "mjml" | "maizzle";
+    /** Optional user goal for the fix (e.g. "keep the gradient header"). */
+    intent?: string;
 }
 declare function generateFixPrompt(options: ExportPromptOptions): string;
 
@@ -104,6 +106,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;
@@ -112,7 +121,7 @@ interface CodeFix {
 }
 type FixType = "css" | "structural";
 interface CSSWarning {
-    severity: "error" | "warning" | "info";
+    severity: Severity;
     client: string;
     property: string;
     message: string;
@@ -161,10 +170,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 {
@@ -180,10 +186,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;
 }
@@ -201,10 +204,7 @@ interface LinkReport {
         other: number;
     };
 }
-interface AccessibilityIssue {
-    severity: "error" | "warning" | "info";
-    rule: string;
-    message: string;
+interface AccessibilityIssue extends BaseIssue {
     element?: string;
     details?: string;
 }
@@ -212,10 +212,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 {
@@ -233,10 +230,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;
@@ -255,10 +249,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 {
@@ -267,10 +258,7 @@ interface SizeReport {
     clipped: boolean;
     issues: SizeIssue[];
 }
-interface TemplateIssue {
-    rule: string;
-    severity: "error" | "warning" | "info";
-    message: string;
+interface TemplateIssue extends BaseIssue {
     variable: string;
     location: "text" | "attribute";
 }
@@ -291,11 +279,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 TokenEstimate as G, type TokenEstimateWithWarnings as H, type ImageReport as I, estimateAiFixTokens as J, generateFixPrompt as K, type LinkReport as L, heuristicTokenCount as M, 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 Severity as w, type SizeIssue as x, type SpamIssue as y, type TemplateIssue as z };

package/package.json

@@ -1,121 +1,121 @@
-{
-  "name": "@emailens/engine",
-  "version": "0.9.4",
-  "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": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./compile": {
-      "types": "./dist/compile/index.d.ts",
-      "import": "./dist/compile/index.js",
-      "require": "./dist/compile/index.cjs"
-    },
-    "./server": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js",
-      "require": "./dist/server.cjs"
-    }
-  },
-  "types": "./dist/index.d.ts",
-  "sideEffects": false,
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "dist",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "sync:caniemail": "bun run scripts/sync-caniemail.ts",
-    "check:freshness": "bun run scripts/check-data-freshness.ts",
-    "test": "bun test",
-    "prepublishOnly": "bun run build"
-  },
-  "dependencies": {
-    "cheerio": "^1.2.0",
-    "css-tree": "^3.1.0"
-  },
-  "peerDependencies": {
-    "@maizzle/framework": ">=5.0.0",
-    "@react-email/components": ">=0.0.36",
-    "@react-email/render": ">=1.0.0",
-    "isolated-vm": ">=5.0.0",
-    "mjml": ">=4.0.0",
-    "quickjs-emscripten": ">=0.29.0",
-    "react": "^18.0.0 || ^19.0.0",
-    "sucrase": "^3.35.0"
-  },
-  "peerDependenciesMeta": {
-    "sucrase": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "@react-email/components": {
-      "optional": true
-    },
-    "@react-email/render": {
-      "optional": true
-    },
-    "mjml": {
-      "optional": true
-    },
-    "@maizzle/framework": {
-      "optional": true
-    },
-    "isolated-vm": {
-      "optional": true
-    },
-    "quickjs-emscripten": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@maizzle/framework": "^5.0.0",
-    "@react-email/components": "^0.0.36",
-    "@react-email/render": "^1.0.6",
-    "@types/bun": "^1.3.9",
-    "@types/css-tree": "^2.3.11",
-    "@types/mjml": "^4.7.4",
-    "@types/node": "^25.3.0",
-    "@types/react": "^19.2.14",
-    "bun-types": "^1.3.9",
-    "mjml": "^4.15.0",
-    "react": "^19.0.0",
-    "sucrase": "^3.35.0",
-    "tsup": "^8.4.0",
-    "typescript": "^5.9.3"
-  },
-  "keywords": [
-    "email",
-    "html-email",
-    "css",
-    "compatibility",
-    "gmail",
-    "outlook",
-    "apple-mail",
-    "dark-mode",
-    "email-testing",
-    "spam-scoring",
-    "accessibility",
-    "link-validation",
-    "image-analysis"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/emailens/engine.git"
-  },
-  "homepage": "https://github.com/emailens/engine#readme",
-  "bugs": {
-    "url": "https://github.com/emailens/engine/issues"
-  }
-}
+{
+  "name": "@emailens/engine",
+  "version": "0.9.6",
+  "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": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./compile": {
+      "types": "./dist/compile/index.d.ts",
+      "import": "./dist/compile/index.js",
+      "require": "./dist/compile/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "sync:caniemail": "bun run scripts/sync-caniemail.ts",
+    "check:freshness": "bun run scripts/check-data-freshness.ts",
+    "test": "bun test",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "cheerio": "^1.2.0",
+    "css-tree": "^3.1.0"
+  },
+  "peerDependencies": {
+    "@maizzle/framework": ">=5.0.0",
+    "@react-email/components": ">=0.0.36",
+    "@react-email/render": ">=1.0.0",
+    "isolated-vm": ">=5.0.0",
+    "mjml": ">=4.0.0",
+    "quickjs-emscripten": ">=0.29.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "sucrase": "^3.35.0"
+  },
+  "peerDependenciesMeta": {
+    "sucrase": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "@react-email/components": {
+      "optional": true
+    },
+    "@react-email/render": {
+      "optional": true
+    },
+    "mjml": {
+      "optional": true
+    },
+    "@maizzle/framework": {
+      "optional": true
+    },
+    "isolated-vm": {
+      "optional": true
+    },
+    "quickjs-emscripten": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@maizzle/framework": "^5.0.0",
+    "@react-email/components": "^0.0.36",
+    "@react-email/render": "^1.0.6",
+    "@types/bun": "^1.3.9",
+    "@types/css-tree": "^2.3.11",
+    "@types/mjml": "^4.7.4",
+    "@types/node": "^25.3.0",
+    "@types/react": "^19.2.14",
+    "bun-types": "^1.3.9",
+    "mjml": "^4.15.0",
+    "react": "^19.0.0",
+    "sucrase": "^3.35.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.9.3"
+  },
+  "keywords": [
+    "email",
+    "html-email",
+    "css",
+    "compatibility",
+    "gmail",
+    "outlook",
+    "apple-mail",
+    "dark-mode",
+    "email-testing",
+    "spam-scoring",
+    "accessibility",
+    "link-validation",
+    "image-analysis"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emailens/engine.git"
+  },
+  "homepage": "https://github.com/emailens/engine#readme",
+  "bugs": {
+    "url": "https://github.com/emailens/engine/issues"
+  }
+}