@emailens/engine 0.12.1 → 0.12.2

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-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 StyleSurvivalReport, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, g as AccessibilityIssue, I as ImageReport, h as InboxPreview, i as SizeReport, j as TemplateReport, O as OverflowReport, V as VmlReport, k as VisualReport, l as DesignReport, m as DeliverabilityReport } from './types-hQYXbiqj.cjs';
-export { n as AT_RULE_FEATURES, B as BaseIssue, o as COMPOUND_VALUE_FEATURES, p as CSS_FUNCTION_FEATURES, q as CSS_PROPERTY_FEATURES, r as CSS_SUPPORT, s as CSS_SUPPORT_NOTES, t as ClientId, u as ClientTruncation, v as DeliverabilityCheck, w as DeliverabilityIssue, x as DesignIssue, y as EstimateOptions, z as ExportScope, G as FEATURE_LAST_TESTED, H as FeatureKey, J as FixType, K as GRACEFUL_FEATURES, M as HTML_ATTRIBUTE_FEATURES, N as HTML_ELEMENT_FEATURES, P as HTML_MISC_FEATURES, Q as IMAGE_FORMATS, R as IMAGE_SUPPORT, U as IMAGE_SUPPORT_NOTES, W as ImageFormat, X as ImageInfo, Y as ImageIssue, Z as InboxPreviewIssue, _ as InputFormat, $ as LinkInfo, a0 as LinkIssue, a1 as OverflowIssue, a2 as PreviewResult, a3 as SELECTOR_FEATURES, a4 as STRUCTURAL_FIX_PROPERTIES, a5 as SUPPORT_CLIENTS, a6 as Severity, a7 as SizeIssue, a8 as SourceLocation, a9 as SpamIssue, aa as SupportLevel, ab as TemplateIssue, ac as TokenEstimate, ad as TokenEstimateWithWarnings, ae as VisualIssue, af as VmlIssue, ag as estimateAiFixTokens, ah as generateFixPrompt, ai as heuristicTokenCount } from './types-hQYXbiqj.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 StyleSurvivalReport, e as SpamAnalysisOptions, f as SpamReport, L as LinkReport, g as AccessibilityReport, h as AccessibilityIssue, I as ImageReport, i as InboxPreview, j as SizeReport, k as TemplateReport, O as OverflowReport, V as VmlReport, l as VisualReport, m as DesignReport, n as DeliverabilityReport } from './types-DdFHwMtT.cjs';
+export { B as BaseIssue, o as ClientTruncation, p as DeliverabilityCheck, q as DeliverabilityIssue, r as DesignIssue, s as EstimateOptions, t as ExportScope, u as FixType, v as ImageInfo, w as ImageIssue, x as InboxPreviewIssue, y as InputFormat, z as LinkInfo, G as LinkIssue, H as OverflowIssue, P as PreviewResult, J as Severity, K as SizeIssue, M as SourceLocation, N as SpamIssue, Q as TemplateIssue, R as TokenEstimate, U as TokenEstimateWithWarnings, W as VisualIssue, X as VmlIssue, Y as estimateAiFixTokens, Z as generateFixPrompt, _ as heuristicTokenCount } from './types-DdFHwMtT.cjs';
 import * as cheerio from 'cheerio';
-export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-eJhDK8a5.cjs';
+export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-Dmn1QpXz.cjs';
 
 declare const EMAIL_CLIENTS: EmailClient[];
 declare function getClient(id: string): EmailClient | undefined;
@@ -157,6 +157,87 @@ declare function generateAiFix(options: GenerateAiFixOptions): Promise<AiFixResu
  */
 declare const AI_FIX_SYSTEM_PROMPT = "You are an expert email developer specializing in cross-client HTML email compatibility. You fix emails to render correctly across all email clients.\n\nRules:\n- Return ONLY the fixed code inside a single code fence. No explanations before or after.\n- Preserve all existing content, text, links, and visual design.\n- For structural issues (fixType: \"structural\"), you MUST restructure the HTML; CSS-only changes will not work.\n- Common structural patterns:\n  - word-break/overflow-wrap unsupported \u2192 wrap text in <table><tr><td> with constrained width\n  - display:flex/grid \u2192 convert to <table> layout (match the original column count and proportions)\n  - border-radius in Outlook \u2192 use VML <v:roundrect> with <!--[if mso]> conditionals\n  - background-image in Outlook \u2192 use VML <v:rect> with <v:fill>\n  - max-width in Outlook \u2192 wrap in <!--[if mso]><table width=\"N\"> conditional\n  - position:absolute \u2192 use <table> cells for layout\n  - <svg> \u2192 replace with <img> pointing to a hosted PNG\n- For CSS-only issues (fixType: \"css\"), swap properties or add fallbacks.\n- For \"Layout & Visual Issues\", apply the provided Fix directly: add the background-color fallback beneath a gradient/image, append a web-safe font to the stack, and constrain fixed widths wider than the frame to width:100% with max-width.\n- Apply ALL fixes from the issues list: do not skip any.\n- Use the framework syntax specified (JSX/MJML/Maizzle/HTML).\n- For JSX: use camelCase style props, React Email components, and proper TypeScript types.\n- For MJML: use mj-* elements and attributes.\n- For Maizzle: use Tailwind CSS classes.";
 
