summaryrefslogtreecommitdiff
path: root/docs/typ/building.typ
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-17 07:33:32 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:01 -0300
commitdee94c740bdaea61ff35b4e0a7f1d2815c9ee441 (patch)
tree4ee6c15976e44cec22deeebbc79176688beb9d49 /docs/typ/building.typ
parentb954bf23cf3137bb7fa731ab3a9dbe388a485166 (diff)
downloadpardes-dee94c740bdaea61ff35b4e0a7f1d2815c9ee441.tar.gz
pardes-dee94c740bdaea61ff35b4e0a7f1d2815c9ee441.zip
+85 -24 docs: the library's tree handed in and its replace, as built (docs/next-editor.md): `key(a, syn, k)`, `run(a, syn, act)` and `replace(a, from, to, with, join)` among the calls; the tree handed in, its shape and why (an argument the call's context carries, `normal.nodeTree` the one seam), which walks run in the library and what comes back without one; the hxlib counts, 538 of 658 and 618 of 738, the walks' one case compared; Left out keeps tree indents and says where Alt-o's history lives; the recipe gains "hear this subexpression" (Alt-o and Alt-i on a module's `Syntax`, the primary range read back) and "drag a number" (the number node under the pointer rewritten every frame, the drag one step to undo); building.typ's table and the changelog say so; hxlib 538 / --parity 618, core-test 811 of 950, shell-test 990 of 993, hxdiff 658 / parity 738 / hxgolf 124 with 0 mismatches, replicas pass, lib-test pass, the book compiles
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'docs/typ/building.typ')
-rw-r--r--docs/typ/building.typ4
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/typ/building.typ b/docs/typ/building.typ
index f5afda19..17b18f35 100644
--- a/docs/typ/building.typ
+++ b/docs/typ/building.typ
@@ -143,9 +143,9 @@ own normal.zig and edit.zig, and says what came of the key.
#pairs(
[`key`, `run`], [a key as a pane in normal or insert mode takes it, or an action the caller built: `done`, `pending` (a count or a prefix awaits the next), `unbound`, `action` (bound but the caller's: a view, `:`, `/`, `s`, a language server, a macro), or `refused` (what it made does not fit; the value is as it was)],
- [`selectRegex`, `setText`, `setRegister`], [what a caller does with `s` once it has a pattern, a whole new text as one step to undo, the clipboard into `+`],
+ [`selectRegex`, `setText`, `replace`, `setRegister`], [what a caller does with `s` once it has a pattern, a whole new text as one step to undo, a byte range rewritten as one (or `join`ed to the step before: a drag's frames one undo), the clipboard into `+`],
[`read`, `bytes`, `ranges`, `mode`, `pending`, `register`], [the text, the ranges in document order and the primary, normal, insert or select],
- [`Language`, `Syntax`], [a grammar handed in at run time (its `TSLanguage` and query sources, told by an extension), and a text's parse and colours made again when it changes; drop it at a reload],
+ [`Language`, `Syntax`], [a grammar handed in at run time (its `TSLanguage` and query sources, told by an extension), and a text's parse and colours made again when it changes; drop it at a reload. Handed to `key` and `run`, the tree-sitter walks (Alt-o and kin, `]f`, `mif`) run on it; without one they are the caller's],
)
`zig build hxlib` runs helix's cases on it against the goldens, and