@emailens/engine 0.5.1 → 0.6.0

package/dist/index.d.cts

@@ -223,9 +223,114 @@ interface AuditReport {
  * Returns a unified report with compatibility warnings + scores,
  * spam analysis, link validation, accessibility audit, and image analysis.
  * Use the `skip` option to omit checks you don't need.
+ *
+ * Internally parses the HTML once and shares the parsed DOM across
+ * all analyzers to avoid redundant parsing overhead.
  */
 declare function auditEmail(html: string, options?: AuditOptions): AuditReport;
 
+interface CreateSessionOptions {
+    /** Framework for fix snippets (applies to analyze/audit/transform). */
+    framework?: Framework;
+}
+/**
+ * A pre-parsed email session.
+ *
+ * Analysis methods (`analyze`, `audit`, `analyzeSpam`, `validateLinks`,
+ * `checkAccessibility`, `analyzeImages`) share a single Cheerio DOM
+ * parse, eliminating redundant parsing overhead.
+ *
+ * Transformation methods (`transformForClient`, `transformForAllClients`,
+ * `simulateDarkMode`) parse internally since they mutate the DOM per
+ * client. They still benefit from having the session hold the HTML and
+ * framework so you don't need to pass them repeatedly.
+ */
+interface EmailSession {
+    /** The original HTML string. */
+    readonly html: string;
+    /** The framework set at session creation. */
+    readonly framework: Framework | undefined;
+    /**
+     * Run all analysis checks in one call (shares pre-parsed DOM).
+     *
+     * Equivalent to `auditEmail()` but avoids re-parsing the HTML.
+     */
+    audit(options?: Omit<AuditOptions, "framework">): AuditReport;
+    /**
+     * Analyze CSS compatibility warnings (shares pre-parsed DOM).
+     *
+     * Equivalent to `analyzeEmail()` but avoids re-parsing the HTML.
+     */
+    analyze(): CSSWarning[];
+    /** Generate per-client compatibility scores from warnings. */
+    score(warnings: CSSWarning[]): Record<string, {
+        score: number;
+        errors: number;
+        warnings: number;
+        info: number;
+    }>;
+    /** Analyze spam indicators (shares pre-parsed DOM). */
+    analyzeSpam(options?: SpamAnalysisOptions): SpamReport;
+    /** Validate links (shares pre-parsed DOM). */
+    validateLinks(): LinkReport;
+    /** Check accessibility (shares pre-parsed DOM). */
+    checkAccessibility(): AccessibilityReport;
+    /** Analyze images (shares pre-parsed DOM). */
+    analyzeImages(): ImageReport;
+    /**
+     * Transform HTML for a specific client.
+     *
+     * Creates an isolated DOM copy per call (transforms mutate the DOM).
+     */
+    transformForClient(clientId: string): TransformResult;
+    /**
+     * Transform HTML for all 12 email clients.
+     *
+     * Creates an isolated DOM copy per client (transforms mutate the DOM).
+     */
+    transformForAllClients(): TransformResult[];
+    /**
+     * Simulate dark mode for a specific client.
+     *
+     * Creates an isolated DOM copy per call (simulation mutates the DOM).
+     * Operates on the **original** HTML — if you need dark mode on
+     * already-transformed HTML, use the standalone `simulateDarkMode()` instead.
+     */
+    simulateDarkMode(clientId: string): {
+        html: string;
+        warnings: CSSWarning[];
+    };
+}
+/**
+ * Create a session that pre-parses the HTML once and shares the parsed
+ * DOM across all read-only analysis operations.
+ *
+ * Use this when you need to call multiple analysis functions on the
+ * same HTML — it eliminates redundant `cheerio.load()` calls.
+ *
+ * @example
+ * ```typescript
+ * import { createSession } from "@emailens/engine";
+ *
+ * const session = createSession(html, { framework: "jsx" });
+ *
+ * // These all share a single DOM parse:
+ * const warnings = session.analyze();
+ * const scores = session.score(warnings);
+ * const spam = session.analyzeSpam();
+ * const links = session.validateLinks();
+ * const a11y = session.checkAccessibility();
+ * const images = session.analyzeImages();
+ *
+ * // Or run everything at once:
+ * const report = session.audit();
+ *
+ * // Transforms still work (parse internally per client):
+ * const transforms = session.transformForAllClients();
+ * ```
+ */
+declare function createSession(html: string, options?: CreateSessionOptions): EmailSession;
+
 /**
  * Shared constants used across the engine.
  */
@@ -270,4 +375,4 @@ 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, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, CSSWarning, CodeFix, DiffResult, EMAIL_CLIENTS, EmailClient, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, ImageReport, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SpamAnalysisOptions, SpamReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, contrastRatio, diffResults, errorWarnings, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };
+export { AI_FIX_SYSTEM_PROMPT, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, CSSWarning, CodeFix, type CreateSessionOptions, DiffResult, EMAIL_CLIENTS, EmailClient, type EmailSession, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, ImageReport, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SpamAnalysisOptions, SpamReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, contrastRatio, createSession, diffResults, errorWarnings, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };

package/dist/index.d.ts

@@ -223,9 +223,114 @@ interface AuditReport {
  * Returns a unified report with compatibility warnings + scores,
  * spam analysis, link validation, accessibility audit, and image analysis.
  * Use the `skip` option to omit checks you don't need.
+ *
+ * Internally parses the HTML once and shares the parsed DOM across
+ * all analyzers to avoid redundant parsing overhead.
  */
 declare function auditEmail(html: string, options?: AuditOptions): AuditReport;
 
+interface CreateSessionOptions {
+    /** Framework for fix snippets (applies to analyze/audit/transform). */
+    framework?: Framework;
+}
+/**
+ * A pre-parsed email session.
+ *
+ * Analysis methods (`analyze`, `audit`, `analyzeSpam`, `validateLinks`,
+ * `checkAccessibility`, `analyzeImages`) share a single Cheerio DOM
+ * parse, eliminating redundant parsing overhead.
+ *
+ * Transformation methods (`transformForClient`, `transformForAllClients`,
+ * `simulateDarkMode`) parse internally since they mutate the DOM per
+ * client. They still benefit from having the session hold the HTML and
+ * framework so you don't need to pass them repeatedly.
+ */
+interface EmailSession {
+    /** The original HTML string. */
+    readonly html: string;
+    /** The framework set at session creation. */
+    readonly framework: Framework | undefined;
+    /**
+     * Run all analysis checks in one call (shares pre-parsed DOM).
+     *
+     * Equivalent to `auditEmail()` but avoids re-parsing the HTML.
+     */
+    audit(options?: Omit<AuditOptions, "framework">): AuditReport;
+    /**
+     * Analyze CSS compatibility warnings (shares pre-parsed DOM).
+     *
+     * Equivalent to `analyzeEmail()` but avoids re-parsing the HTML.
+     */
+    analyze(): CSSWarning[];
+    /** Generate per-client compatibility scores from warnings. */
+    score(warnings: CSSWarning[]): Record<string, {
+        score: number;
+        errors: number;
+        warnings: number;
+        info: number;
+    }>;
+    /** Analyze spam indicators (shares pre-parsed DOM). */
+    analyzeSpam(options?: SpamAnalysisOptions): SpamReport;
+    /** Validate links (shares pre-parsed DOM). */
+    validateLinks(): LinkReport;
+    /** Check accessibility (shares pre-parsed DOM). */
+    checkAccessibility(): AccessibilityReport;
+    /** Analyze images (shares pre-parsed DOM). */
+    analyzeImages(): ImageReport;
+    /**
+     * Transform HTML for a specific client.
+     *
+     * Creates an isolated DOM copy per call (transforms mutate the DOM).
+     */
+    transformForClient(clientId: string): TransformResult;
+    /**
+     * Transform HTML for all 12 email clients.
+     *
+     * Creates an isolated DOM copy per client (transforms mutate the DOM).
+     */
+    transformForAllClients(): TransformResult[];
+    /**
+     * Simulate dark mode for a specific client.
+     *
+     * Creates an isolated DOM copy per call (simulation mutates the DOM).
+     * Operates on the **original** HTML — if you need dark mode on
+     * already-transformed HTML, use the standalone `simulateDarkMode()` instead.
+     */
+    simulateDarkMode(clientId: string): {
+        html: string;
+        warnings: CSSWarning[];
+    };
+}
+/**
+ * Create a session that pre-parses the HTML once and shares the parsed
+ * DOM across all read-only analysis operations.
+ *
+ * Use this when you need to call multiple analysis functions on the
+ * same HTML — it eliminates redundant `cheerio.load()` calls.
+ *
+ * @example
+ * ```typescript
+ * import { createSession } from "@emailens/engine";
+ *
+ * const session = createSession(html, { framework: "jsx" });
+ *
+ * // These all share a single DOM parse:
+ * const warnings = session.analyze();
+ * const scores = session.score(warnings);
+ * const spam = session.analyzeSpam();
+ * const links = session.validateLinks();
+ * const a11y = session.checkAccessibility();
+ * const images = session.analyzeImages();
+ *
+ * // Or run everything at once:
+ * const report = session.audit();
+ *
+ * // Transforms still work (parse internally per client):
+ * const transforms = session.transformForAllClients();
+ * ```
+ */
+declare function createSession(html: string, options?: CreateSessionOptions): EmailSession;
+
 /**
  * Shared constants used across the engine.
  */
@@ -270,4 +375,4 @@ 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, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, CSSWarning, CodeFix, DiffResult, EMAIL_CLIENTS, EmailClient, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, ImageReport, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SpamAnalysisOptions, SpamReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, contrastRatio, diffResults, errorWarnings, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };
+export { AI_FIX_SYSTEM_PROMPT, AccessibilityReport, AiFixResult, AiProvider, type AuditOptions, type AuditReport, CSSWarning, CodeFix, type CreateSessionOptions, DiffResult, EMAIL_CLIENTS, EmailClient, type EmailSession, ExportPromptOptions, Framework, GENERIC_LINK_TEXT, type GenerateAiFixOptions, ImageReport, LinkReport, MAX_HTML_SIZE, type RGBA, STRUCTURAL_FIX_PROPERTIES, SpamAnalysisOptions, SpamReport, TransformResult, type WcagGrade, alphaBlend, analyzeEmail, analyzeImages, analyzeSpam, auditEmail, checkAccessibility, contrastRatio, createSession, diffResults, errorWarnings, generateAiFix, generateCompatibilityScore, getClient, getCodeFix, getSuggestion, parseColor, relativeLuminance, simulateDarkMode, structuralWarnings, transformForAllClients, transformForClient, validateLinks, warningsForClient, wcagGrade };

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   __objRest,
   __spreadProps,
   __spreadValues