+/**
+ * CSS/HTML feature support matrix, auto-generated from caniemail.com.
+ * Last synced: 2026-09-02
+ * caniemail last updated: 2026-08-10 15:16:24 +0000
+ *
+ * 298 features and 14 image formats across 21 email clients.
+ *
+ * Support levels:
+ * - "supported": fully supported
+ * - "partial": partially supported (with caveats)
+ * - "unsupported": not supported at all
+ * - "unknown": no data available
+ *
+ * Data sources:
+ * - Most clients: caniemail.com API (verified data)
+ * - hey-mail: caniemail.com (WebKit-based)
+ * - superhuman: Manual overrides (Chromium/Blink-based, best-effort estimates)
+ *
+ * A client we ship as one entry although caniemail tests it on several
+ * platforms (Proton Mail, AOL, Thunderbird) is graded on its worst
+ * platform. Gmail, Outlook, Yahoo and Apple Mail ship as separate clients
+ * per platform instead.
+ *
+ * DO NOT EDIT; regenerate with: bun run sync:caniemail
+ */
+/** The clients every row answers for, in report order. */
+declare const SUPPORT_CLIENTS: readonly ["gmail-web", "gmail-android", "gmail-ios", "outlook-web", "outlook-windows", "outlook-windows-legacy", "outlook-ios", "outlook-android", "outlook-macos", "apple-mail-macos", "apple-mail-ios", "yahoo-mail", "yahoo-mail-android", "yahoo-mail-ios", "samsung-mail", "thunderbird", "hey-mail", "protonmail", "aol", "fastmail", "superhuman"];
+declare const CSS_SUPPORT: Record<string, Record<string, SupportLevel>>;
+/**
+ * Caveat notes per (feature, client) from caniemail: the "why" behind a
+ * partial/buggy/unsupported rating. Sparse: only cells with a note appear.
+ */
+declare const CSS_SUPPORT_NOTES: Record<string, Record<string, string[]>>;
+/**
+ * Image format support, keyed by format. Kept out of CSS_SUPPORT because an
+ * image format is a property of the `src`, not of a stylesheet: the image
+ * analyzer looks these up, the CSS analyzer never should.
+ */
+/** The image formats caniemail grades. */
+declare const IMAGE_FORMATS: readonly ["apng", "avif", "base64", "bmp", "gif", "hdr", "heif", "ico", "jpg", "mp4", "png", "svg", "tiff", "webp"];
+declare const IMAGE_SUPPORT: Record<string, Record<string, SupportLevel>>;
+/** Caveat notes per (image format, client), same shape as CSS_SUPPORT_NOTES. */
+declare const IMAGE_SUPPORT_NOTES: Record<string, Record<string, string[]>>;
+/**
+ * Features a client merely ignores when it "does not support" them: the
+ * email renders the same either way, so these report as info, not warnings.
+ */
+declare const GRACEFUL_FEATURES: ReadonlySet<string>;
+/**
+ * Properties that require HTML structural changes (not just CSS swaps)
+ * to fix. These cannot be solved by replacing one CSS value with another.
+ */
+declare const STRUCTURAL_FIX_PROPERTIES: Set<string>;
+/** HTML element features in the support matrix (for data-driven detection). */
+declare const HTML_ELEMENT_FEATURES: readonly ["<abbr>", "<acronym>", "<address>", "<audio>", "<base>", "<bdi>", "<blockquote>", "<body>", "<button type=\"reset\">", "<button type=\"submit\">", "<code>", "<del>", "<dfn>", "<dialog>", "<div>", "<form>", "<h1>", "<hr>", "<img>", "<input type=\"checkbox\">", "<input type=\"hidden\">", "<input type=\"radio\">", "<input type=\"reset\">", "<input type=\"submit\">", "<input type=\"text\">", "<link>", "<marquee>", "<meter>", "<object>", "<p>", "<picture>", "<pre>", "<progress>", "<rp>", "<rt>", "<ruby>", "<select>", "<small>", "<span>", "<strike>", "<strong>", "<style>", "<svg>", "<table>", "<textarea>", "<ul>", "<video>", "<wbr>"];
+/** HTML attribute features. Each key is also the cheerio selector that finds it. */
+declare const HTML_ATTRIBUTE_FEATURES: readonly ["[align]", "[aria-describedby]", "[aria-hidden]", "[aria-label]", "[aria-labelledby]", "[aria-live]", "[background]", "[cellpadding]", "[cellspacing]", "[command]", "[dir]", "[height]", "[hidden]", "[lang]", "[loading]", "[popover]", "[required]", "[role]", "[srcset]", "[target]", "[valign]", "[width]"];
+/** Document-level and link-shaped HTML features; each has a bespoke detector. */
+declare const HTML_MISC_FEATURES: readonly ["amp4email", "anchor-links", "doctype", "html-comments", "html5-semantics", "image-maps", "mailto-links", "meta-color-scheme"];
+/** CSS at-rule features, including the media features that qualify `@media`. */
+declare const AT_RULE_FEATURES: readonly ["@font-face", "@import", "@keyframes", "@media", "@media device-pixel-ratio", "@media hover", "@media orientation", "@media prefers-color-scheme", "@media prefers-reduced-motion", "@supports"];
+/** One property paired with one value, e.g. "display:flex". */
+declare const COMPOUND_VALUE_FEATURES: readonly ["display:flex", "display:grid", "display:none"];
+/** Pseudo-classes, pseudo-elements and combinators, e.g. ":hover", "::after". */
+declare const SELECTOR_FEATURES: readonly ["::after", "::before", "::first-letter", "::first-line", "::marker", "::placeholder", ":adjacent-sibling", ":attribute-selector", ":chaining", ":checked", ":child-combinator", ":class-selector", ":descendant-combinator", ":first-child", ":first-of-type", ":focus", ":focus-visible", ":focus-within", ":general-sibling", ":grouping", ":has", ":hover", ":id-selector", ":lang", ":last-child", ":last-of-type", ":link", ":not", ":nth-child", ":nth-last-child", ":nth-of-type", ":only-child", ":only-of-type", ":target", ":type-selector", ":universal-selector", ":visited"];
+/** CSS function features (e.g., "linear-gradient"). */
+declare const CSS_FUNCTION_FEATURES: readonly ["calc", "clamp", "conic-gradient", "fit-content", "linear-gradient", "max", "min", "radial-gradient"];
+/** Plain CSS property names: what an inline style or declaration can match. */
+declare const CSS_PROPERTY_FEATURES: readonly ["!important", "accent-color", "align-items", "animation", "aspect-ratio", "backdrop-filter", "background", "background-blend-mode", "background-clip", "background-color", "background-image", "background-origin", "background-position", "background-repeat", "background-size", "bimi", "block-size", "border", "border-collapse", "border-image", "border-inline", "border-inline-individual", "border-inline-longhand", "border-radius", "border-radius-logical", "border-spacing", "bottom", "box-shadow", "box-sizing", "caption-side", "clear", "clip-path", "color", "color-scheme", "column-count", "columns", "css-comments", "cursor", "custom-properties", "direction", "display", "empty-cells", "filter", "flex-direction", "flex-wrap", "float", "font", "font-family", "font-kerning", "font-size", "font-size-adjust", "font-stretch", "font-weight", "gap", "grid-template-columns", "height", "hyphenate-character", "hyphenate-limit-chars", "hyphens", "inert", "inline-size", "inset", "justify-content", "left", "letter-spacing", "light-dark", "line-height", "list-style", "list-style-image", "list-style-position", "list-style-type", "margin", "margin-block-start-end", "margin-inline-block", "margin-inline-start-end", "mask-image", "max-block-size", "max-height", "max-inline-size", "max-width", "min-block-size", "min-height", "min-inline-size", "min-width", "mix-blend-mode", "modern-color", "nesting", "object-fit", "object-position", "opacity", "orphans", "outline", "outline-offset", "overflow", "overflow-wrap", "padding", "padding-block-start-end", "padding-inline-block", "padding-inline-start-end", "position", "pseudo-class-active", "pseudo-class-default", "pseudo-class-nth-last-of-type", "resize", "rgb", "rgba", "right", "scroll-snap", "shape-margin", "shape-outside", "system-ui", "tab-size", "table-layout", "text-align", "text-align-last", "text-decoration", "text-decoration-color", "text-decoration-line", "text-decoration-skip-ink", "text-decoration-style", "text-decoration-thickness", "text-emphasis", "text-emphasis-position", "text-indent", "text-justify", "text-orientation", "text-overflow", "text-shadow", "text-transform", "text-underline-offset", "text-underline-position", "text-wrap", "top", "transform", "transition", "unit-ch", "unit-cm", "unit-em", "unit-ex", "unit-in", "unit-initial", "unit-mm", "unit-pc", "unit-percent", "unit-pt", "unit-px", "unit-rem", "unit-vh", "unit-vmax", "unit-vmin", "unit-vw", "user-select", "vertical-align", "visibility", "white-space", "white-space-collapse", "widows", "width", "word-break", "word-spacing", "writing-mode", "z-index"];
+/** Every feature key in CSS_SUPPORT, as a type. */
+type FeatureKey = (typeof HTML_ELEMENT_FEATURES)[number] | (typeof HTML_ATTRIBUTE_FEATURES)[number] | (typeof HTML_MISC_FEATURES)[number] | (typeof AT_RULE_FEATURES)[number] | (typeof COMPOUND_VALUE_FEATURES)[number] | (typeof SELECTOR_FEATURES)[number] | (typeof CSS_FUNCTION_FEATURES)[number] | (typeof CSS_PROPERTY_FEATURES)[number];
+/** An image format caniemail grades. */
+type ImageFormat = (typeof IMAGE_FORMATS)[number];
+/** A client the matrix answers for. */
+type ClientId = (typeof SUPPORT_CLIENTS)[number];
+/**
+ * When caniemail last re-tested each feature. A feature's row is only as
+ * current as its test date, whatever the file's sync date says.
+ */
+declare const FEATURE_LAST_TESTED: Record<string, string>;
+
 /**
  * Check whether the target clients will keep this email's CSS.
  *
@@ -703,4 +784,4 @@ declare function colorDistance(a: RGBA, b: RGBA): number;
  */
 declare function downlevelCSS(html: string): string;
 
