@emailens/engine 0.8.4 → 0.8.6

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-4P9AtKm_.cjs';
-export { k as AccessibilityIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as SizeIssue, x as SpamIssue, y as TemplateIssue, z as TokenEstimate, B as TokenEstimateWithWarnings, G as estimateAiFixTokens, H as generateFixPrompt, J as heuristicTokenCount } from './types-4P9AtKm_.cjs';
-export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-C-p8ZL37.cjs';
+import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-Duj14jTL.cjs';
+export { k as AccessibilityIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as SizeIssue, x as SpamIssue, y as TemplateIssue, z as TokenEstimate, B as TokenEstimateWithWarnings, G as estimateAiFixTokens, H as generateFixPrompt, J as heuristicTokenCount } from './types-Duj14jTL.cjs';
+export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-BFwlVmzZ.cjs';
 
 declare const EMAIL_CLIENTS: EmailClient[];
 declare function getClient(id: string): EmailClient | undefined;
@@ -162,7 +162,7 @@ declare const AI_FIX_SYSTEM_PROMPT = "You are an expert email developer speciali
  * Last synced: 2026-03-04
  * caniemail last updated: 2026-02-16 15:39:06 +0000
  *
- * 251 features across 12 email clients.
+ * 251 features across 13 email clients.
  *
  * Support levels:
  * - "supported": fully supported