-} from "./chunk-PFONR3YC.js";
+} from "./chunk-ZQF2XUIJ.js";
 
 // src/clients.ts
 var EMAIL_CLIENTS = [
@@ -2747,6 +2747,14 @@ var GENERIC_LINK_TEXT = /* @__PURE__ */ new Set([
   "tap here",
   "this"
 ]);
+var EMPTY_SPAM = { score: 100, level: "low", issues: [] };
+var EMPTY_LINKS = {
+  totalLinks: 0,
+  issues: [],
+  breakdown: { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 }
+};
+var EMPTY_ACCESSIBILITY = { score: 100, issues: [] };
+var EMPTY_IMAGES = { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
 
 // src/transform.ts
 function inlineStyles($) {
@@ -3255,15 +3263,8 @@ function transformForAllClients(html, framework) {
 // src/analyze.ts
 import * as cheerio2 from "cheerio";
 import * as csstree2 from "css-tree";
-function analyzeEmail(html, framework) {
+function analyzeEmailFromDom($, framework) {
   var _a, _b, _c, _d, _e, _f, _g;
-  if (!html || !html.trim()) {
-    return [];
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio2.load(html);
   const warnings = [];
   const seenWarnings = /* @__PURE__ */ new Set();
   function addWarning(w) {
@@ -3508,6 +3509,16 @@ function analyzeEmail(html, framework) {
   warnings.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
   return warnings;
 }
+function analyzeEmail(html, framework) {
+  if (!html || !html.trim()) {
+    return [];
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio2.load(html);
+  return analyzeEmailFromDom($, framework);
+}
 function getFixType(prop) {
   return STRUCTURAL_FIX_PROPERTIES.has(prop) ? "structural" : "css";
 }
@@ -4634,14 +4645,7 @@ function checkAllCapsTitle($) {
   }
   return null;
 }
-function analyzeSpam(html, options) {
-  if (!html || !html.trim()) {
-    return { score: 100, level: "low", issues: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio4.load(html);
+function analyzeSpamFromDom($, options) {
   const text = extractVisibleText($);
   const issues = [];
   const capsIssue = checkCapsRatio(text);
@@ -4679,6 +4683,16 @@ function analyzeSpam(html, options) {
   const level = score >= 70 ? "low" : score >= 40 ? "medium" : "high";
   return { score, level, issues };
 }
+function analyzeSpam(html, options) {
+  if (!html || !html.trim()) {
+    return { score: 100, level: "low", issues: [] };
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio4.load(html);
+  return analyzeSpamFromDom($, options);
+}
 
 // src/link-validator.ts
 import * as cheerio5 from "cheerio";
@@ -4698,18 +4712,7 @@ function isPlaceholderHref(href) {
   const h = href.trim().toLowerCase();
   return h === "#" || h === "" || h === "javascript:void(0)" || h === "javascript:;";
 }
-function validateLinks(html) {
-  if (!html || !html.trim()) {
-    return {
-      totalLinks: 0,
-      issues: [],
-      breakdown: { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 }
-    };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio5.load(html);
+function validateLinksFromDom($) {
   const issues = [];
   const breakdown = { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 };
   const links = $("a");
@@ -4860,6 +4863,20 @@ function validateLinks(html) {
   }
   return { totalLinks, issues, breakdown };
 }
+function validateLinks(html) {
+  if (!html || !html.trim()) {
+    return {
+      totalLinks: 0,
+      issues: [],
+      breakdown: { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 }
+    };
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio5.load(html);
+  return validateLinksFromDom($);
+}
 
 // src/accessibility-checker.ts
 import * as cheerio6 from "cheerio";
@@ -5108,14 +5125,7 @@ function checkSemanticStructure($) {
   }
   return issues;
 }
-function checkAccessibility(html) {
-  if (!html || !html.trim()) {
-    return { score: 100, issues: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio6.load(html);
+function checkAccessibilityFromDom($) {
   const issues = [];
   const langIssue = checkLangAttribute($);
   if (langIssue) issues.push(langIssue);
@@ -5148,6 +5158,16 @@ function checkAccessibility(html) {
   const score = Math.max(0, 100 - penalty);
   return { score, issues };
 }
+function checkAccessibility(html) {
+  if (!html || !html.trim()) {
+    return { score: 100, issues: [] };
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio6.load(html);
+  return checkAccessibilityFromDom($);
+}
 
 // src/image-analyzer.ts
 import * as cheerio7 from "cheerio";
@@ -5181,14 +5201,7 @@ function truncateSrc(src, max = 60) {
   }
   return src.length > max ? src.slice(0, max - 3) + "..." : src;
 }
-function analyzeImages(html) {
-  if (!html || !html.trim()) {
-    return { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
-  }
-  if (html.length > MAX_HTML_SIZE) {
-    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
-  }
-  const $ = cheerio7.load(html);
+function analyzeImagesFromDom($) {
   const issues = [];
   const images = [];
   let totalDataUriBytes = 0;
@@ -5314,16 +5327,19 @@ function analyzeImages(html) {
   }
   return { total: images.length, totalDataUriBytes, issues, images };
 }
+function analyzeImages(html) {
+  if (!html || !html.trim()) {
+    return { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio7.load(html);
+  return analyzeImagesFromDom($);
+}
 
 // src/audit.ts
-var EMPTY_SPAM = { score: 100, level: "low", issues: [] };
-var EMPTY_LINKS = {
-  totalLinks: 0,
-  issues: [],
-  breakdown: { https: 0, http: 0, mailto: 0, tel: 0, anchor: 0, javascript: 0, protocolRelative: 0, other: 0 }
-};
-var EMPTY_ACCESSIBILITY = { score: 100, issues: [] };
-var EMPTY_IMAGES = { total: 0, totalDataUriBytes: 0, issues: [], images: [] };
+import * as cheerio8 from "cheerio";
 function auditEmail(html, options) {
   var _a;
   if (!html || !html.trim()) {
@@ -5340,14 +5356,91 @@ function auditEmail(html, options) {
   }
   const framework = options == null ? void 0 : options.framework;
   const skip = new Set((_a = options == null ? void 0 : options.skip) != null ? _a : []);
-  const warnings = skip.has("compatibility") ? [] : analyzeEmail(html, framework);
+  const $ = cheerio8.load(html);
+  const warnings = skip.has("compatibility") ? [] : analyzeEmailFromDom($, framework);
   const scores = skip.has("compatibility") ? {} : generateCompatibilityScore(warnings);
-  const spam = skip.has("spam") ? EMPTY_SPAM : analyzeSpam(html, options == null ? void 0 : options.spam);
-  const links = skip.has("links") ? EMPTY_LINKS : validateLinks(html);
-  const accessibility = skip.has("accessibility") ? EMPTY_ACCESSIBILITY : checkAccessibility(html);
-  const images = skip.has("images") ? EMPTY_IMAGES : analyzeImages(html);
+  const spam = skip.has("spam") ? EMPTY_SPAM : analyzeSpamFromDom($, options == null ? void 0 : options.spam);
+  const links = skip.has("links") ? EMPTY_LINKS : validateLinksFromDom($);
+  const accessibility = skip.has("accessibility") ? EMPTY_ACCESSIBILITY : checkAccessibilityFromDom($);
+  const images = skip.has("images") ? EMPTY_IMAGES : analyzeImagesFromDom($);
   return { compatibility: { warnings, scores }, spam, links, accessibility, images };
 }
+
+// src/session.ts
+import * as cheerio9 from "cheerio";
+function createSession(html, options) {
+  if (!html || !html.trim()) {
+    const fw = options == null ? void 0 : options.framework;
+    return {
+      html: html || "",
+      framework: fw,
+      audit: () => ({
+        compatibility: { warnings: [], scores: {} },
+        spam: EMPTY_SPAM,
+        links: EMPTY_LINKS,
+        accessibility: EMPTY_ACCESSIBILITY,
+        images: EMPTY_IMAGES
+      }),
+      analyze: () => [],
+      score: () => ({}),
+      analyzeSpam: () => EMPTY_SPAM,
+      validateLinks: () => EMPTY_LINKS,
+      checkAccessibility: () => EMPTY_ACCESSIBILITY,
+      analyzeImages: () => EMPTY_IMAGES,
+      transformForClient: (clientId) => ({ clientId, html: html || "", warnings: [] }),
+      transformForAllClients: () => [],
+      simulateDarkMode: (clientId) => ({ html: html || "", warnings: [] })
+    };
+  }
+  if (html.length > MAX_HTML_SIZE) {
+    throw new Error(`HTML input exceeds ${MAX_HTML_SIZE / 1024}KB limit.`);
+  }
+  const $ = cheerio9.load(html);
+  const framework = options == null ? void 0 : options.framework;
+  return {
+    html,
+    framework,
+    audit(opts) {
+      var _a;
+      const skip = new Set((_a = opts == null ? void 0 : opts.skip) != null ? _a : []);
+      const warnings = skip.has("compatibility") ? [] : analyzeEmailFromDom($, framework);
+      const scores = skip.has("compatibility") ? {} : generateCompatibilityScore(warnings);
+      const spam = skip.has("spam") ? EMPTY_SPAM : analyzeSpamFromDom($, opts == null ? void 0 : opts.spam);
+      const links = skip.has("links") ? EMPTY_LINKS : validateLinksFromDom($);
+      const accessibility = skip.has("accessibility") ? EMPTY_ACCESSIBILITY : checkAccessibilityFromDom($);
+      const images = skip.has("images") ? EMPTY_IMAGES : analyzeImagesFromDom($);
+      return { compatibility: { warnings, scores }, spam, links, accessibility, images };
+    },
+    analyze() {
+      return analyzeEmailFromDom($, framework);
+    },
+    score(warnings) {
+      return generateCompatibilityScore(warnings);
+    },
+    analyzeSpam(opts) {
+      return analyzeSpamFromDom($, opts);
+    },
+    validateLinks() {
+      return validateLinksFromDom($);
+    },
+    checkAccessibility() {
+      return checkAccessibilityFromDom($);
+    },
+    analyzeImages() {
+      return analyzeImagesFromDom($);
+    },
+    // Transforms create isolated copies since they mutate the DOM
+    transformForClient(clientId) {
+      return transformForClient(html, clientId, framework);
+    },
+    transformForAllClients() {
+      return transformForAllClients(html, framework);
+    },
+    simulateDarkMode(clientId) {
+      return simulateDarkMode(html, clientId);
+    }
+  };
+}
 export {
   AI_FIX_SYSTEM_PROMPT,
   CompileError,
@@ -5362,6 +5455,7 @@ export {
   auditEmail,
   checkAccessibility,
   contrastRatio,
+  createSession,
   diffResults,
   errorWarnings,
   estimateAiFixTokens,