-export { AI_FIX_SYSTEM_PROMPT, AccessibilityIssue, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, CSSWarning, CodeFix, type CreateSessionOptions, DeliverabilityReport, DesignReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, FEATURE_URLS, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, MAX_WARNING_LOCATIONS, OverflowReport, type ParseOptions, type RGBA, type RenderContext, SizeReport, SpamAnalysisOptions, SpamReport, TemplateReport, TransformResult, VALUE_CAVEAT_PROPS, VisualReport, VmlReport, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, arcsizeToRadius, auditEmail, caveatApplies, checkAccessibility, checkDarkModeContrast, checkDarkStylesContrastFromDom, checkDesignConsistency, checkMobileContrast, checkOverflow, checkSize, checkStyleSurvival, checkTemplateVariables, checkVisual, checkVml, colorDistance, contrastRatio, createSession, diffResults, downlevelCSS, errorWarnings, extractInboxPreview, featureUrl, formatRgb, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, renderOutlookBranch, resolveMsoBranch, rgbToOklab, simulateDarkMode, structuralWarnings, toPlainText, transformForAllClients, transformForClient, validateLinks, vmlToCss, warningsForClient, wcagGrade };
+export { AI_FIX_SYSTEM_PROMPT, AT_RULE_FEATURES, AccessibilityIssue, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, COMPOUND_VALUE_FEATURES, CSSWarning, CSS_FUNCTION_FEATURES, CSS_PROPERTY_FEATURES, CSS_SUPPORT, CSS_SUPPORT_NOTES, type ClientId, CodeFix, type CreateSessionOptions, DeliverabilityReport, DesignReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, FEATURE_LAST_TESTED, FEATURE_URLS, type FeatureKey, Framework, GENERIC_LINK_TEXT, GRACEFUL_FEATURES, type GenerateAiFixOptions, HTML_ATTRIBUTE_FEATURES, HTML_ELEMENT_FEATURES, HTML_MISC_FEATURES, IMAGE_FORMATS, IMAGE_SUPPORT, IMAGE_SUPPORT_NOTES, type ImageFormat, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, MAX_WARNING_LOCATIONS, OverflowReport, type ParseOptions, type RGBA, type RenderContext, SELECTOR_FEATURES, STRUCTURAL_FIX_PROPERTIES, SUPPORT_CLIENTS, SizeReport, SpamAnalysisOptions, SpamReport, SupportLevel, TemplateReport, TransformResult, VALUE_CAVEAT_PROPS, VisualReport, VmlReport, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, arcsizeToRadius, auditEmail, caveatApplies, checkAccessibility, checkDarkModeContrast, checkDarkStylesContrastFromDom, checkDesignConsistency, checkMobileContrast, checkOverflow, checkSize, checkStyleSurvival, checkTemplateVariables, checkVisual, checkVml, colorDistance, contrastRatio, createSession, diffResults, downlevelCSS, errorWarnings, extractInboxPreview, featureUrl, formatRgb, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, renderOutlookBranch, resolveMsoBranch, rgbToOklab, simulateDarkMode, structuralWarnings, toPlainText, transformForAllClients, transformForClient, validateLinks, vmlToCss, warningsForClient, wcagGrade };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-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 StyleSurvivalReport, d as SpamAnalysisOptions, e as SpamReport, L as LinkReport, f as AccessibilityReport, g as AccessibilityIssue, I as ImageReport, h as InboxPreview, i as SizeReport, j as TemplateReport, O as OverflowReport, V as VmlReport, k as VisualReport, l as DesignReport, m as DeliverabilityReport } from './types-hQYXbiqj.js';
-export { n as AT_RULE_FEATURES, B as BaseIssue, o as COMPOUND_VALUE_FEATURES, p as CSS_FUNCTION_FEATURES, q as CSS_PROPERTY_FEATURES, r as CSS_SUPPORT, s as CSS_SUPPORT_NOTES, t as ClientId, u as ClientTruncation, v as DeliverabilityCheck, w as DeliverabilityIssue, x as DesignIssue, y as EstimateOptions, z as ExportScope, G as FEATURE_LAST_TESTED, H as FeatureKey, J as FixType, K as GRACEFUL_FEATURES, M as HTML_ATTRIBUTE_FEATURES, N as HTML_ELEMENT_FEATURES, P as HTML_MISC_FEATURES, Q as IMAGE_FORMATS, R as IMAGE_SUPPORT, U as IMAGE_SUPPORT_NOTES, W as ImageFormat, X as ImageInfo, Y as ImageIssue, Z as InboxPreviewIssue, _ as InputFormat, $ as LinkInfo, a0 as LinkIssue, a1 as OverflowIssue, a2 as PreviewResult, a3 as SELECTOR_FEATURES, a4 as STRUCTURAL_FIX_PROPERTIES, a5 as SUPPORT_CLIENTS, a6 as Severity, a7 as SizeIssue, a8 as SourceLocation, a9 as SpamIssue, aa as SupportLevel, ab as TemplateIssue, ac as TokenEstimate, ad as TokenEstimateWithWarnings, ae as VisualIssue, af as VmlIssue, ag as estimateAiFixTokens, ah as generateFixPrompt, ai as heuristicTokenCount } from './types-hQYXbiqj.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 StyleSurvivalReport, e as SpamAnalysisOptions, f as SpamReport, L as LinkReport, g as AccessibilityReport, h as AccessibilityIssue, I as ImageReport, i as InboxPreview, j as SizeReport, k as TemplateReport, O as OverflowReport, V as VmlReport, l as VisualReport, m as DesignReport, n as DeliverabilityReport } from './types-DdFHwMtT.js';
+export { B as BaseIssue, o as ClientTruncation, p as DeliverabilityCheck, q as DeliverabilityIssue, r as DesignIssue, s as EstimateOptions, t as ExportScope, u as FixType, v as ImageInfo, w as ImageIssue, x as InboxPreviewIssue, y as InputFormat, z as LinkInfo, G as LinkIssue, H as OverflowIssue, P as PreviewResult, J as Severity, K as SizeIssue, M as SourceLocation, N as SpamIssue, Q as TemplateIssue, R as TokenEstimate, U as TokenEstimateWithWarnings, W as VisualIssue, X as VmlIssue, Y as estimateAiFixTokens, Z as generateFixPrompt, _ as heuristicTokenCount } from './types-DdFHwMtT.js';
 import * as cheerio from 'cheerio';
