visual-ai-assertions 0.10.0 → 0.12.0

package/README.md

@@ -205,7 +205,8 @@ const result = await ai.compare(before, after, {
   instructions: ["Ignore date/time differences"],
 });
 
-// With AI-generated diff image (supported only by gemini-3-flash-preview)
+// With AI-generated diff image (supported by gemini-3-flash-preview and gemini-3.5-flash;
+// only gemini-3-flash-preview auto-enables it — pass diffImage: true explicitly for 3.5-flash)
 const result = await ai.compare(before, after, {
   diffImage: true,
 });
@@ -253,10 +254,10 @@ await ai.elementsVisible(screenshot, ["Submit button", "Nav bar", "Footer"]);
 // Check that UI elements are hidden
 await ai.elementsHidden(screenshot, ["Loading spinner", "Error modal"]);
 
-// Accessibility checks (contrast, readability, interactive visibility)
+// Accessibility checks (contrast, readability, interactive visibility, color blindness, color-alone meaning)
 await ai.accessibility(screenshot);
 await ai.accessibility(screenshot, {
-  checks: [Accessibility.CONTRAST, Accessibility.READABILITY],
+  checks: [Accessibility.CONTRAST, Accessibility.COLOR_BLINDNESS, Accessibility.COLOR_ALONE],
 });
 
 // Layout checks (overlap, overflow, alignment)
@@ -526,6 +527,7 @@ All listed models support image/vision input. Pass any model ID to the `model` c
 
 | Model                 | Model ID                        | Input $/MTok | Output $/MTok | Notes                             |
 | --------------------- | ------------------------------- | ------------ | ------------- | --------------------------------- |
+| Gemini 3.5 Flash      | `gemini-3.5-flash`              | $1.50        | $9            | Strongest agentic & coding model  |
 | Gemini 3.1 Pro        | `gemini-3.1-pro-preview`        | $2           | $12           | Preview — most advanced reasoning |
 | Gemini 3.1 Flash Lite | `gemini-3.1-flash-lite-preview` | $0.25        | $1.50         | Preview — lightweight and cheap   |
 | Gemini 3 Flash        | `gemini-3-flash-preview`        | $0.50        | $3            | **Default** — fast and capable    |

package/dist/index.cjs

@@ -95,6 +95,7 @@ var Model = {
     GPT_5_MINI: "gpt-5-mini"
   },
   Google: {
+    GEMINI_3_5_FLASH: "gemini-3.5-flash",
     GEMINI_3_1_PRO_PREVIEW: "gemini-3.1-pro-preview",
     GEMINI_3_1_FLASH_LITE_PREVIEW: "gemini-3.1-flash-lite-preview",
     GEMINI_3_FLASH_PREVIEW: "gemini-3-flash-preview"
@@ -142,7 +143,11 @@ var Accessibility = {
   /** Detects text that is cut off, overlapping, too small, or obscured */
   READABILITY: "readability",
   /** Detects interactive elements that are not visually distinct */
-  INTERACTIVE_VISIBILITY: "interactive-visibility"
+  INTERACTIVE_VISIBILITY: "interactive-visibility",
+  /** Detects color choices likely to be indistinguishable to viewers with common color vision deficiencies */
+  COLOR_BLINDNESS: "color-blindness",
+  /** Detects information conveyed by color alone, without a non-color cue (icon, text, pattern, position) */
+  COLOR_ALONE: "color-alone"
 };
 
 // src/errors.ts
@@ -467,12 +472,16 @@ var ALL_CHECKS = Object.values(Accessibility);
 var ACCESSIBILITY_ROLE = "Evaluate this screenshot for visual accessibility. Focus on what you can actually perceive \u2014 apparent contrast levels, text legibility, and visual distinctiveness of interactive elements.";
 var ACCESSIBILITY_EDGE_RULES = [
   "Do not state specific contrast ratios. Describe contrast as 'appears sufficient' or 'appears low'.",
-  "Dark mode and light mode themes are both valid. Do not flag a valid dark theme as a contrast issue."
+  "Dark mode and light mode themes are both valid. Do not flag a valid dark theme as a contrast issue.",
+  "Purely decorative color (branding, backgrounds, gradients) is not a color-blindness or color-alone issue \u2014 only flag color usage that carries meaning a user must perceive to use the interface.",
+  "Only evaluate color cues that are visible in the screenshot. Do not assume hover/focus state colors exist if they are not shown."
 ];
 var CHECK_STATEMENTS = {
   [Accessibility.CONTRAST]: "All text and interactive elements appear to have sufficient color contrast \u2014 text is clearly readable against its background",
   [Accessibility.READABILITY]: "All text is readable \u2014 no text is cut off, overlapping, too small to read, or obscured by background images",
-  [Accessibility.INTERACTIVE_VISIBILITY]: "All interactive elements (buttons, links, inputs) are clearly identifiable and visually distinct from non-interactive content"
+  [Accessibility.INTERACTIVE_VISIBILITY]: "All interactive elements (buttons, links, inputs) are clearly identifiable and visually distinct from non-interactive content",
+  [Accessibility.COLOR_BLINDNESS]: "Information conveyed by color remains distinguishable to viewers with common color vision deficiencies \u2014 status indicators, chart series, and other meaningful color pairings do not rely on hue combinations that are commonly confused (e.g., red/green, blue/purple)",
+  [Accessibility.COLOR_ALONE]: "Information conveyed by color is also conveyed through at least one non-color cue \u2014 text labels, icons, shapes, patterns, underlines, or position accompany any color-based meaning (e.g., required fields, error states, chart legends, link styling)"
 };
 function buildAccessibilityPrompt(options) {
   const checks = options?.checks ?? [...ALL_CHECKS];
@@ -993,6 +1002,10 @@ var PRICING_TABLE = {
     inputPricePerToken: 0.25 / PER_MILLION,
     outputPricePerToken: 2 / PER_MILLION
   },
+  [`${Provider.GOOGLE}:${Model.Google.GEMINI_3_5_FLASH}`]: {
+    inputPricePerToken: 1.5 / PER_MILLION,
+    outputPricePerToken: 9 / PER_MILLION
+  },
   [`${Provider.GOOGLE}:${Model.Google.GEMINI_3_1_PRO_PREVIEW}`]: {
     inputPricePerToken: 2 / PER_MILLION,
     outputPricePerToken: 12 / PER_MILLION
@@ -1079,15 +1092,19 @@ async function timedSendMessage(driver, images, prompt, options) {
 
 // src/core/diff.ts
 var import_sharp = __toESM(require("sharp"), 1);
+var DIFF_ALLOWED_MODELS = /* @__PURE__ */ new Set([
+  Model.Google.GEMINI_3_FLASH_PREVIEW,
+  Model.Google.GEMINI_3_5_FLASH
+]);
 async function generateAiDiff(imgA, imgB, model, driver) {
   if (!driver.generateImage) {
     throw new VisualAIConfigError(
       "AI-generated diff images require a provider that supports image generation. Currently only the Google (Gemini) provider supports this."
     );
   }
-  if (model !== Model.Google.GEMINI_3_FLASH_PREVIEW) {
+  if (!DIFF_ALLOWED_MODELS.has(model)) {
     throw new VisualAIConfigError(
-      "Annotated diff images are only supported when visualAI is configured with the Google model gemini-3-flash-preview."
+      `Annotated diff images are only supported with these Google models: ${[...DIFF_ALLOWED_MODELS].join(", ")}.`
     );
   }
   const response = await driver.generateImage([imgA, imgB], buildAiDiffPrompt(), {