@@ -299,6 +299,12 @@ interface AuditReport {
  */
 declare function auditEmail(html: string, options?: AuditOptions): AuditReport;
 
+/**
+ * Convert HTML email to plain text suitable for multipart/alternative emails.
+ * Uses cheerio for parsing (already a dependency — no new deps needed).
+ */
+declare function toPlainText(html: string): string;
+
 interface CreateSessionOptions {
     /** Framework for fix snippets (applies to analyze/audit/transform). */
     framework?: Framework;
@@ -360,7 +366,7 @@ interface EmailSession {
      */
     transformForClient(clientId: string): TransformResult;
     /**
-     * Transform HTML for all 12 email clients.
+     * Transform HTML for all 13 email clients.
      *
      * Creates an isolated DOM copy per client (transforms mutate the DOM).
      */
@@ -418,8 +424,9 @@ declare const EMPTY_DELIVERABILITY: DeliverabilityReport;
 /**
  * WCAG 2.1 color parsing, luminance, and contrast utilities.
  *
- * Handles hex (#fff, #ffffff, #rrggbbaa), rgb()/rgba(), 148 named CSS colors,
- * and `transparent`. Returns null for unresolvable values like var(), inherit,
+ * Handles hex (#rgb, #rgba, #rrggbb, #rrggbbaa), rgb()/rgba() (comma and
+ * space syntax), hsl()/hsla(), hwb(), oklch(), 148 named CSS colors, and
+ * `transparent`. Returns null for unresolvable values like var(), inherit,
  * currentColor.
  */
 interface RGBA {
@@ -433,6 +440,11 @@ type WcagGrade = "AAA" | "AA" | "AA Large" | "Fail";
  * Parse a CSS color value to RGBA. Returns null for unresolvable values.
  */
 declare function parseColor(value: string): RGBA | null;
+/**
+ * Format an RGBA value as an rgb() or rgba() CSS string.
+ * Returns `rgba(r, g, b, a)` when alpha < 1, otherwise `rgb(r, g, b)`.
+ */
+declare function formatRgb(rgba: RGBA): string;
 /**
  * Compute WCAG 2.1 relative luminance for an sRGB color.
  * Input values 0-255.
@@ -452,4 +464,30 @@ declare function wcagGrade(ratio: number): WcagGrade;
  */
 declare function alphaBlend(fg: RGBA, bgR: number, bgG: number, bgB: number): [number, number, number];
 
-export { AI_FIX_SYSTEM_PROMPT, AT_RULE_FEATURES, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, COMPOUND_VALUE_FEATURES, CSSWarning, CSS_FUNCTION_FEATURES, CSS_SUPPORT, CodeFix, type CreateSessionOptions, DeliverabilityReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, HTML_ELEMENT_FEATURES, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SizeReport, SpamAnalysisOptions, SpamReport, SupportLevel, TemplateReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, checkSize, checkTemplateVariables, contrastRatio, createSession, diffResults, errorWarnings, extractInboxPreview, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };
+/**
+ * Downlevel modern CSS in HTML emails to maximize email client compatibility.
+ *
+ * Transforms modern CSS features into widely-supported equivalents:
+ * - Modern color functions (oklch, hsl, hwb) to rgb()
+ * - Space-based rgb() to comma-based rgb()
+ * - CSS logical properties to physical properties
+ * - calc(infinity * 1px) to 9999px
+ * - CSS nesting to flat rules
+ * - Range media queries to legacy min/max syntax
+ * - CSS variables (var()) resolved within same stylesheet
+ */
+/**
+ * Downlevel modern CSS in an HTML email to maximize email client compatibility.
+ *
+ * Transformations:
+ * 1. Convert modern color functions (oklch, hsl, hwb) to rgb()
+ * 2. Convert space-based rgb() to comma-based rgb()
+ * 3. Convert CSS logical properties to physical properties
+ * 4. Resolve calc(infinity * 1px) to 9999px
+ * 5. Unnest CSS nesting to flat rules
+ * 6. Convert range media queries to legacy min/max syntax
+ * 7. Resolve CSS variables (var()) within same stylesheet
+ */
+declare function downlevelCSS(html: string): string;
+
+export { AI_FIX_SYSTEM_PROMPT, AT_RULE_FEATURES, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, COMPOUND_VALUE_FEATURES, CSSWarning, CSS_FUNCTION_FEATURES, CSS_SUPPORT, CodeFix, type CreateSessionOptions, DeliverabilityReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, HTML_ELEMENT_FEATURES, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SizeReport, SpamAnalysisOptions, SpamReport, SupportLevel, TemplateReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, checkSize, checkTemplateVariables, contrastRatio, createSession, diffResults, downlevelCSS, errorWarnings, extractInboxPreview, formatRgb, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, toPlainText, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-4P9AtKm_.js';
-export { k as AccessibilityIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as SizeIssue, x as SpamIssue, y as TemplateIssue, z as TokenEstimate, B as TokenEstimateWithWarnings, G as estimateAiFixTokens, H as generateFixPrompt, J as heuristicTokenCount } from './types-4P9AtKm_.js';
-export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-DcseUoOu.js';
+import { E as EmailClient, F as Framework, T as TransformResult, C as CSSWarning, a as CodeFix, D as DiffResult, b as ExportPromptOptions, A as AiProvider, c as AiFixResult, S as SupportLevel, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, I as ImageReport, g as InboxPreview, h as SizeReport, i as TemplateReport, j as DeliverabilityReport } from './types-Duj14jTL.js';
+export { k as AccessibilityIssue, l as ClientTruncation, m as DeliverabilityCheck, n as DeliverabilityIssue, o as EstimateOptions, p as ExportScope, q as FixType, r as ImageInfo, s as ImageIssue, t as InboxPreviewIssue, u as InputFormat, v as LinkIssue, P as PreviewResult, w as SizeIssue, x as SpamIssue, y as TemplateIssue, z as TokenEstimate, B as TokenEstimateWithWarnings, G as estimateAiFixTokens, H as generateFixPrompt, J as heuristicTokenCount } from './types-Duj14jTL.js';
+export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-BENS7LIn.js';
 
 declare const EMAIL_CLIENTS: EmailClient[];
 declare function getClient(id: string): EmailClient | undefined;
@@ -162,7 +162,7 @@ declare const AI_FIX_SYSTEM_PROMPT = "You are an expert email developer speciali
  * Last synced: 2026-03-04
  * caniemail last updated: 2026-02-16 15:39:06 +0000
  *
- * 251 features across 12 email clients.
+ * 251 features across 13 email clients.
  *
  * Support levels:
  * - "supported": fully supported
@@ -299,6 +299,12 @@ interface AuditReport {
  */
 declare function auditEmail(html: string, options?: AuditOptions): AuditReport;
 
+/**
+ * Convert HTML email to plain text suitable for multipart/alternative emails.
+ * Uses cheerio for parsing (already a dependency — no new deps needed).
+ */
+declare function toPlainText(html: string): string;
+
 interface CreateSessionOptions {
     /** Framework for fix snippets (applies to analyze/audit/transform). */
     framework?: Framework;
@@ -360,7 +366,7 @@ interface EmailSession {
      */
     transformForClient(clientId: string): TransformResult;
     /**
-     * Transform HTML for all 12 email clients.
+     * Transform HTML for all 13 email clients.
      *
      * Creates an isolated DOM copy per client (transforms mutate the DOM).
      */
@@ -418,8 +424,9 @@ declare const EMPTY_DELIVERABILITY: DeliverabilityReport;
 /**
  * WCAG 2.1 color parsing, luminance, and contrast utilities.
  *
- * Handles hex (#fff, #ffffff, #rrggbbaa), rgb()/rgba(), 148 named CSS colors,
- * and `transparent`. Returns null for unresolvable values like var(), inherit,
+ * Handles hex (#rgb, #rgba, #rrggbb, #rrggbbaa), rgb()/rgba() (comma and
+ * space syntax), hsl()/hsla(), hwb(), oklch(), 148 named CSS colors, and
+ * `transparent`. Returns null for unresolvable values like var(), inherit,
  * currentColor.
  */
 interface RGBA {
@@ -433,6 +440,11 @@ type WcagGrade = "AAA" | "AA" | "AA Large" | "Fail";
  * Parse a CSS color value to RGBA. Returns null for unresolvable values.
  */
 declare function parseColor(value: string): RGBA | null;
+/**
+ * Format an RGBA value as an rgb() or rgba() CSS string.
+ * Returns `rgba(r, g, b, a)` when alpha < 1, otherwise `rgb(r, g, b)`.
+ */
+declare function formatRgb(rgba: RGBA): string;
 /**
  * Compute WCAG 2.1 relative luminance for an sRGB color.
  * Input values 0-255.
@@ -452,4 +464,30 @@ declare function wcagGrade(ratio: number): WcagGrade;
  */
 declare function alphaBlend(fg: RGBA, bgR: number, bgG: number, bgB: number): [number, number, number];
 
-export { AI_FIX_SYSTEM_PROMPT, AT_RULE_FEATURES, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, COMPOUND_VALUE_FEATURES, CSSWarning, CSS_FUNCTION_FEATURES, CSS_SUPPORT, CodeFix, type CreateSessionOptions, DeliverabilityReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, HTML_ELEMENT_FEATURES, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SizeReport, SpamAnalysisOptions, SpamReport, SupportLevel, TemplateReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, checkSize, checkTemplateVariables, contrastRatio, createSession, diffResults, errorWarnings, extractInboxPreview, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };
+/**
+ * Downlevel modern CSS in HTML emails to maximize email client compatibility.
+ *
+ * Transforms modern CSS features into widely-supported equivalents:
+ * - Modern color functions (oklch, hsl, hwb) to rgb()
+ * - Space-based rgb() to comma-based rgb()
+ * - CSS logical properties to physical properties
+ * - calc(infinity * 1px) to 9999px
+ * - CSS nesting to flat rules
+ * - Range media queries to legacy min/max syntax
+ * - CSS variables (var()) resolved within same stylesheet
+ */
+/**
+ * Downlevel modern CSS in an HTML email to maximize email client compatibility.
+ *
+ * Transformations:
+ * 1. Convert modern color functions (oklch, hsl, hwb) to rgb()
+ * 2. Convert space-based rgb() to comma-based rgb()
+ * 3. Convert CSS logical properties to physical properties
+ * 4. Resolve calc(infinity * 1px) to 9999px
+ * 5. Unnest CSS nesting to flat rules
+ * 6. Convert range media queries to legacy min/max syntax
+ * 7. Resolve CSS variables (var()) within same stylesheet
+ */
+declare function downlevelCSS(html: string): string;
+
+export { AI_FIX_SYSTEM_PROMPT, AT_RULE_FEATURES, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, COMPOUND_VALUE_FEATURES, CSSWarning, CSS_FUNCTION_FEATURES, CSS_SUPPORT, CodeFix, type CreateSessionOptions, DeliverabilityReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, HTML_ELEMENT_FEATURES, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SizeReport, SpamAnalysisOptions, SpamReport, SupportLevel, TemplateReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, checkSize, checkTemplateVariables, contrastRatio, createSession, diffResults, downlevelCSS, errorWarnings, extractInboxPreview, formatRgb, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, toPlainText, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };