* feat(tutorials): in-depth Context Loop, Context Injector and Image Filter videos N05 walks the whole Context Loop (frames vs batch size vs Run count, Edit frame chips, Override Context seed, strategies, the seeds panel, Ctrl/Alt click, values, a rule on $iteration, Seed List, Hold, Bypass loop). N04 takes the Context Injector apart and N12 the Image Filter (labels, prompt edits with clip, the mask painter, Compare, Zoom, Send to Loop, the node's settings). The old Nodes videos move to their new numbers (Debug N03, Label & Grid N13, Note N14, Bookmark N15); N12 replaces the old N01. * fix(tutorials): tick both rows in T03's bulk edit The selection bar slides in after the first tick and moves the rows, so the second click could land where its row used to be. Tick one row at a time and check each one took. * fix(tutorials): scroll T05's rules into view before boxing them scrollTo now falls back to scrolling the part's own scrolling box when the wheel doesn't move it, and T05 scrolls each branch (and the second action) to the upper screen before its callout, so the boxes are on screen. * fix(tutorials): narrate T06's canvas build so it plays at normal speed The two builds had no line, so the render squeezed them to 4.5x and the hand looked rushed. A line over each keeps them at normal speed. * fix(tutorials): a hand at work plays at most 2x in the render The Tutor now records when the hand clicks, drags, types or presses a key (cues.json acts), and render.mjs speeds a silent stretch with hand work up by at most 2x instead of up to 8x, so builds don't look rushed. The ten longest silent builds (T04, A04, A05, A06, A09, A10, A12, L03 and two in N14) get a line, so they play at normal speed. * fix(tutorials): give N04's Injector room beside the stand-in nodes The Injector landed on the first text box and covered its output, so the first wire never connected. The stand-ins sit further right, the Injector further right still, and the canvas slides left before the Context step. * fix(tutorials): keep both ends of N12's new wires on screen The mask wire was dragged from the filter to a node that had scrolled off the top, so it dropped on empty canvas. The canvas now fits the nodes of each wire into the free part of the screen first, and the new Set Latent Noise Mask goes under the refine sampler. * fix(tutorials): N05 and N04 fixes from the first takes N05: zoom in on the Seed List while it's talked about (it sat under the caption), and drop the callout labels that covered the frame chips and the template. N04: narrate the Context / Assembler / preview build (36 s of silence) and move the hand off the rows so the globe tooltip closes. * fix(tutorials): paint N12's mask on the painter's canvas In paint mode the mask painter replaces the detail image, so the strokes aimed at an image that was no longer there. * fix(tutorials): a single click doesn't hold a long wait at 2x A Run click followed by a long wait counted as hand work, so the wait played at 2x instead of being squeezed. A stretch now needs two or more hand actions to be capped. * fix(tutorials): tuck N12's picker away with its minus button Escape in Detail goes back to the grid instead of tucking the picker away, so the waiting pill never showed. * fix(tutorials): box N12's two extra slots as a pair The callout took one locator matching both slot dots, which strict mode refuses. * fix(image-filter): keep the picker's keys after a view change Switching mode or leaving the painter removed the focused control and dropped focus to body, so the picker's keys went to the canvas bookmarks. Focus goes back to the picker. N12 hands the keys back before Compare and Zoom. * fix(tutorials): L05 waits for Role's save to store a history entry * fix(tutorials): a few clicks across a long wait don't cap the squeeze * fix(tutorials): review 2026-11-11 first half (lines over empty canvas, late boxes, N12 framing) * fix(tutorials): review 2026-11-11 A09-A19 findings * fix(tutorials): review 2026-11-11 L03, L05, N14, E4 findings; jumpTo keeps tall notes above the caption * fix(tutorials): A06 and T05 build their Context before the line * fix(tutorials): N14 keeps the label's peek open through its line * fix(tutorials): N12 boxes the extra slot rows; callouts fall back to the raw box * fix(tutorials): N14 hovers the label before its line * fix(tutorials): N14 keeps the hover card up while its line plays
101 lines
4.7 KiB
TypeScript
101 lines
4.7 KiB
TypeScript
// Nodes 3: WP Debug in depth. Role, Setting, Time of day, Lighting from time and the constraint "Role
|
|
// fits the place" (last, so it reaches nothing) → WP Debug. Variables (value, who set it, filter),
|
|
// Trace (steps in order, a derivation's rules opened), Warnings (the constraint that never applied),
|
|
// Raw, and Copy.
|
|
import { tutorial } from "../tutorial.js";
|
|
|
|
tutorial(
|
|
"N03",
|
|
{
|
|
title: "WP Debug in depth",
|
|
description: "Read everything a run did: each variable and who set it, every step in order with its rules, and the warnings that explain an odd result.",
|
|
learn: "Variables, Trace, Warnings and Raw, the filter, opening a step, copying a run.",
|
|
},
|
|
async (t) => {
|
|
|
|
const dbg = await t.h.step("Debug after a Context", async () => {
|
|
await t.go("/");
|
|
// Build first (sped up), then name what's on screen.
|
|
await t.speedUp();
|
|
const ctx = await t.addNode("WP Context", { x: 480, y: 170 });
|
|
await t.pickModules(ctx, ["Role", "Setting", "Time of day", "Lighting from time", "Role fits the place"]);
|
|
await t.normalSpeed();
|
|
await t.say("A Context with Role, Setting, Time of day, Lighting from time, and the constraint Role fits the place, put last on purpose.");
|
|
await t.waitVoice();
|
|
await t.say("Wire WP Debug after it. It changes nothing; it shows what reached that point.");
|
|
const dbg = await t.addNode("WP Debug", { x: 1300, y: 170 });
|
|
await t.page.evaluate((id) => {
|
|
const n = window.app?.graph?.getNodeById(Number(id)) as { size: [number, number] } | null | undefined;
|
|
if (n) n.size = [680, 640];
|
|
window.app?.canvas?.setDirty(true, true);
|
|
}, dbg);
|
|
await t.beat(400);
|
|
await t.wire(ctx, "context", dbg, "context");
|
|
await t.waitVoice();
|
|
await t.say("Run.");
|
|
await t.run();
|
|
await t.beat(1200);
|
|
await t.waitVoice();
|
|
return dbg;
|
|
});
|
|
|
|
const view = () => t.node(dbg);
|
|
|
|
await t.h.step("Variables", async () => {
|
|
await t.callout("vars", view().locator('[data-test="dbg-vars"]'), "Name, value, who set it", 6);
|
|
await t.say("Variables lists every variable the run set, its value, and the item that set it.");
|
|
await t.waitVoice();
|
|
await t.uncallout("vars");
|
|
await t.say("The filter finds one by name. Type light.");
|
|
await t.fill(view().locator('[data-test="dbg-filter"] input, input[data-test="dbg-filter"]').first(), "light", { cps: 12 });
|
|
await t.beat(1200);
|
|
await t.waitVoice();
|
|
await t.fill(view().locator('[data-test="dbg-filter"] input, input[data-test="dbg-filter"]').first(), "", { cps: 12 });
|
|
await t.beat(500);
|
|
});
|
|
|
|
await t.h.step("Trace", async () => {
|
|
await t.say("Trace is the run in order: each item, what it did, and why.");
|
|
await t.click(view().locator('[data-test="dbg-tab-trace"]'));
|
|
await t.beat(800);
|
|
const lighting = view().locator('[data-test="dbg-step"]', { hasText: "Lighting" }).first();
|
|
await t.say("Open Lighting from time. Its rules show which one matched the time that was rolled.");
|
|
await t.click(lighting.locator(".wp-dbg-step__row"));
|
|
await t.beat(1000);
|
|
await t.callout("rule", lighting.locator('[data-test="dbg-step-detail"]'), "The rule that matched", 6);
|
|
await t.waitVoice();
|
|
await t.uncallout("rule");
|
|
await t.click(lighting.locator(".wp-dbg-step__row"));
|
|
await t.beat(500);
|
|
});
|
|
|
|
await t.h.step("Warnings", async () => {
|
|
await t.say("Warnings explains a result that looks wrong.");
|
|
await t.click(view().locator('[data-test="dbg-tab-warnings"]'));
|
|
await t.beat(900);
|
|
await t.callout("warn", view().locator('[data-test="dbg-warning"]').first(), "Never applied", 6);
|
|
await t.say("Role fits the place sits after the Setting it should change, so the setting had already rolled: it never applied. A constraint goes before the items it changes.");
|
|
await t.waitVoice();
|
|
await t.uncallout("warn");
|
|
});
|
|
|
|
await t.h.step("Raw and copy", async () => {
|
|
await t.click(view().locator('[data-test="dbg-tab-raw"]'));
|
|
await t.beat(700);
|
|
await t.say("Raw is the whole run as data.");
|
|
await t.waitVoice();
|
|
await t.callout("copy", view().locator('[data-test="dbg-copy"]'), "Copy this tab", 4);
|
|
await t.say("Copy puts the open tab on the clipboard as JSON, handy for a bug report.");
|
|
await t.waitVoice();
|
|
await t.beat(500);
|
|
await t.uncallout("copy");
|
|
await t.click(view().locator('[data-test="dbg-tab-vars"]'));
|
|
await t.beat(500);
|
|
});
|
|
|
|
await t.h.step("Outro", async () => {
|
|
await t.say("Put Debug after any Context to see what it rolled, how, and what went wrong. Use as many as you like.");
|
|
});
|
|
},
|
|
);
|