-export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-CDNfg8Ta.js';
+export { C as CompileError, a as CompileReactEmailOptions, S as SandboxStrategy } from './react-email-BTIw8QV8.js';
 
 declare const EMAIL_CLIENTS: EmailClient[];
 declare function getClient(id: string): EmailClient | undefined;
@@ -157,6 +157,87 @@ declare function generateAiFix(options: GenerateAiFixOptions): Promise<AiFixResu
  */
 declare const AI_FIX_SYSTEM_PROMPT = "You are an expert email developer specializing in cross-client HTML email compatibility. You fix emails to render correctly across all email clients.\n\nRules:\n- Return ONLY the fixed code inside a single code fence. No explanations before or after.\n- Preserve all existing content, text, links, and visual design.\n- For structural issues (fixType: \"structural\"), you MUST restructure the HTML; CSS-only changes will not work.\n- Common structural patterns:\n  - word-break/overflow-wrap unsupported \u2192 wrap text in <table><tr><td> with constrained width\n  - display:flex/grid \u2192 convert to <table> layout (match the original column count and proportions)\n  - border-radius in Outlook \u2192 use VML <v:roundrect> with <!--[if mso]> conditionals\n  - background-image in Outlook \u2192 use VML <v:rect> with <v:fill>\n  - max-width in Outlook \u2192 wrap in <!--[if mso]><table width=\"N\"> conditional\n  - position:absolute \u2192 use <table> cells for layout\n  - <svg> \u2192 replace with <img> pointing to a hosted PNG\n- For CSS-only issues (fixType: \"css\"), swap properties or add fallbacks.\n- For \"Layout & Visual Issues\", apply the provided Fix directly: add the background-color fallback beneath a gradient/image, append a web-safe font to the stack, and constrain fixed widths wider than the frame to width:100% with max-width.\n- Apply ALL fixes from the issues list: do not skip any.\n- Use the framework syntax specified (JSX/MJML/Maizzle/HTML).\n- For JSX: use camelCase style props, React Email components, and proper TypeScript types.\n- For MJML: use mj-* elements and attributes.\n- For Maizzle: use Tailwind CSS classes.";
 
