@ingcreators/annot-playwright 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @ingcreators/annot-playwright
 
+## 0.3.0
+
+### Minor Changes
+
+- b3e8e53: Both packages now accept an optional `encode` option that flows through to `@ingcreators/annot-annotator@0.3.0`'s `toEncoded()` / `decodeAndEncodeImage()` pipeline. Achieves feature parity with the Chrome extension's "Save size" + "Format smart" capture settings for AI-agent (`annot-mcp`) and Playwright-test (`annot-playwright`) flows.
+
+  ## `annot-playwright`
+
+  ```ts
+  await annotator.annotateScreenshot(page, {
+    annotations: [...],
+    encode: { format: "smart", saveSizePreset: "standard" },
+  });
+  ```
+
+  Returned bytes shrink to PNG-8 / JPEG / resized PNG-32 per the smart heuristic; default behaviour when `encode` is omitted matches v0.2.x (raw PNG-32 from the annotator).
+
+  ## `annot-mcp`
+
+  All five tools (`annot_annotate_screenshot`, `annot_annotate_url`, `annot_redact_screenshot`, `annot_redact_url`, `annot_compare_screenshots`) accept the same `encode` shape on their MCP `inputSchema`. Agents can specify any subset:
+
+  ```jsonc
+  {
+    "url": "https://...",
+    "annotations": [...],
+    "encode": {
+      "format": "smart",
+      "saveSizePreset": "light",
+      "smartFallback": "jpeg"
+    }
+  }
+  ```
+
+  `format`: `"smart"` (default — PNG-8 for UI / PNG / JPEG for photos) / `"png"` / `"jpeg"`.
+  `saveSizePreset`: `"light"` 1280px / `"standard"` 1920px / `"highQuality"` 2560px / `"original"` no resize.
+  `smartFallback`, `smartColorThreshold`, `jpegPercent` all configurable.
+
+  Output `mimeType` flips to `image/jpeg` when the chosen path emits JPEG, so MCP clients render inline correctly. The text confirmation when `output` is set now includes the chosen format and any `reason` (`png-8` / `photo-fallback-jpeg` / `imagequant-missing` / …) for observability.
+
+  Backwards-compatible: when `encode` is omitted, all tools emit PNG-32 bytes verbatim (no decode/encode round-trip, same as v0.1.x / v0.2.x).
+
+### Patch Changes
+
+- Updated dependencies [86d0853]
+  - @ingcreators/annot-annotator@0.3.0
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/fixture.d.ts

@@ -1,4 +1,4 @@
-import { Annotator, BboxAnnotation } from '@ingcreators/annot-annotator';
+import { Annotator, BboxAnnotation, EncodeOptions } from '@ingcreators/annot-annotator';
 /**
  * Minimal Playwright `Page` surface the fixture relies on. The full
  * `@playwright/test` `Page` type is much wider, but importing it
@@ -37,10 +37,17 @@ export type AnnotateScreenshotOptions = {
     annotationsSvg: string;
     annotations?: never;
     fullPage?: boolean;
+    /** Optional encoder settings (since 0.3.0). When omitted the
+     *  fixture emits PNG-32 verbatim (matches 0.1.x / 0.2.x
+     *  behaviour). When set, the annotated bytes go through
+     *  `decodeAndEncodeImage()` for `format` / `saveSizePreset`
+     *  application. */
+    encode?: Partial<EncodeOptions>;
 } | {
     annotations: readonly BboxAnnotation[];
     annotationsSvg?: never;
     fullPage?: boolean;
+    encode?: Partial<EncodeOptions>;
 };
 export interface PlaywrightAnnotator {
     raw: Annotator;

package/dist/index.js

@@ -1,38 +1,41 @@
-import { createAnnotator as c, bboxAnnotationsToSvg as g } from "@ingcreators/annot-annotator";
-import { arrowBetween as m, bboxAnnotationsToSvg as S, rectForBoundingBox as v, textAt as P } from "@ingcreators/annot-annotator";
-import { test as f } from "@playwright/test";
-import { expect as A } from "@playwright/test";
-const u = f.extend({
+import { createAnnotator as d, bboxAnnotationsToSvg as f, DEFAULT_ENCODE_OPTIONS as h, decodeAndEncodeImage as l } from "@ingcreators/annot-annotator";
+import { arrowBetween as A, bboxAnnotationsToSvg as D, rectForBoundingBox as O, textAt as E } from "@ingcreators/annot-annotator";
+import { test as w } from "@playwright/test";
+import { expect as T } from "@playwright/test";
+const P = w.extend({
   // biome-ignore lint/correctness/noEmptyPattern: Playwright fixture signature requires the empty destructure.
   annotator: async ({}, n) => {
-    const o = c();
+    const e = d();
     await n({
-      raw: o,
-      annotateScreenshot: (t, e) => h(o, t, e)
+      raw: e,
+      annotateScreenshot: (t, o) => u(e, t, o)
     });
   }
 });
-async function h(n, o, t) {
-  const e = await o.screenshot({ fullPage: t.fullPage }), { width: a, height: r } = w(e), i = `data:image/png;base64,${e.toString("base64")}`, s = "annotations" in t && t.annotations !== void 0 ? g(t.annotations) : t.annotationsSvg ?? "";
-  return n.toPng({
-    originalDataUrl: i,
-    annotationsSvg: s,
-    width: a,
-    height: r
+async function u(n, e, t) {
+  const o = await e.screenshot({ fullPage: t.fullPage }), { width: r, height: i } = b(o), s = `data:image/png;base64,${o.toString("base64")}`, c = "annotations" in t && t.annotations !== void 0 ? f(t.annotations) : t.annotationsSvg ?? "", a = n.toPng({
+    originalDataUrl: s,
+    annotationsSvg: c,
+    width: r,
+    height: i
   });
+  if (!t.encode || Object.keys(t.encode).length === 0)
+    return a;
+  const g = { ...h, ...t.encode };
+  return (await l(a, g)).bytes;
 }
-function w(n) {
+function b(n) {
   if (n.length < 24)
     throw new Error("PNG too short to contain IHDR chunk");
-  const o = new DataView(n.buffer, n.byteOffset, n.byteLength), t = o.getUint32(16, !1), e = o.getUint32(20, !1);
-  return { width: t, height: e };
+  const e = new DataView(n.buffer, n.byteOffset, n.byteLength), t = e.getUint32(16, !1), o = e.getUint32(20, !1);
+  return { width: t, height: o };
 }
 export {
-  h as annotateScreenshot,
-  m as arrowBetween,
-  S as bboxAnnotationsToSvg,
-  A as expect,
-  v as rectForBoundingBox,
-  u as test,
-  P as textAt
+  u as annotateScreenshot,
+  A as arrowBetween,
+  D as bboxAnnotationsToSvg,
+  T as expect,
+  O as rectForBoundingBox,
+  P as test,
+  E as textAt
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingcreators/annot-playwright",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Playwright fixture for annotated screenshots — emit annotated PNGs from failing tests without leaving the test file. Pairs `test.extend({ annotator })` with the headless renderer from @ingcreators/annot-annotator.",
   "license": "Apache-2.0",
   "author": "ingcreators",
@@ -48,7 +48,7 @@
     "vite-plugin-dts": "^5.0.0"
   },
   "dependencies": {
-    "@ingcreators/annot-annotator": "0.2.0"
+    "@ingcreators/annot-annotator": "0.3.0"
   },
   "peerDependencies": {
     "@playwright/test": "^1.40.0"