{"version":"2.1.277","anchor":"fine-pointer-trackpad-precision-mouse-events-added-to-term","canonical_anchor":"fine-pointer-trackpad-precision-mouse-events-added-to-term","heading":"Terminal supports pixel-precision (fine) mouse tracking via SGR-Pixels mode","tier":"notice","area":"Terminal Rendering","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.277\/e\/fine-pointer-trackpad-precision-mouse-events-added-to-term","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.277","markdown":"### Terminal supports pixel-precision (fine) mouse tracking via SGR-Pixels mode\n\nClaude Code's terminal UI can now detect and use pixel-precision mouse coordinates (SGR-Pixels mode 1016) instead of only character-cell precision\n\n**Unclear.** What behavior actually differs between fine and coarse pointer input is not stated in the finding.\n\n**What**\n\n- Pointer handling for press, drag, release, and hover throughout the terminal renderer now threads a `fine` boolean alongside button\/column\/row, to distinguish precise trackpad input from coarse mouse clicks, along with a raw fractional position on mouse events.\n\n- The terminal capability prober now sends a DECRQM query for mode 1016 (SGR-pixel mouse coordinates) plus a cell-size query, so Claude Code can detect whether the terminal supports pixel-level mouse reporting.\n\n- New machinery, including `retainFinePointer`\/`cancelFinePointerSettle` hold-counting, `syncMousePixels`, and `mouseReportsInPixels`, turns the terminal's `mousePixels` mode on and off as needed, with a \"fine pointer settle\" timer managed on mount and unmount.\n\n- New helpers translate mouse column\/row into pixel-precise coordinates when supported, and the `mousePixels` mode is reasserted on redraw alongside the existing `extendedKeys` and mouse modes.\n\n- New regexes and a `MOUSE_SGR_PIXELS` constant parse the SGR-Pixels escape sequences and convert pixel offsets into row\/column plus the `fine` payload.\n\n**Why**\n\nOn terminals that support it, this lets interactive elements in Claude Code respond to precise trackpad or mouse positioning rather than only whole character cells, enabling finer-grained interactions.\n\n- Area: Terminal Rendering\n- Tier: You'll notice\n- Useful: 3\/5\n- Signal: 2\/5"}