+/**
+ * CSS/HTML feature support matrix, auto-generated from caniemail.com.
+ * Last synced: 2026-09-02
+ * caniemail last updated: 2026-08-10 15:16:24 +0000
+ *
+ * 298 features and 14 image formats across 21 email clients.
+ *
+ * Support levels:
+ * - "supported": fully supported
+ * - "partial": partially supported (with caveats)
+ * - "unsupported": not supported at all
+ * - "unknown": no data available
+ *
+ * Data sources:
+ * - Most clients: caniemail.com API (verified data)
+ * - hey-mail: caniemail.com (WebKit-based)
+ * - superhuman: Manual overrides (Chromium/Blink-based, best-effort estimates)
+ *
+ * A client we ship as one entry although caniemail tests it on several
+ * platforms (Proton Mail, AOL, Thunderbird) is graded on its worst
+ * platform. Gmail, Outlook, Yahoo and Apple Mail ship as separate clients
+ * per platform instead.
+ *
+ * DO NOT EDIT; regenerate with: bun run sync:caniemail
+ */
+/** The clients every row answers for, in report order. */
+declare const SUPPORT_CLIENTS: readonly ["gmail-web", "gmail-android", "gmail-ios", "outlook-web", "outlook-windows", "outlook-windows-legacy", "outlook-ios", "outlook-android", "outlook-macos", "apple-mail-macos", "apple-mail-ios", "yahoo-mail", "yahoo-mail-android", "yahoo-mail-ios", "samsung-mail", "thunderbird", "hey-mail", "protonmail", "aol", "fastmail", "superhuman"];
+declare const CSS_SUPPORT: Record<string, Record<string, SupportLevel>>;
+/**
+ * Caveat notes per (feature, client) from caniemail: the "why" behind a
+ * partial/buggy/unsupported rating. Sparse: only cells with a note appear.
+ */
+declare const CSS_SUPPORT_NOTES: Record<string, Record<string, string[]>>;
+/**
+ * Image format support, keyed by format. Kept out of CSS_SUPPORT because an
+ * image format is a property of the `src`, not of a stylesheet: the image
+ * analyzer looks these up, the CSS analyzer never should.
+ */
+/** The image formats caniemail grades. */
+declare const IMAGE_FORMATS: readonly ["apng", "avif", "base64", "bmp", "gif", "hdr", "heif", "ico", "jpg", "mp4", "png", "svg", "tiff", "webp"];
+declare const IMAGE_SUPPORT: Record<string, Record<string, SupportLevel>>;
+/** Caveat notes per (image format, client), same shape as CSS_SUPPORT_NOTES. */
+declare const IMAGE_SUPPORT_NOTES: Record<string, Record<string, string[]>>;
+/**
+ * Features a client merely ignores when it "does not support" them: the
+ * email renders the same either way, so these report as info, not warnings.
+ */
+declare const GRACEFUL_FEATURES: ReadonlySet<string>;
+/**
+ * Properties that require HTML structural changes (not just CSS swaps)
+ * to fix. These cannot be solved by replacing one CSS value with another.
+ */
+declare const STRUCTURAL_FIX_PROPERTIES: Set<string>;
+/** HTML element features in the support matrix (for data-driven detection). */
+declare const HTML_ELEMENT_FEATURES: readonly ["<abbr>", "<acronym>", "<address>", "<audio>", "<base>", "<bdi>", "<blockquote>", "<body>", "<button type=\"reset\">", "<button type=\"submit\">", "<code>", "<del>", "<dfn>", "<dialog>", "<div>", "<form>", "<h1>", "<hr>", "<img>", "<input type=\"checkbox\">", "<input type=\"hidden\">", "<input type=\"radio\">", "<input type=\"reset\">", "<input type=\"submit\">", "<input type=\"text\">", "<link>", "<marquee>", "<meter>", "<object>", "<p>", "<picture>", "<pre>", "<progress>", "<rp>", "<rt>", "<ruby>", "<select>", "<small>", "<span>", "<strike>", "<strong>", "<style>", "<svg>", "<table>", "<textarea>", "<ul>", "<video>", "<wbr>"];
+/** HTML attribute features. Each key is also the cheerio selector that finds it. */
+declare const HTML_ATTRIBUTE_FEATURES: readonly ["[align]", "[aria-describedby]", "[aria-hidden]", "[aria-label]", "[aria-labelledby]", "[aria-live]", "[background]", "[cellpadding]", "[cellspacing]", "[command]", "[dir]", "[height]", "[hidden]", "[lang]", "[loading]", "[popover]", "[required]", "[role]", "[srcset]", "[target]", "[valign]", "[width]"];
+/** Document-level and link-shaped HTML features; each has a bespoke detector. */
+declare const HTML_MISC_FEATURES: readonly ["amp4email", "anchor-links", "doctype", "html-comments", "html5-semantics", "image-maps", "mailto-links", "meta-color-scheme"];
+/** CSS at-rule features, including the media features that qualify `@media`. */
+declare const AT_RULE_FEATURES: readonly ["@font-face", "@import", "@keyframes", "@media", "@media device-pixel-ratio", "@media hover", "@media orientation", "@media prefers-color-scheme", "@media prefers-reduced-motion", "@supports"];
+/** One property paired with one value, e.g. "display:flex". */
+declare const COMPOUND_VALUE_FEATURES: readonly ["display:flex", "display:grid", "display:none"];
+/** Pseudo-classes, pseudo-elements and combinators, e.g. ":hover", "::after". */
+declare const SELECTOR_FEATURES: readonly ["::after", "::before", "::first-letter", "::first-line", "::marker", "::placeholder", ":adjacent-sibling", ":attribute-selector", ":chaining", ":checked", ":child-combinator", ":class-selector", ":descendant-combinator", ":first-child", ":first-of-type", ":focus", ":focus-visible", ":focus-within", ":general-sibling", ":grouping", ":has", ":hover", ":id-selector", ":lang", ":last-child", ":last-of-type", ":link", ":not", ":nth-child", ":nth-last-child", ":nth-of-type", ":only-child", ":only-of-type", ":target", ":type-selector", ":universal-selector", ":visited"];
+/** CSS function features (e.g., "linear-gradient"). */
+declare const CSS_FUNCTION_FEATURES: readonly ["calc", "clamp", "conic-gradient", "fit-content", "linear-gradient", "max", "min", "radial-gradient"];
+/** Plain CSS property names: what an inline style or declaration can match. */
+declare const CSS_PROPERTY_FEATURES: readonly ["!important", "accent-color", "align-items", "animation", "aspect-ratio", "backdrop-filter", "background", "background-blend-mode", "background-clip", "background-color", "background-image", "background-origin", "background-position", "background-repeat", "background-size", "bimi", "block-size", "border", "border-collapse", "border-image", "border-inline", "border-inline-individual", "border-inline-longhand", "border-radius", "border-radius-logical", "border-spacing", "bottom", "box-shadow", "box-sizing", "caption-side", "clear", "clip-path", "color", "color-scheme", "column-count", "columns", "css-comments", "cursor", "custom-properties", "direction", "display", "empty-cells", "filter", "flex-direction", "flex-wrap", "float", "font", "font-family", "font-kerning", "font-size", "font-size-adjust", "font-stretch", "font-weight", "gap", "grid-template-columns", "height", "hyphenate-character", "hyphenate-limit-chars", "hyphens", "inert", "inline-size", "inset", "justify-content", "left", "letter-spacing", "light-dark", "line-height", "list-style", "list-style-image", "list-style-position", "list-style-type", "margin", "margin-block-start-end", "margin-inline-block", "margin-inline-start-end", "mask-image", "max-block-size", "max-height", "max-inline-size", "max-width", "min-block-size", "min-height", "min-inline-size", "min-width", "mix-blend-mode", "modern-color", "nesting", "object-fit", "object-position", "opacity", "orphans", "outline", "outline-offset", "overflow", "overflow-wrap", "padding", "padding-block-start-end", "padding-inline-block", "padding-inline-start-end", "position", "pseudo-class-active", "pseudo-class-default", "pseudo-class-nth-last-of-type", "resize", "rgb", "rgba", "right", "scroll-snap", "shape-margin", "shape-outside", "system-ui", "tab-size", "table-layout", "text-align", "text-align-last", "text-decoration", "text-decoration-color", "text-decoration-line", "text-decoration-skip-ink", "text-decoration-style", "text-decoration-thickness", "text-emphasis", "text-emphasis-position", "text-indent", "text-justify", "text-orientation", "text-overflow", "text-shadow", "text-transform", "text-underline-offset", "text-underline-position", "text-wrap", "top", "transform", "transition", "unit-ch", "unit-cm", "unit-em", "unit-ex", "unit-in", "unit-initial", "unit-mm", "unit-pc", "unit-percent", "unit-pt", "unit-px", "unit-rem", "unit-vh", "unit-vmax", "unit-vmin", "unit-vw", "user-select", "vertical-align", "visibility", "white-space", "white-space-collapse", "widows", "width", "word-break", "word-spacing", "writing-mode", "z-index"];
+/** Every feature key in CSS_SUPPORT, as a type. */
+type FeatureKey = (typeof HTML_ELEMENT_FEATURES)[number] | (typeof HTML_ATTRIBUTE_FEATURES)[number] | (typeof HTML_MISC_FEATURES)[number] | (typeof AT_RULE_FEATURES)[number] | (typeof COMPOUND_VALUE_FEATURES)[number] | (typeof SELECTOR_FEATURES)[number] | (typeof CSS_FUNCTION_FEATURES)[number] | (typeof CSS_PROPERTY_FEATURES)[number];
+/** An image format caniemail grades. */
+type ImageFormat = (typeof IMAGE_FORMATS)[number];
+/** A client the matrix answers for. */
+type ClientId = (typeof SUPPORT_CLIENTS)[number];
+/**
+ * When caniemail last re-tested each feature. A feature's row is only as
+ * current as its test date, whatever the file's sync date says.
+ */
+declare const FEATURE_LAST_TESTED: Record<string, string>;
+
 /**
  * Check whether the target clients will keep this email's CSS.
  *
@@ -703,4 +784,4 @@ declare function colorDistance(a: RGBA, b: RGBA): number;
  */
 declare function downlevelCSS(html: string): string;
 
