@ingcreators/annot-mcp 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # @ingcreators/annot-mcp
 
+## 0.3.1
+
+### Patch Changes
+
+- Updated dependencies [5778902]
+- Updated dependencies [96e7625]
+- Updated dependencies [85d40e6]
+  - @ingcreators/annot-product-docs@0.3.0
+
+## 0.3.0
+
+### Minor Changes
+
+- 806badc: Retire the `@ingcreators/annot-imagequant` (GPL-3.0) dynamic-import
+  boundary that gated PNG-8 output in the headless annotator and the
+  MCP server. `Annotator.toEncoded()`'s smart mode now routes PNG-8
+  through the pure-TS Median Cut + Floyd–Steinberg dither at
+  `@ingcreators/annot-core/encode/quantize-median-cut` directly.
+
+  ### Removed public API
+  - `isImagequantAvailable()` is no longer exported from
+    `@ingcreators/annot-annotator`. PNG-8 is now unconditionally
+    available — callers that previously gated `format: "smart"` on
+    this can drop the check.
+  - `Annotator.toEncoded()` no longer emits
+    `EncodeResult.reason === "imagequant-missing"`. The
+    graceful-PNG-32-fallback path that produced this reason is
+    unreachable.
+
+  ### Removed dependency
+  - `@ingcreators/annot-imagequant` is dropped from
+    `@ingcreators/annot-annotator`'s `dependencies`. Consumers
+    that previously installed it as a side-effect of installing
+    `annot-annotator` will save the WASM payload from their
+    `node_modules`. `annot-mcp` inherits the removal transitively.
+
+  Phase 3 of `docs/plans/replace-libimagequant-with-median-cut.md`.
+  Phase 4 deletes the `@ingcreators/annot-imagequant` workspace
+  package and deprecates the published 0.1.0 on npm.
+
+### Patch Changes
+
+- Updated dependencies [806badc]
+- Updated dependencies [df1a429]
+- Updated dependencies [2e92c97]
+- Updated dependencies [657a685]
+  - @ingcreators/annot-annotator@0.5.0
+  - @ingcreators/annot-product-docs@0.2.0
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -129,6 +129,43 @@ highlighted as `warning`-intent rects.
   content block listing the changed-region bboxes.
 - `output` (optional).
 
+### `annot_aria_snapshot`
+
+Open a URL and return Playwright's AI-mode aria-snapshot
+(YAML format with `[ref=eN]` markers). The same primitive
+`playwright-mcp` and `playwright-cli` use. Foundational
+input for the product-docs workflow (see
+[`docs/plans/_done/living-product-docs.md`](../../docs/plans/_done/living-product-docs.md)).
+
+**Inputs:**
+- `url` — page URL to snapshot.
+- `viewport` (optional) — `{ width, height, deviceScaleFactor }`.
+- `waitFor` (optional) — `"load"` / `"domcontentloaded"` /
+  `"networkidle"`. Default `"load"`.
+- `rootSelector` (optional, default `"body"`) — locator
+  selector whose subtree is snapshotted. Narrow to e.g.
+  `"main"` or `'[data-testid="login-form"]'` when only part
+  of the page is relevant.
+- `timeout` (optional) — forwarded to
+  `locator.ariaSnapshot({ timeout })`. Default 30 s.
+- `output` (optional, absolute path) — when set, the YAML is
+  written here and the tool returns a text confirmation;
+  otherwise the YAML is returned inline.
+
+**Important:** refs (`eN`) are session-local. They identify
+elements within THIS snapshot only. Do NOT persist refs
+across sessions or runs. Persistent identifiers should use
+`role + name` (with tree-path disambiguation for duplicates).
+
+**Example output:**
+
+```yaml
+- textbox "Email" [ref=e3]
+- textbox "Password" [ref=e5]
+- checkbox "Remember me" [ref=e7]
+- button "Sign in" [ref=e9]
+```
+
 ## The annotation DSL
 
 Two flavours. `BboxAnnotation` (used by `_screenshot` tools)
@@ -285,6 +322,7 @@ is the composable primitive.
 | `src/tools/redact-screenshot.ts` | `annot_redact_screenshot` |
 | `src/tools/redact-url.ts` | `annot_redact_url` |
 | `src/tools/compare-screenshots.ts` | `annot_compare_screenshots` |
+| `src/tools/aria-snapshot.ts` | `annot_aria_snapshot` |
 
 ## Runtime dependencies
 

package/dist/browser/aria-snapshot.d.ts

@@ -0,0 +1,37 @@
+import { BrowserPool } from './pool.js';
+export interface AriaSnapshotOptions {
+    url: string;
+    viewport?: {
+        width: number;
+        height: number;
+        deviceScaleFactor?: number;
+    };
+    waitFor?: "load" | "domcontentloaded" | "networkidle";
+    /**
+     * Selector for the locator whose subtree is snapshotted.
+     * Defaults to `"body"` (whole page).
+     */
+    rootSelector?: string;
+    /**
+     * Pass-through to Playwright's `ariaSnapshot({ timeout })`.
+     * Defaults to Playwright's own default (30 s).
+     */
+    timeout?: number;
+}
+export interface AriaSnapshotResult {
+    /**
+     * YAML-formatted accessibility tree. When `mode: "ai"` is used
+     * (which `captureAriaSnapshot` always does), each interactive
+     * element carries a `[ref=eN]` marker.
+     */
+    yaml: string;
+}
+/**
+ * Acquire a browser, open a context + page, navigate to the URL,
+ * take an AI-mode aria-snapshot of the root locator's subtree,
+ * and close everything.
+ *
+ * On any error after browser acquisition, the page + context are
+ * closed and the browser is released before the error propagates.
+ */
+export declare function captureAriaSnapshot(pool: BrowserPool, options: AriaSnapshotOptions): Promise<AriaSnapshotResult>;