csv.nx

csv.nx -- RFC 4180 comma-separated values parser. Companion to tsv.nx. CSV is messier than TSV because fields may be quoted, quotes inside quotes are doubled, and the line separator is CRLF per spec (most real-world files use plain LF -- we accept both). RFC 4180 grammar (simplified): file = header (CRLF record)* CRLF? header/rec = field (, field)* field = non_escaped | escaped non_escaped = TEXTDATA* escaped = DQUOTE (TEXTDATA | , | CR | LF | DQUOTE DQUOTE)* DQUOTE DQUOTE = 0x22 We emit a FIELD CALLBACK at each cell boundary and a ROW CALLBACK at each newline. This avoids allocating a 2D table and lets caller stream megabyte+ files. Invariants: CSV1 Quoted fields handle embedded commas + newlines. CSV2 Doubled quotes inside quoted fields ("") decode to one literal DQUOTE -- caller handles via the callback (we emit the raw quoted range; decoder below does the unescape). CSV3 Trailing CR before LF is stripped. CSV4 Empty file -> 0 rows, 0 cells.