-export { AI_FIX_SYSTEM_PROMPT, AccessibilityIssue, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, CSSWarning, CodeFix, type CreateSessionOptions, DeliverabilityReport, DesignReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, FEATURE_URLS, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, MAX_WARNING_LOCATIONS, OverflowReport, type ParseOptions, type RGBA, type RenderContext, SizeReport, SpamAnalysisOptions, SpamReport, TemplateReport, TransformResult, VALUE_CAVEAT_PROPS, VisualReport, VmlReport, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, arcsizeToRadius, auditEmail, caveatApplies, checkAccessibility, checkDarkModeContrast, checkDarkStylesContrastFromDom, checkDesignConsistency, checkMobileContrast, checkOverflow, checkSize, checkStyleSurvival, checkTemplateVariables, checkVisual, checkVml, colorDistance, contrastRatio, createSession, diffResults, downlevelCSS, errorWarnings, extractInboxPreview, featureUrl, formatRgb, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, renderOutlookBranch, resolveMsoBranch, rgbToOklab, simulateDarkMode, structuralWarnings, toPlainText, transformForAllClients, transformForClient, validateLinks, vmlToCss, warningsForClient, wcagGrade };
+export { AI_FIX_SYSTEM_PROMPT, AT_RULE_FEATURES, AccessibilityIssue, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, COMPOUND_VALUE_FEATURES, CSSWarning, CSS_FUNCTION_FEATURES, CSS_PROPERTY_FEATURES, CSS_SUPPORT, CSS_SUPPORT_NOTES, type ClientId, CodeFix, type CreateSessionOptions, DeliverabilityReport, DesignReport, DiffResult, EMAIL_CLIENTS, EMPTY_DELIVERABILITY, EmailClient, type EmailSession, ExportPromptOptions, FEATURE_LAST_TESTED, FEATURE_URLS, type FeatureKey, Framework, GENERIC_LINK_TEXT, GRACEFUL_FEATURES, type GenerateAiFixOptions, HTML_ATTRIBUTE_FEATURES, HTML_ELEMENT_FEATURES, HTML_MISC_FEATURES, IMAGE_FORMATS, IMAGE_SUPPORT, IMAGE_SUPPORT_NOTES, type ImageFormat, ImageReport, InboxPreview, LinkReport, MAX_HTML_SIZE, MAX_WARNING_LOCATIONS, OverflowReport, type ParseOptions, type RGBA, type RenderContext, SELECTOR_FEATURES, STRUCTURAL_FIX_PROPERTIES, SUPPORT_CLIENTS, SizeReport, SpamAnalysisOptions, SpamReport, SupportLevel, TemplateReport, TransformResult, VALUE_CAVEAT_PROPS, VisualReport, VmlReport, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, arcsizeToRadius, auditEmail, caveatApplies, checkAccessibility, checkDarkModeContrast, checkDarkStylesContrastFromDom, checkDesignConsistency, checkMobileContrast, checkOverflow, checkSize, checkStyleSurvival, checkTemplateVariables, checkVisual, checkVml, colorDistance, contrastRatio, createSession, diffResults, downlevelCSS, errorWarnings, extractInboxPreview, featureUrl, formatRgb, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, renderOutlookBranch, resolveMsoBranch, rgbToOklab, simulateDarkMode, structuralWarnings, toPlainText, transformForAllClients, transformForClient, validateLinks, vmlToCss, warningsForClient, wcagGrade };

