diff options
| author | Gabriel Schneider <[email protected]> | 2026-10-25 11:40:05 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-10-25 12:24:05 -0300 |
| commit | 685b4050bb0caaa95c4c6a209e69f7777469e9fc (patch) | |
| tree | b1c34301f9f1febd5e70dfdfee52425cdca0ef4a /docs/search-proto-converge.md | |
| parent | 29d753b420385d7ca214250909e3a33c85cfab8d (diff) | |
| download | pardes-685b4050bb0caaa95c4c6a209e69f7777469e9fc.tar.gz pardes-685b4050bb0caaa95c4c6a209e69f7777469e9fc.zip | |
query: a row is its place as text, `path:line:col` then its code, the path the shortest a Look from the query pane resolves (Query.lookPath: relative, `../` included, when shorter, else absolute, never `@pN` but for a text with no file), aligned per group, the declaration headers `path:line`; its code coloured as its file's language colours it, the file painted whole on the worker (Stream.paintRows, highlightApart, kept in the locations cache, Query.Shades a walk a refill, Query.recolor in place as each lands) with the match tinted over it; the +Preview's places are the query's hits in its file (a Grep searched, a list fed), tinted and ticked, the row's one current and selected, as in a pane that already shows it; tests for B3 on an address, a saved list's Looks, the shortest path, the preview's places and colours, the worker's colours; fsearch, grep, lookrange, lsp-client, lsprelpath (now `../shade.zig`), stepgrain, tagbottom goldens: the address rows; docs/next-searchrows.md: the design and the numbers
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_016u3hBPFfja5pK4EBRC1UVD
Diffstat (limited to 'docs/search-proto-converge.md')
| -rw-r--r-- | docs/search-proto-converge.md | 48 |
1 files changed, 38 insertions, 10 deletions
diff --git a/docs/search-proto-converge.md b/docs/search-proto-converge.md index 99adbc2c..7a3e361a 100644 --- a/docs/search-proto-converge.md +++ b/docs/search-proto-converge.md @@ -40,13 +40,40 @@ only the prompts that are not search. `Search <line 1>` is the builtin under the three argument paths (`config.leader_args`, pick's table). -**Rows look like Callstack's**: a gutter line number, the hit's line with -the match tinted (every match on a line tinted, one row a line), under the -declaration it is in (once a parse exists, see below), under the file -(Grep, the LSP lists), under `@pN name (count)` in serial order (All). -B3 on a row's line number looks at its address; B3 on its code is a word -Look as anywhere; B2 on line 1 runs it again. The pane has no gutter of its -own, and its rows are read-only while live (queryline's clampEdit). +**Rows look like Callstack's**: each row's place first, as text, +`path:line:col`, the path the shortest a Look from the query pane +resolves (relative to its directory, `../` included, when that is shorter, +else absolute; `Query.lookPath`), never an `@pN` but for a text with no +file, padded so a group's code starts in one column, then +the hit's line coloured as its file's language colours it, the match +tinted over that (every match on a line tinted, one row a line); under the +declaration it is in (once a parse exists, see below; the header has its +`path:line` too), under the file (Grep, the LSP lists), under `@pN name +(count)` in serial order (All). B3 on the address is a Look as anywhere, a +sweep copies it, and a frozen pane saved is a list of addresses that still +work; B3 on its code is a word Look; B2 on line 1 runs it again. The pane +has no gutter of its own, and its rows are read-only while live +(queryline's clampEdit). The address is on every row, `/`'s included: +a bare `:12:5` would be looked up in the +Search itself (a Look resolves +against the pane it is in), and a saved list would lose its file. + +The rows' colours are their files' whole (`Stream.paintRows`): a file is +painted once on the worker (`syntax.highlightApart`, the text of the pane +that shows it, else read there from disk), kept in the locations cache +beside Callstack's, and each row takes its line's slice when the line +still reads as the row does (`Query.Shades`, one walk down each file a +refill). Until then the rows are plain; when a file lands, every query +pane's plain rows from it are coloured in place (`Query.recolor`), which +asks for the next file, one at a time. Without workers (tests) the rows +stay plain. + +**The +Preview is the file as its own pane shows it**: its colours are +the file's (`colorAlgo` `.source`, painted ahead as any pane), and the +query's hits in it are its places (a Grep's searched there as in an open +pane, a list's fed from its rows), tinted and ticked, the current row's +one current and selected, centred with its neighbours round it. A pane +that already shows the file gets the same: its places, the row's one +selected. **Keys** on line 1, typing: Ctrl-n / Ctrl-p (and Down / Up, `config.query_next` / `query_prev`) step the current row; Enter lands; Esc cancels. Tab stays the @@ -197,9 +224,10 @@ of 100 (the Debug SafeAllocator's stack capture per allocation was 30% at - LookNext / LookPrev do not step query rows (their addresses are in row metadata, not text). -- Grep rows carry no syntax colours; `/` rows are coloured where the - owner's highlights cover them (zeros elsewhere, so no fragment parse per - refill). +- Rows of a file bigger than 4 MB, of markdown and typst (their + injections share parsers, so no worker paints them) stay plain; a disk + file changed after it was painted keeps plain rows for its changed + lines until the next Grep. - Rail ticks are not carried over the detached wire (a detached frontend shows tints, not ticks). - In a window too short for the group (4 rows), only the query pane's tag |
