Files
neovim/runtime/doc
Justin M. Keyes 47cd769ed5 feat(cmdatom): mappings capture continuation
Problem:
A mapping that ends mid-operation (`nnoremap ,D d`) emits a content-free
"mapping" atom plus a `pending` field, and the "continuation" motion
arrives as a sibling atom. Consumers must stitch the two together (which
has broken cases, e.g. Insert-opening mappings (",i") lose their session
entirely).

- ",i": the session atom is dropped bc the mapping RHS is consumed
  before the session starts (typebuf_maplen()==0), so
  atom_is_user_input()=false.
- ":normal"-in-opfunc: the opfunc internal "v..y" session (a) became
  kVatomTyped just because the deferred composite was open, masking the
  real operator capture via atom_captures, and (b) its nested frames
  re-derived the outer redo.
- "Motion" based on `moved=true`, has false negatives.
- `CmdAtom.remap` is unnecessary, and clutters the docs/usage.

Solution:
- Introduce `frame_id` to identify CmdFrames.
- Classify `type=motion` better, via `NV_MOTION` flag on the `nv_cmds` table.
- Drop `CmdAtom.pending`, `CmdAtom.remap`.
- Defer atom_composite_end() at the clock edge while an operator is
  pending, Visual is active, or `restart_edit` is set: the composite
  keeps collecting, so the continuation is captured in the mapping atom.
- ",i": Now an open composite counts as user input.
- ":normal"-in-opfunc: Now handled correctly.
- `remap` is now decided by `composite.payload || 0 subatoms`.
  atom_payload_mark() records the read the resolution never captures.
- `toplevel` is now decided by `CmdFrame.parent == NULL`.

before/after:

    INPUT       BEFORE                             AFTER
    ---------------------------------------------------------------------
    ,D w        {mapping lhs=,D pending=operator}  {operator lhs=,Dw keys=dw}
                + {operator keys=dw}
    ysiw"       {mapping lhs=ys pending=operator}  {operator lhs=ysiw" keys=g@iw"}
                + {operator lhs=g@iw"}
    ,v d        {mapping pending=visual}           {visual lhs=,vd keys=viwd}
                + {visual lhs=viwd}
    ,i XY<Esc>  {normal keys=i lhs=,iXY<Esc>}      {insert keys=1iXY<Esc> text=XY}
2026-08-22 17:29:34 +02:00
..
2026-06-29 23:22:52 +02:00
2026-02-12 13:46:45 +01:00
2024-05-15 23:19:26 +02:00
2026-06-29 13:10:31 -04:00
2026-08-01 17:48:32 -04:00
2026-08-01 17:48:32 -04:00
2025-12-06 20:33:02 -05:00
2023-06-25 17:14:28 +02:00
2026-04-18 15:38:59 -04:00
2026-01-27 17:14:57 -05:00
2026-08-04 20:48:44 +02:00
2026-08-14 09:30:31 -04:00
2025-12-15 13:55:15 -05:00
2026-03-16 10:29:58 +01:00
2025-09-28 20:57:59 -07:00
2026-08-06 10:27:29 +02:00
2026-05-07 10:36:55 +02:00
2026-05-14 13:13:30 -04:00
2025-12-15 13:55:15 -05:00
2026-04-22 18:25:07 -04:00
2026-05-17 10:02:12 -04:00
2026-08-06 10:27:29 +02:00
2026-03-24 00:14:55 +01:00
2026-05-07 10:36:48 +02:00
2026-07-25 12:47:51 -04:00
2026-08-06 10:27:29 +02:00
2026-08-14 09:30:31 -04:00
2026-07-30 15:09:19 -04:00