Module status 

Device Status Reports and cursor-position reports.

Category

This module emits DSR requests and report responses: cursor position, extended cursor position, light/dark preference, and terminal visibility reporting. It also carries DECRQSS and its DECRPSS response, which ask after a current setting rather than device status.

CSI conventions

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

Mode interaction

The light/dark notification request is related to Mode::LIGHT_DARK, DEC private mode 2031, and the visibility request to Mode::VISIBILITY_REPORTS, DEC private mode 2033. Both queries report once without changing their mode. 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").

REQUEST_VISIBILITY_REPORT

Request a terminal visibility report: exact bytes ESC [ ? 998 n (b"\x1b[?998n").

Functions

write_cpr

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

write_decrpss

Encode a DECRPSS report, ESC P <ps> $ r <D...D> ESC \.

write_decrqss

Request a current setting with DECRQSS, ESC P $ q <selector> ESC \.

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.

write_request_visibility_report

Write REQUEST_VISIBILITY_REPORT, the one-shot terminal visibility query.

write_visibility_report

Encode a terminal visibility report response.