chrometools-mcp 3.4.1 → 3.5.1

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 All notable changes to this project will be documented in this file.
 
+## [3.5.1] - 2026-02-16
+
+### Fixed
+- **APOM selector uniqueness** — `generateSelector()` in APOM tree converter now verifies CSS selector uniqueness against the entire document instead of just parent element. Fixes critical bug where `click(id: "button_X")` could click the wrong element (e.g., navigation button instead of action button) when multiple elements shared the same class like `.ant-btn`
+- **findElementsByText click timeout** — `executeElementAction` click now uses adaptive strategy with 5s timeout and JS fallback instead of raw Puppeteer `element.click()` which could hang indefinitely on elements inside complex layouts (antd Tabs, scrollable containers)
+- **findElementsByText non-unique selectors** — `getUniqueSelectorInPage` fallback now checks selector uniqueness at each level of path building (max depth 5→8), preventing clicks on wrong elements when multiple matches exist
+
+### Changed
+- **Screenshot defaults optimized** — Default format changed from PNG/auto to JPEG quality 40 for all screenshot tools, reducing token usage from ~15-25k to ~5-10k tokens per screenshot
+- **Action screenshots compressed** — Screenshots from click/findElementsByText/hover with `screenshot: true` now use lightweight JPEG (quality 40, maxWidth 800) instead of raw PNG, dramatically reducing context consumption
+- **Jimp warmup** — Pre-warms Jimp image processor at server startup (non-blocking, after transport connect) to avoid cold-start delays on first screenshot
+
+## [3.5.0] - 2026-02-16
+
+### Added
+- **Element Model System with Strategy Pattern** — Extensible architecture for custom UI components
+  - Base `ElementModel` class with interface for model definition
+  - `ModelRegistry` for automatic model selection and action routing
+  - 13 concrete models: TextInput, Checkbox, Radio, Button, Select, TextArea, Link, Range, DatePicker, DateInput, FileInput, ColorInput, Default
+  - Models integrated into APOM analyzer — elements now show model name and available actions
+
+- **executeModelAction tool** — Universal tool for model-specific actions
+  - Supports APOM ID (`id` parameter) and CSS selector (`selector` parameter)
+  - Automatic routing via ModelRegistry.getActionHandler()
+  - Framework-specific actions (e.g., DatePicker SetDate, Checkbox toggle)
+
+- **pressKey tool** — Keyboard key press with modifier support
+  - Press Enter, Escape, Tab, Arrow keys, Backspace, Delete, etc.
+  - Modifier keys: Control, Shift, Alt, Meta (e.g., Ctrl+A)
+  - Optional element targeting via APOM ID or CSS selector
+
+- **executeDatePickerAction handler** — Generic date picker interaction
+  - Supports SetDate, SetDateTime, SetTime, and clear actions
+  - Finds inner input and types value with change/blur event dispatch
+  - Tested on Ant Design DatePicker
+
+- **State-aware checkbox actions** — check/uncheck/toggle with skip logic
+  - `check` skips if already checked, `uncheck` skips if already unchecked
+  - `toggle` and `select` always click
+  - Returns descriptive message with final state (e.g., "check (already checked)")
+
+- **TextArea append and clear** — New actions via executeModelAction
+  - `append` types text without clearing existing content
+  - `clear` empties the field completely
+  - Tested on Angular Material, Ant Design, MUI
+
+### Fixed
+- **TextArea/TextInput append destroying existing text** — Verification in setValue() compared exact value on append, falling through to JS fallback that replaced all content. Now uses `endsWith()` check for append mode, and JS fallback appends instead of replacing.
+- **Checkboxes with opacity:0 not appearing in APOM tree** — Updated `isVisible()` to allow stylable inputs (checkbox, radio, file) with `opacity:0`
+
 ## [3.4.1] - 2026-02-12
 
 ### Fixed