Skip to content

recording: node-editor tutorial sweep (cont.) — delete_and_select + context_menus + clipboard#27

Merged
borisbat merged 3 commits into
masterfrom
bbatkin/node-editor-tutorial-sweep-2
Jun 4, 2026
Merged

recording: node-editor tutorial sweep (cont.) — delete_and_select + context_menus + clipboard#27
borisbat merged 3 commits into
masterfrom
bbatkin/node-editor-tutorial-sweep-2

Conversation

@borisbat

@borisbat borisbat commented Jun 4, 2026

Copy link
Copy Markdown
Owner

Continues the node-editor tutorial recording sweep started in #26 (first_graph / connect_by_drag / create_by_drag, merged). Same bar: voiced (terse ASCII caption decoupled from natural voice), self-verifying (every interaction asserted via record_check_rendered / record_check_value; a no-op aborts the recording at teardown), with the flow() data-flow pulse as the "highlight" device.

Landing one tutorial at a time, each eyeball-approved before commit.

Included

  1. delete_and_select — an A→B→C chain; pulses both links to show it is live, then a real synthetic click MUST select B and a real Delete key MUST remove B and cascade both links on its pins (record_check_value(selected=true) + record_check_rendered(false) on the node and both links). Replaces the legacy zero-verification driver.
  2. context_menus — pulses the A→B link, then each synthetic right-click MUST open the matching menu; the node menu's Delete node MUST remove A + cascade its link, and the background menu's Node MUST spawn a node at the click point. Replaces the soft "the menu pick did not land" fallback.
  3. clipboard — clicks a node (which selects it and focuses the canvas the shortcuts need), then fires real Ctrl+D / Ctrl+C / Ctrl+V chords partway into each voice line. The imgui_key_hud keycap + modifier strip is overlaid, so each chord is visible on screen as the voice names it. record_check_value(selected) + record_check_rendered on the duplicate and the pasted node assert the edits land. Replaces the legacy zero-verification driver.

(Remaining for a later PR: groups, styling, navigation.)

Per-tutorial cleanups

  • Captions decoupled from voice (terse ASCII on screen, natural spoken line drives TTS + dwell).
  • Dropped manual set_user_control toggles (with_node_editor_recording_app owns it) and stray print() debug lines.
  • Each tutorial RST gains a recording note.

Notes

ne_flow (the flow_cmd rail used here) already landed on master in #26. The keycap HUD's per-action keycap_fade_s (so the action key lingers through its voice line) and the letter-keycode glyph mapping ride dasImgui borisbat/dasImgui#161 — but clipboard is CI-independent of it: the driver passes keycap_fade_s in a JV (from_JV ignores unknown fields on older dasImgui) and the committed .mp4 was recorded with the fixed dasImgui, so it already shows the lingering [Ctrl][D]/[Ctrl][C]/[Ctrl][V] keycaps. The .apng / wavs / manifest / sidecar are gitignored intermediates; only the .mp4 is tracked.

🤖 Generated with Claude Code

borisbat and others added 2 commits June 3, 2026 23:16
…in flow pulse

Fourth tutorial of the node-editor recording sweep. The legacy driver narrated
with single-string say()s, toggled set_user_control by hand, printed debug lines,
and ended on a soft if/else fallback ("the delete did not land"). Now:

- Voiced - 4 beats (chain / live pulse / select / delete-cascade), terse ASCII
  captions decoupled from natural voice lines, paced by the wavs.
- Self-verifying - the click MUST select B (record_check_value selected=true) and
  the Delete key MUST remove B AND cascade both links on its pins
  (record_check_rendered=false on node_2, link_100, link_101), or the recording
  aborts at teardown. dropped=0, ok=true.
- Highlight device - pulses both links with flow() to show the chain is live
  before it is cut, on top of the editor's native selection highlight.

Dropped the manual set_user_control (with_node_editor_recording_app owns it) and
the stray prints; switched to ne_open. delete_and_select.rst gains the recording note.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…ow pulse

