Changelog

v0.5.0

Fixed:

• Coordinates are scaled from screenshot pixels into the driver's space, so click() and fill() land on the element on a HiDPI display instead of missing by the device pixel ratio. Also fixes Appium on iOS, where taps use points
• click() no longer fires every handler twice. It dispatched a synthetic click event and called native .click(), so one call double-submitted forms
• Removed the TM_CCORR_NORMED fallback in matching. It does not subtract the mean, so it scored 0.93-0.99 on almost any pair of images and returned confident coordinates for elements that were not on screen
• Solid-colour templates are rejected. The matching maths is 0/0 for these and OpenCV resolves that to a perfect score everywhere, so they matched at (0, 0) against anything
• swipe_app() works again. It was built on TouchAction, removed in Appium-Python-Client 3.0, so it returned False on every supported client. Rewritten on W3C Actions
• from pyxelator import swipe_app works. Its own docstring documented that import, but the function was never exported
• Appium failures report the cause instead of a bare False
• An undecodable screenshot returns None instead of crashing

New Features:

• Multi-scale matching - a template captured at one window size now matches from 0.66x to 1.54x, plus exact 0.5x/2.0x for a device pixel ratio change. Previously a 4% difference was enough to fail. Matches at the captured size short-circuit, so successful lookups cost nothing extra
• match_score() - reports how close a template came, for picking a confidence value instead of guessing
• Failure messages that diagnose - they report the actual score and tailor the advice to it, so a near miss and an absent element no longer get the same answer
• Match.scale reports which size a template matched at
• swipe_app() takes duration and debug, validates its direction, and clamps to the screen
• grayscale=False genuinely matches on colour; it previously converted to grayscale anyway, making the flag a no-op
• Unit test suite - 141 tests, no browser or device needed

Documentation:

• ERROR_HANDLING_GUIDE.md rewritten against the current messages, and now shipped with the package
• STRUCTURE.md rewritten; it described the layout from before the package split