Module text_selection 

Native-grade text selection primitives for BasicTextField.

This module holds the pure, unit-tested building blocks the text field uses to offer Android/iOS-style selection: tap-count classification, word and line/paragraph boundary detection, and the geometry of the draggable teardrop selection handles (their shapes, their hit regions, and the selection math that a handle drag produces).

Keeping these as free functions makes the touch behavior testable without a renderer and keeps TextFieldModifierNode focused on wiring.

Enums

HandleKind

Which selection handle a teardrop represents.

TapCount

How many consecutive taps a press represents, mirroring the platform text selection gestures: one tap places the cursor, two select the word, three select the line/paragraph.

Constants

HANDLE_GRAB_SLOP

Finger-sized grab slop (px) added around a handle’s drawn teardrop to enlarge its touch target, matching Android’s generous handle hit area. A bare teardrop (~2·HANDLE_RADIUS across) is far smaller than a fingertip, so a touch-DOWN aimed at a handle routinely lands a few px off it; without this slop the press falls through to the field below and places a caret, which collapses the selection. The slop is applied to the sides and BELOW the tip (where the bulb and the grabbing finger sit) but never ABOVE the tip — see crate::widgets::selection_handle, which keeps the box off the glyph line so a double-tap still reaches the field to escalate into a word selection.

HANDLE_RADIUS

Radius of a selection/cursor handle bulb in px (Android uses ~11dp).

MULTI_TAP_SLOP_PX

Maximum distance (px) between consecutive taps that still counts as a multi-tap. A tap that lands far from the previous one starts a fresh single tap even if it arrives quickly, matching Android’s ViewConfiguration double-tap slop behavior.

MULTI_TAP_TIMEOUT_MS

Maximum time between taps that still counts as a multi-tap, in milliseconds.

Functions

classify_tap

Classifies a press into a tap count from the previous tap’s count, the time since it, and the distance from it.

find_line_boundaries

Returns the byte range [start, end) of the line/paragraph containing pos, delimited by \n (the newline itself is excluded from the range).

handle_path_data

SVG path data for a handle teardrop whose tip sits at (tip_x, tip_y).

selection_after_handle_drag

Computes the selection (min, max) that results from dragging one handle to a new text offset, keeping the opposite (fixed) edge anchored.