[foxnne]

Part of fizzyedit/plans#30. Merge after #621 and #626: this branch is built on both and on main (which has #623 and #624), and until they land its diff shows their commits too. Its own change is src/editor/demos/tour.zig, catalog.zig and docs/AUTOMATION.md.

What changes

The tour was the explorer, typing, the palette and a markdown preview, with long holds (8.5 s on the first card). It now covers what a person needs to get around, and what fizzy's windowing does, in 58 seconds:

Chapter	At	What it shows
Welcome	0:00	a short title card, no hold
Tabs	0:03	a tab dragged into order, another dropped on the editor's edge: a pane beside
Places	0:10	a place's corner button, its picker, and Split
Floats	0:18	the Files view dropped on its own place's middle: a float, carried by its header over the code
Materials	0:25	Liquid Glass, frost, blur, clear and opaque under that float (fizzy.windowMaterial, #621), then closing the float sends the view home
Plugins	0:38	the store: everything seen so far is a plugin
History	0:42	typing, the grip at the page's foot filling toward the history's cap (#624), and the bar it opens
Your turn	0:54	where to find it again: Guides on the rail

Each chapter that rearranges the window opens on a keyframe. A snapshot holds documents and settings but not the layout, so a seek or a jump from the guides view lands on a cut rather than on a window still arranged the later way. The catalog names the anchors the tour aims at (place, corner, cornerButton, historyGrip, historyLine). docs/AUTOMATION.md lists the ones its table lacked: history.grip:, history.export:, history.collapse:, float-header:, float-close: and picker.empty.

The history chapter shows the bar and how to scrub it, but doesn't scrub. A snapshot puts a document's text back but not its history, so a seek replaying a scrub lands on other text.

What making it found, each its own PR:

• settings: the window's material is a setting #621: the window's material had no setting.
• app: a demo sets the person's panes aside #623: a demo left its panes behind, and wrote them over the person's panes.zon.
• replay: a seek back to a keyframe checks no snapshot of the scene before #626: the player checked the previous chapter's snapshot on a rewind.
• app: the history grip fills toward the history's cap #624: the grip's fill now measures the history cap, per review.

SDK impact

• None of its own. settings: the window's material is a setting #621 and app: a demo sets the person's panes aside #623 have none either; replay: a seek back to a keyframe checks no snapshot of the scene before #626 changes no shape.

Verified

• Web, in the browser pane: played start to finish on ?demo=tour. Every chapter landed: the drags, picker, float, material switches, store and history bar.
• macOS, zig build test-integration (81/81 steps):
  • tests/demos.zig plays the tour to its end with no timeouts and seeks to random moments and every chapter, landing on what playing reached with no mismatches;
  • the headless tour test passes, as do app: a demo sets the person's panes aside #623's panes check and app: a demo gives back a folder opened from a zip's bytes #596's zip check after it.
• zig build, zig build check-web, zig build check-tests-reached, scripts/check-fmt.sh.
• Windows:
• Linux:

Follow-ups

• A pause before the tour clicks the history grip broke seeks there (the line never drew on replay). Something in the grip's rest timing doesn't follow demo time. The tour clicks it without the pause.
• On the web, the float's view covers most of its glass, so the material change shows mainly in its header and edges. A sparser view floated would show it better.
• Hosted guides (step 3) and ?view=guides (step 4) are next.

🤖 Generated with Claude Code

[foxnne]

Rebased onto main after #621/#626/#639/#640 landed; the stacked commits are gone, leaving this PR's three files (docs/AUTOMATION.md, catalog.zig, tour.zig). The old merge's tests/demos.zig changes were only conflict resolutions, so main's version stands.

Review fixes: Materials sets Liquid Glass before its caption says so, and the doc comment says about a minute.

Left for a follow-up: a demo snapshot holds no layout, so a scrub back inside Places/Floats/Materials can replay a split or float onto a window already rearranged (the keyframes cover chapter starts only); and the corner button is aimed at by pixel inset because Region.cornerButton marks no anchor.