@ingcreators/annot-playwright 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @ingcreators/annot-playwright
 
+## 0.3.1
+
+### Patch Changes
+
+- Updated dependencies [806badc]
+- Updated dependencies [df1a429]
+  - @ingcreators/annot-annotator@0.5.0
+
+## 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/README.md

@@ -161,7 +161,7 @@ const annotator = createAnnotator({
   — Phase 0 feasibility report.
 - [`docs/plans/_done/annot-annotator-package.md`](../../docs/plans/_done/annot-annotator-package.md)
   — Phase 1 annotator design.
-- [`docs/plans/annot-playwright-fixture.md`](../../docs/plans/annot-playwright-fixture.md)
+- [`docs/plans/_done/annot-playwright-fixture.md`](../../docs/plans/_done/annot-playwright-fixture.md)
   — Phase 2 design (this package).
 - [`PRODUCT_DIRECTION.md`](../../PRODUCT_DIRECTION.md) — strategic
   context.

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingcreators/annot-playwright",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "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",
@@ -44,11 +44,11 @@
   "devDependencies": {
     "@playwright/test": "^1.50.0",
     "typescript": "^6.0.3",
-    "vite": "^6.4.2",
-    "vite-plugin-dts": "^5.0.0"
+    "vite": "^8.0.13",
+    "vite-plugin-dts": "^5.0.1"
   },
   "dependencies": {
-    "@ingcreators/annot-annotator": "0.2.0"
+    "@ingcreators/annot-annotator": "0.5.0"
   },
   "peerDependencies": {
     "@playwright/test": "^1.40.0"