chrometools-mcp 3.1.7 → 3.2.6

package/CHANGELOG.md

@@ -2,6 +2,124 @@
 
 All notable changes to this project will be documented in this file.
 
+## [3.2.6] - 2026-01-28
+
+### Removed
+- **getAllInteractiveElements tool** — Removed redundant tool, fully replaced by analyzePage (54 → 53 tools)
+  - `analyzePage` provides superior functionality: hierarchical tree, element registration, APOM IDs, metadata
+  - `getAllInteractiveElements` only returned flat list with CSS selectors
+  - Affected files: `index.js`, `server/tool-definitions.js`, `server/tool-schemas.js`, `server/tool-groups.js`, `README.md`
+
+### Fixed
+- **analyzePage visibility detection** — Fixed critical bug where analyzePage returned tree: null with interactiveCount: 0 on Angular Material pages
+  - Changed `isVisible()` check from `offsetParent` to `offsetWidth/offsetHeight > 0`
+  - Now correctly detects elements inside `position: fixed` containers (Angular Material overlays, dialogs, selects)
+  - Handles `position: sticky` elements properly
+  - Testing on my-autotests.segmento.ru: interactiveCount increased from 0 → 329 elements
+  - Affected file: `pom/apom-tree-converter.js`
+- **type() text corruption** — Fixed text input corruption (duplicated/swapped characters)
+  - Changed default keystroke delay from 0ms to 30ms
+  - Prevents character corruption on fast-reacting inputs (Google Search, autocomplete fields)
+  - Example: "puppeteer automation" no longer becomes "ppuuppppeetteeeerr baruotwosmeart"
+  - Affected file: `index.js:454`
+
+## [3.2.5] - 2026-01-28
+
+### Fixed
+- **CSS selector validation** — Fixed analyzePage crash when elements have numeric IDs
+  - Added validation to skip IDs starting with digits (e.g., `id="301178"`)
+  - CSS selectors don't support IDs starting with numbers (per CSS specification)
+  - Added try-catch for invalid selector edge cases
+  - Affected file: `pom/apom-tree-converter.js`
+
+## [3.2.4] - 2026-01-27
+
+### Performance
+- **Compact APOM format** — Reduced analyzePage output size by ~70%
+  - Containers now use `"tag_id": [children]` format (instead of `{id, tag, selector, children}`)
+  - Selectors removed from output (registered internally for getElementDetails/click/type)
+  - Bottom-up pruning removes container branches without interactive elements
+  - Example: Google Search reduced from ~33K tokens (281 elements) to ~10K tokens (~80 elements)
+  - `includeAll: true` retains full format with selectors for debugging
+
+### Removed
+- **getElement tool** — Redundant tool replaced by analyzePage (55 → 54 tools)
+
+## [3.2.3] - 2026-01-27
+
+### Removed
+- **Reverted experimental features** — Removed `resolveComponentPaths` and `detectFrameworks` due to technical limitations
+  - Component path resolution was unreliable across different build configurations
+  - Framework detection removed from analyzePage tool
+  - Simplified codebase and improved performance
+
+## [3.2.2] - 2026-01-27
+
+### Fixed
+- **APOM ID resolution** — Fixed element ID lookup in `click` and `type` tools
+  - Added CSS selector generation to APOM tree elements
+  - Both interactive and container elements now include `selector` field
+  - APOM IDs (e.g., `textarea_25`, `button_45`) now work correctly with click/type tools
+- **Improved click reliability** — Enhanced click method with fallback strategies
+  - Primary method: standard Puppeteer click
+  - Fallback 1: scroll element into view and retry click
+  - Fallback 2: JavaScript click for hidden/overlapping elements
+  - Fixes issues with Google Search button and similar elements
+
+## [3.2.1] - 2026-01-27
+
+### Changed
+- **Unified element analysis tools** — Merged `analyzeElementById` into `getElementDetails`
+  - `getElementDetails` now has optional `analyzeChildren` parameter
+  - Set `analyzeChildren: true` to get children tree structure
+  - Simplified API reduces tool count and improves consistency
+  - Children analysis includes same `includeAll` and `refresh` options
+
+### Removed
+- **`getElementByApomId`** — Removed deprecated method (use `getElementDetails` instead)
+- **`analyzeElementById`** — Merged into `getElementDetails` with `analyzeChildren` parameter
+
+## [3.2.0] - 2026-01-27
+
+### Added
+- **New tool: `getElementDetails`** — Get comprehensive details about element by APOM ID
+  - Returns bounds, CSS selector, position, attributes, computed styles
+  - Use when `analyzePage` output is simplified and full element info is needed
+- **New tool: `analyzeElementById`** — Analyze children elements starting from specific APOM ID
+  - Useful for analyzing specific page sections without re-analyzing entire page
+  - Supports `includeAll` and `refresh` parameters
+
+### Changed
+- **Optimized `analyzePage` output** — Significantly reduced token usage
+  - Parent/container elements now show only `tag` and `id` (minimal info)
+  - Interactive elements no longer include `bounds` and `selector` in main output
+  - Use `getElementDetails` to get full information when needed
+  - ~50-70% reduction in output size for typical pages
+- **Improved cursor:pointer detection** — Only detects explicitly set cursor, not inherited
+  - Filters out inherited `cursor:pointer` from parent elements
+  - Reduces false positives in interactive element detection
+  - More accurate identification of clickable elements
+
+### Deprecated
+- **`getElementByApomId`** — Use `getElementDetails` instead (same functionality, clearer name)
+  - Filters out Angular dynamic classes (e.g., `_ng*`)
+  - Prefers stable class names for more reliable selectors across page loads
+
+## [3.1.8] - 2026-01-27
+
+### Changed
+- **Enhanced interactivity detection in analyzePage** — Improved detection of JavaScript-enabled interactive elements
+  - Added detection of elements with `cursor: pointer` CSS property
+  - Added detection of elements with JavaScript `addEventListener('click')`
+  - Added detection of elements with `onclick` property set via JavaScript
+  - DIV and SPAN elements with click handlers now correctly detected as interactive
+  - Added `interactivityReason` metadata field showing why element was marked interactive
+  - Reasons: `native-html`, `aria-role`, `onclick-attr`, `onclick-prop`, `cursor-pointer`, `event-listener`, `tabindex`, `contenteditable`
+
+### Performance
+- Optimized `markInteractiveElements` to skip event listener checks during bulk scan (performance)
+- Event listener detection only runs for individual element type determination
+
 ## [3.1.7] - 2026-01-27
 
 ### Fixed