package/dist/index.js

@@ -8,7 +8,7 @@ import {
 } from "./chunk-2NMEKWO5.js";
 
 // src/clients.ts
-var EMAIL_CLIENTS = [
+var CLIENTS = [
   {
     id: "gmail-web",
     name: "Gmail",
@@ -183,6 +183,7 @@ var EMAIL_CLIENTS = [
     icon: "monitor"
   }
 ];
+var EMAIL_CLIENTS = [...CLIENTS];
 function getClient(id) {
   return EMAIL_CLIENTS.find((c) => c.id === id);
 }
@@ -8622,7 +8623,9 @@ var GRACEFUL_FEATURES = /* @__PURE__ */ new Set([
   "[aria-labelledby]",
   "[aria-live]",
   "[lang]",
-  "[dir]"
+  "[dir]",
+  "[width]",
+  "[height]"
 ]);
 var OUTLOOK_WORD_UNSUPPORTED = /* @__PURE__ */ new Set([
   "border-radius",
@@ -14701,15 +14704,17 @@ var YAHOO_AOL = [
   "aol"
 ];
 var MAX_LOCS = 20;
+var MAX_COLOR_FUNCTION_LENGTH = 256;
 function hasSpaceSeparatedColor(css) {
   const fn = /\b(?:rgba?|hsla?)\(/gi;
   let m;
   while (m = fn.exec(css)) {
     const start = m.index + m[0].length;
+    const limit = Math.min(css.length, start + MAX_COLOR_FUNCTION_LENGTH);
     let depth = 1;
     let comma = false;
     let i = start;
-    for (; i < css.length && depth > 0; i++) {
+    for (; i < limit && depth > 0; i++) {
       const c = css[i];
       if (c === "(") depth++;
       else if (c === ")") depth--;