Fifth tutorial of the node-editor recording sweep. The legacy driver narrated
with single-string say()s, toggled set_user_control by hand, printed four debug
lines, and ended on a soft if/else fallback ("the menu pick did not land"). Now:

- Voiced - 5 beats (live link / node menu / delete-cascade / background menu /
  create), terse ASCII captions decoupled from natural voice lines, paced by the
  wavs.
- Self-verifying - each right-click MUST open the matching menu (DEL_ITEM /
  ADD_ITEM rendered), the node-menu pick MUST delete A AND cascade link_100
  (both absent), and the background pick MUST spawn node_200 (rendered), or the
  recording aborts at teardown. dropped=0, ok=true.
- Highlight device - opening flow pulse on the A->B link, so the node-menu delete
  reads as cutting a live connection (same begin_delete path the delete tutorial
  uses).

Dropped the manual set_user_control (with_node_editor_recording_app owns it) and
the stray prints; switched to ne_open. context_menus.rst gains the recording note.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR continues the node-editor tutorial recording sweep by upgrading the delete_and_select and context_menus recording drivers (and their tutorial docs) to the same voiced + self-verifying standard established in #26, using flow() pulses as a visual “live connection” highlight.

Changes:

  • Reworks record_delete_and_select.das to assert selection and deletion outcomes via record_check_value / record_check_rendered, and adds link “live” pulses before cutting the chain.
  • Reworks record_context_menus.das to assert the correct context menus open, and that delete/create actions have the required effects, with a prelude flow() pulse.
  • Adds “recording is voiced and self-verifying” notes to the corresponding tutorial .rst pages.

Reviewed changes

Copilot reviewed 4 out of 6 changed files in this pull request and generated 2 comments.

File Description
tests/integration/record_delete_and_select.das Updates the delete+select recording driver to be voiced and assertion-based, with link pulses.
tests/integration/record_context_menus.das Updates the context menu recording driver to be voiced and assertion-based, with a link pulse prelude.
doc/source/tutorials/delete_and_select.rst Documents the new voiced/self-verifying recording behavior for the tutorial video.
doc/source/tutorials/context_menus.rst Documents the new voiced/self-verifying recording behavior for the tutorial video.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +46 to +49
// ---- Beat 1: the chain ----
record_check_rendered(app, T_B, true)
say(app, "A -> B -> C: two links", T_B,
[voice = "Here is a tiny chain - node A to B to C, joined by two links."])
Comment on lines +56 to +59
// ---- Beat 1: the live link ----
record_check_rendered(app, T_A, true)
let dwell = say_begin(app, "A -> B: a live link", T_A,
[voice = "A and B share a live link - we can pulse it to see data flow before we touch the menus."])
Click selects + focuses the canvas; real Ctrl+D / Ctrl+C / Ctrl+V chords fire
partway into each voice line. imgui_key_hud overlays the keycap + modifier strip
(keycap_fade_s=2.5 so the action key lingers through its line), so every chord is
visible on screen as the voice names it. record_check_value(selected) plus
record_check_rendered on the duplicate and the pasted node assert the edits land,
or the recording aborts at teardown. RST gains a note that the recording app owns
set_user_control(false) for the whole run and overlays the HUD.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@borisbat borisbat changed the title recording: node-editor tutorial sweep (cont.) — delete_and_select + context_menus recording: node-editor tutorial sweep (cont.) — delete_and_select + context_menus + clipboard Jun 4, 2026
@borisbat borisbat requested a review from Copilot June 4, 2026 07:45

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 6 out of 9 changed files in this pull request and generated 2 comments.

Comment on lines +46 to +49
// ---- Beat 1: the chain ----
record_check_rendered(app, T_B, true)
say(app, "A -> B -> C: two links", T_B,
[voice = "Here is a tiny chain - node A to B to C, joined by two links."])
Comment on lines +56 to +59
// ---- Beat 1: the live link ----
record_check_rendered(app, T_A, true)
let dwell = say_begin(app, "A -> B: a live link", T_A,
[voice = "A and B share a live link - we can pulse it to see data flow before we touch the menus."])
@borisbat borisbat merged commit 59bd1a3 into master Jun 4, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants