@emailens/cli 0.6.0 → 0.7.1

package/dist/index.js

@@ -12,7 +12,7 @@ import { EMAIL_CLIENTS } from "@emailens/engine";
 // package.json
 var package_default = {
   name: "@emailens/cli",
-  version: "0.6.0",
+  version: "0.7.1",
   description: "CLI tool for email compatibility analysis: lint, preview and export HTML, MJML, Maizzle and React Email rendering across 21 email clients.",
   type: "module",
   bin: {
@@ -39,7 +39,7 @@ var package_default = {
     prepublishOnly: "bun run build"
   },
   dependencies: {
-    "@emailens/engine": "^0.12.2",
+    "@emailens/engine": "^0.14.2",
     citty: "^0.1.6",
     "cli-table3": "^0.6.5",
     ora: "^8.2.0",
@@ -99,7 +99,6 @@ import ora from "ora";
 import {
   analyzeEmail,
   generateCompatibilityScore,
-  warningsForClient,
   CompileError
 } from "@emailens/engine";
 
@@ -153,7 +152,10 @@ Valid IDs: ${Array.from(validIds).join(", ")}`
   }
   return requested;
 }
-function resolveFormat(formatFlag, filePath) {
+function isVueSfc(source) {
+  return /<template[\s>]/i.test(source) && /<\/template>/i.test(source);
+}
+function resolveFormat(formatFlag, filePath, source) {
   if (formatFlag) {
     if (!VALID_FORMATS.has(formatFlag)) {
       throw new Error(
@@ -165,6 +167,7 @@ function resolveFormat(formatFlag, filePath) {
   if (filePath && filePath !== "-") {
     return detectFormat(filePath);
   }
+  if (source && isVueSfc(source)) return "maizzle";
   return "html";
 }
 function toFramework(format) {
@@ -174,6 +177,15 @@ function toFramework(format) {
 function positionsApply(format) {
   return format === "html";
 }
+var TARGETING_POLICY_ARG = {
+  type: "string",
+  description: "Client-targeting policy: progressive (default), strict, or lenient"
+};
+function parseTargetingPolicy(raw) {
+  if (raw == null || raw === "") return void 0;
+  if (raw === "progressive" || raw === "strict" || raw === "lenient") return raw;
+  throw new Error(`Unknown targeting policy "${raw}". Valid: progressive, strict, lenient`);
+}
 
 // src/commands/analyze.ts
 import { compile } from "@emailens/engine/compile";
@@ -184,6 +196,57 @@ import Table from "cli-table3";
 import {
   EMAIL_CLIENTS as EMAIL_CLIENTS3
 } from "@emailens/engine";
+
+// src/output/json.ts
+function worstClientScore(scores) {
+  const values = Object.values(scores);
+  if (values.length === 0) return 0;
+  return Math.min(...values.map((s) => s.score));
+}
+function formatJsonOutput(opts) {
+  const overallScore = worstClientScore(opts.scores);
+  const output = {
+    overallScore,
+    scores: opts.scores,
+    warnings: opts.warnings.map((w) => ({
+      client: w.client,
+      property: w.property,
+      severity: w.severity,
+      message: w.message,
+      suggestion: w.suggestion,
+      fix: w.fix ? {
+        before: w.fix.before,
+        after: w.fix.after,
+        language: w.fix.language,
+        description: w.fix.description
+      } : void 0,
+      loc: w.loc,
+      locs: w.locs,
+      locsTruncated: w.locsTruncated
+    }))
+  };
+  if (opts.transforms) {
+    output.transforms = opts.transforms.map((t) => ({
+      clientId: t.clientId,
+      html: t.html
+    }));
+  }
+  if (opts.darkMode) {
+    output.darkMode = {};
+    for (const [clientId, dm] of Object.entries(opts.darkMode)) {
+      output.darkMode[clientId] = {
+        html: dm.html,
+        warningCount: dm.warnings.length
+      };
+    }
+  }
+  return output;
+}
+function printJson(opts) {
+  console.log(JSON.stringify(formatJsonOutput(opts), null, 2));
+}
+
+// src/output/terminal.ts
 function colorScore(score) {
   const str = String(score);
   if (score >= 90) return pc.green(str);
@@ -242,8 +305,7 @@ function printScoreTable(scores, warnings, options) {
     ]);
   }
   console.log(table.toString());
-  const scoreValues = Object.values(scores);
-  const overall = scoreValues.length > 0 ? Math.round(scoreValues.reduce((a, b) => a + b.score, 0) / scoreValues.length) : 0;
+  const overall = worstClientScore(scores);
   console.log();
   console.log(`  Overall: ${colorScore(overall)}/100`);
   console.log();
@@ -284,51 +346,6 @@ function printWarnings(warnings, options) {
   }
 }
 
-// src/output/json.ts
-function formatJsonOutput(opts) {
-  const scoreValues = Object.values(opts.scores);
-  const overallScore = scoreValues.length > 0 ? Math.round(scoreValues.reduce((a, b) => a + b.score, 0) / scoreValues.length) : 0;
-  const output = {
-    overallScore,
-    scores: opts.scores,
-    warnings: opts.warnings.map((w) => ({
-      client: w.client,
-      property: w.property,
-      severity: w.severity,
-      message: w.message,
-      suggestion: w.suggestion,
-      fix: w.fix ? {
-        before: w.fix.before,
-        after: w.fix.after,
-        language: w.fix.language,
-        description: w.fix.description
-      } : void 0,
-      loc: w.loc,
-      locs: w.locs,
-      locsTruncated: w.locsTruncated
-    }))
-  };
-  if (opts.transforms) {
-    output.transforms = opts.transforms.map((t) => ({
-      clientId: t.clientId,
-      html: t.html
-    }));
-  }
-  if (opts.darkMode) {
-    output.darkMode = {};
-    for (const [clientId, dm] of Object.entries(opts.darkMode)) {
-      output.darkMode[clientId] = {
-        html: dm.html,
-        warningCount: dm.warnings.length
-      };
-    }
-  }
-  return output;
-}
-function printJson(opts) {
-  console.log(JSON.stringify(formatJsonOutput(opts), null, 2));
-}
-
 // src/commands/analyze.ts
 var analyze_default = defineCommand({
   meta: {
@@ -359,20 +376,25 @@ var analyze_default = defineCommand({
       type: "boolean",
       alias: "q",
       description: "Suppress spinners and decorations"
-    }
+    },
+    targetingPolicy: TARGETING_POLICY_ARG
   },
   async run({ args }) {
     const spinner = args.quiet || args.json ? null : ora();
     try {
-      const format = resolveFormat(args.format, args.input);
+      if (args.format) resolveFormat(args.format);
       spinner?.start("Reading input...");
       const source = await readInput(args.input);
       spinner?.succeed("Input read");
+      const format = resolveFormat(args.format, args.input, source);
       const html = await compile(source, format);
       const clientIds = resolveClients(args.clients);
       spinner?.start("Analyzing compatibility...");
       const framework = toFramework(format);
-      const warnings = analyzeEmail(html, framework, { positions: positionsApply(format) });
+      const warnings = analyzeEmail(html, framework, {
+        positions: positionsApply(format),
+        targetingPolicy: parseTargetingPolicy(args.targetingPolicy)
+      });
       const allScores = generateCompatibilityScore(warnings);
       const clientSet = new Set(clientIds);
       const scores = {};
@@ -381,7 +403,7 @@ var analyze_default = defineCommand({
           scores[id] = data;
         }
       }
-      const filteredWarnings = clientIds.flatMap((id) => warningsForClient(warnings, id));
+      const filteredWarnings = clientIds.flatMap((id) => warnings.filter((w) => w.client === id));
       spinner?.succeed("Analysis complete");
       if (args.json) {
         printJson({ scores, warnings: filteredWarnings });
@@ -408,7 +430,6 @@ import {
   analyzeEmail as analyzeEmail2,
   generateCompatibilityScore as generateCompatibilityScore2,
   simulateDarkMode,
-  warningsForClient as warningsForClient2,
   CompileError as CompileError2
 } from "@emailens/engine";
 import { compile as compile2 } from "@emailens/engine/compile";
@@ -455,15 +476,17 @@ var preview_default = defineCommand2({
       type: "boolean",
       alias: "q",
       description: "Suppress spinners and decorations"
-    }
+    },
+    targetingPolicy: TARGETING_POLICY_ARG
   },
   async run({ args }) {
     const spinner = args.quiet || args.json ? null : ora2();
     try {
-      const format = resolveFormat(args.format, args.input);
+      if (args.format) resolveFormat(args.format);
       spinner?.start("Reading input...");
       const source = await readInput(args.input);
       spinner?.succeed("Input read");
+      const format = resolveFormat(args.format, args.input, source);
       const html = await compile2(source, format);
       const clientIds = resolveClients(args.clients);
       const clientSet = new Set(clientIds);
@@ -473,7 +496,9 @@ var preview_default = defineCommand2({
       spinner?.succeed(`Transformed for ${transforms.length} clients`);
       spinner?.start("Analyzing compatibility...");
       const framework = toFramework(format);
-      const warnings = analyzeEmail2(html, framework);
+      const warnings = analyzeEmail2(html, framework, {
+        targetingPolicy: parseTargetingPolicy(args.targetingPolicy)
+      });
       const allScores = generateCompatibilityScore2(warnings);
       const scores = {};
       for (const [id, data] of Object.entries(allScores)) {
@@ -481,7 +506,7 @@ var preview_default = defineCommand2({
           scores[id] = data;
         }
       }
-      const filteredWarnings = clientIds.flatMap((id) => warningsForClient2(warnings, id));
+      const filteredWarnings = clientIds.flatMap((id) => warnings.filter((w) => w.client === id));
       spinner?.succeed("Analysis complete");
       let darkMode;
       if (args["dark-mode"]) {
@@ -593,7 +618,6 @@ import {
   analyzeEmail as analyzeEmail3,
   generateCompatibilityScore as generateCompatibilityScore3,
   simulateDarkMode as simulateDarkMode2,
-  warningsForClient as warningsForClient3,
   CompileError as CompileError3
 } from "@emailens/engine";
 import { compile as compile3 } from "@emailens/engine/compile";
@@ -602,8 +626,7 @@ import { compile as compile3 } from "@emailens/engine/compile";
 import { EMAIL_CLIENTS as EMAIL_CLIENTS5 } from "@emailens/engine";
 function generateHtmlReport(opts) {
   const clientMap = new Map(EMAIL_CLIENTS5.map((c) => [c.id, c]));
-  const scoreValues = Object.values(opts.scores);
-  const overallScore = scoreValues.length > 0 ? Math.round(scoreValues.reduce((a, b) => a + b.score, 0) / scoreValues.length) : 0;
+  const overallScore = worstClientScore(opts.scores);
   const scoreColor = (s) => s >= 90 ? "#22c55e" : s >= 70 ? "#eab308" : "#ef4444";
   const clientCards = Object.entries(opts.scores).sort(([, a], [, b]) => a.score - b.score).map(([clientId, { score, errors, warnings: warns, info }]) => {
     const client = clientMap.get(clientId);
@@ -720,16 +743,18 @@ var export_default = defineCommand4({
       type: "boolean",
       alias: "q",
       description: "Suppress spinners and decorations"
-    }
+    },
+    targetingPolicy: TARGETING_POLICY_ARG
   },
   async run({ args }) {
     const spinner = args.quiet ? null : ora3();
     const outDir = resolve(args.out ?? "./emailens-report");
     try {
-      const format = resolveFormat(args.format, args.input);
+      if (args.format) resolveFormat(args.format);
       spinner?.start("Reading input...");
       const source = await readInput(args.input);
       spinner?.succeed("Input read");
+      const format = resolveFormat(args.format, args.input, source);
       const html = await compile3(source, format);
       const clientIds = resolveClients(args.clients);
       const clientSet = new Set(clientIds);
@@ -739,7 +764,9 @@ var export_default = defineCommand4({
       spinner?.succeed(`Transformed for ${transforms.length} clients`);
       spinner?.start("Analyzing compatibility...");
       const framework = toFramework(format);
-      const warnings = analyzeEmail3(html, framework);
+      const warnings = analyzeEmail3(html, framework, {
+        targetingPolicy: parseTargetingPolicy(args.targetingPolicy)
+      });
       const allScores = generateCompatibilityScore3(warnings);
       const scores = {};
       for (const [id, data] of Object.entries(allScores)) {
@@ -747,7 +774,7 @@ var export_default = defineCommand4({
           scores[id] = data;
         }
       }
-      const filteredWarnings = clientIds.flatMap((id) => warningsForClient3(warnings, id));
+      const filteredWarnings = clientIds.flatMap((id) => warnings.filter((w) => w.client === id));
       spinner?.succeed("Analysis complete");
       let darkMode;
       if (args["dark-mode"]) {
@@ -875,19 +902,23 @@ var fix_default = defineCommand5({
     "max-tokens": {
       type: "string",
       description: "Maximum input tokens for the prompt (default: 16000)"
-    }
+    },
+    targetingPolicy: TARGETING_POLICY_ARG
   },
   async run({ args }) {
     const spinner = args.quiet || args.json ? null : ora4();
     try {
-      const format = resolveFormat(args.format, args.input);
-      const framework = toFramework(format);
+      if (args.format) resolveFormat(args.format);
       spinner?.start("Reading input...");
       const source = await readInput(args.input);
+      const format = resolveFormat(args.format, args.input, source);
+      const framework = toFramework(format);
       const html = await compile4(source, format);
       spinner?.succeed("Input read");
       spinner?.start("Analyzing compatibility...");
-      const warnings = analyzeEmail4(html, framework);
+      const warnings = analyzeEmail4(html, framework, {
+        targetingPolicy: parseTargetingPolicy(args.targetingPolicy)
+      });
       const scores = generateCompatibilityScore4(warnings);
       spinner?.succeed(`Found ${warnings.length} warnings`);
       if (warnings.length === 0) {
@@ -1027,11 +1058,11 @@ import {
   CompileError as CompileError5
 } from "@emailens/engine";
 import { compile as compile5 } from "@emailens/engine/compile";
-var VALID_SKIPS = /* @__PURE__ */ new Set(["spam", "links", "accessibility", "images", "compatibility", "overflow", "visual", "darkContrast", "mobileContrast", "design", "vml", "styleSurvival"]);
+var VALID_SKIPS = /* @__PURE__ */ new Set(["spam", "links", "accessibility", "images", "compatibility", "overflow", "visual", "darkContrast", "mobileContrast", "design", "vml", "styleSurvival", "targeting"]);
 var audit_default = defineCommand6({
   meta: {
     name: "audit",
-    description: "Full email audit: compatibility + spam + links + accessibility + images + overflow + visual + contrast + design + Outlook VML"
+    description: "Full email audit: compatibility + spam + links + accessibility + images + overflow + visual + contrast + design + Outlook VML + client targeting"
   },
   args: {
     input: {
@@ -1055,16 +1086,18 @@ var audit_default = defineCommand6({
     },
     skip: {
       type: "string",
-      description: "Comma-separated checks to skip: spam,links,accessibility,images,compatibility,overflow,visual,darkContrast,mobileContrast,design,vml"
-    }
+      description: "Comma-separated checks to skip: spam,links,accessibility,images,compatibility,overflow,visual,darkContrast,mobileContrast,design,vml,styleSurvival,targeting"
+    },
+    targetingPolicy: TARGETING_POLICY_ARG
   },
   async run({ args }) {
     const spinner = args.quiet || args.json ? null : ora5();
     try {
-      const format = resolveFormat(args.format, args.input);
+      if (args.format) resolveFormat(args.format);
       spinner?.start("Reading input...");
       const source = await readInput(args.input);
       spinner?.succeed("Input read");
+      const format = resolveFormat(args.format, args.input, source);
       const html = await compile5(source, format);
       const skip = [];
       if (args.skip) {
@@ -1077,7 +1110,8 @@ var audit_default = defineCommand6({
       }
       spinner?.start("Running full audit...");
       const framework = toFramework(format);
-      const report = auditEmail(html, { framework, skip });
+      const targetingPolicy = parseTargetingPolicy(args.targetingPolicy);
+      const report = auditEmail(html, { framework, skip, targetingPolicy });
       spinner?.succeed("Audit complete");
       if (args.json) {
         console.log(JSON.stringify(report, null, 2));
@@ -1162,6 +1196,14 @@ function printQualitySummary(report, skip, options) {
     const color = issues.length === 0 ? pc4.green : pc4.red;
     table.push(["Style Survival", color(`${issues.length} issue${issues.length === 1 ? "" : "s"}`)]);
   }
+  if (!skip.includes("targeting")) {
+    const { detectedHacks, warnings } = report.targeting;
+    const color = warnings.length === 0 ? pc4.green : pc4.yellow;
+    table.push([
+      "Client Targeting",
+      `${detectedHacks.length} detected, ${color(`${warnings.length} warning${warnings.length === 1 ? "" : "s"}`)}`
+    ]);
+  }
   console.log(table.toString());
   console.log();
 }
@@ -1261,7 +1303,8 @@ var VALID_SKIPS2 = /* @__PURE__ */ new Set([
   "mobileContrast",
   "design",
   "vml",
-  "styleSurvival"
+  "styleSurvival",
+  "targeting"
 ]);
 var lint_default = defineCommand7({
   meta: {
@@ -1289,8 +1332,9 @@ var lint_default = defineCommand7({
     },
     skip: {
       type: "string",
-      description: "Comma-separated checks to skip: spam,links,accessibility,images,compatibility,inboxPreview,size,templateVariables,overflow,visual,vml"
+      description: "Comma-separated checks to skip: spam,links,accessibility,images,compatibility,inboxPreview,size,templateVariables,overflow,visual,vml,styleSurvival,targeting"
     },
+    targetingPolicy: TARGETING_POLICY_ARG,
     maxWarnings: {
       type: "string",
       description: "Fail if more than n warnings"
@@ -1298,6 +1342,7 @@ var lint_default = defineCommand7({
   },
   async run({ args }) {
     try {
+      if (args.format) resolveFormat(args.format);
       const project = loadProjectConfig();
       if (project?.invalid.length && !args.json) {
         console.error(
@@ -1341,15 +1386,17 @@ var lint_default = defineCommand7({
       let totalErrors = 0;
       let totalWarnings = 0;
       for (const file of files) {
-        const format = resolveFormat(args.format, file);
         const source = await readInput(file);
+        const format = resolveFormat(args.format, file, source);
         const html = await compile6(source, format);
         const framework = toFramework(format);
         const positions = positionsApply(format);
+        const targetingPolicy = parseTargetingPolicy(args.targetingPolicy);
         const report = auditEmail2(html, {
           framework,
           skip,
-          positions
+          positions,
+          targetingPolicy
         });
         const issues = applySeverities(flattenToLintIssues(report, skip), project?.rules);
         const errors = issues.filter((i) => i.severity === "error").length;
@@ -1624,6 +1671,20 @@ function flattenToLintIssues(report, skip) {
       });
     }
   }
+  if (!skip.includes("targeting")) {
+    for (const issue of report.targeting.warnings) {
+      issues.push({
+        severity: issue.severity,
+        category: "targeting",
+        rule: issue.property,
+        message: issue.message,
+        detail: issue.suggestion,
+        ...issue.loc ? { loc: issue.loc } : {},
+        ...issue.locs?.length ? { locs: issue.locs } : {},
+        ...issue.locsTruncated ? { locsTruncated: true } : {}
+      });
+    }
+  }
   if (!skip.includes("design")) {
     for (const issue of report.design.issues) {
       issues.push({