Module status 

Device Status Reports and cursor-position reports.

Category

This module emits DSR requests and report responses: cursor position, extended cursor position, and light/dark preference reporting.

CSI conventions

ANSI DSR uses ESC [ Ps n; DEC-private DSR inserts ?. Cursor reports use final byte R, while light/dark reports use private DSR numbers.

Mode interaction

The light/dark notification request is related to Mode::LIGHT_DARK, DEC private mode 2031. Cursor-position reports are independent of modes but may be interpreted relative to terminal origin behavior.

Constants

REQUEST_CURSOR_POSITION

Request standard cursor position: exact bytes ESC [ 6 n (b"\x1b[6n").

REQUEST_EXTENDED_CURSOR_POSITION

Request extended cursor position: exact bytes ESC [ ? 6 n (b"\x1b[?6n").

REQUEST_LIGHT_DARK_REPORT

Request light/dark preference report: exact bytes ESC [ ? 996 n (b"\x1b[?996n").

Functions

write_cpr

Encode a standard Cursor Position Report response, ESC [ <line> ; <column> R.

write_decxcpr

Encode an extended Cursor Position Report response.

write_dsr_request

Encode a Device Status Report request.

write_light_dark_report

Encode a light/dark report response.

write_request_cursor_position

Write REQUEST_CURSOR_POSITION, the standard DSR 6 cursor-position request.

write_request_extended_cursor_position

Write REQUEST_EXTENDED_CURSOR_POSITION, the DEC private extended cursor-position request.

write_request_light_dark_report

Write REQUEST_LIGHT_DARK_REPORT, the light/dark preference query.