docs(plan): add Phase 12 Mix Visualizer Lava Reframe spec; supersede Phase 10 effects/controls

This commit is contained in:
daniel-c-harvey
2026-06-16 10:33:24 -04:00
parent 96b13af95d
commit 74b9c02722
3 changed files with 695 additions and 0 deletions
@@ -214,6 +214,17 @@ contract on both sides).
## 4. The four visual effects
> **SUPERSEDED (2026-06-16) by `product-notes/phase-12-mix-visualizer-lava-reframe.md`.** Daniel tested
> the landed effects end-to-end and rejected the visual result — the lava read as "giant disconnected
> circles," the color drifted to cyan (an HSL saturation-boost artifact), and the waveform and lava read
> as two unrelated things. The reframe replaces this entire effects layer: the per-bar bulge + detach
> blobs become a **CPU-physics wax-blob lava with real 2D collision** (the waveform pushes the fluid out
> of its way), the HSL navy↔moss treatment becomes a **three-color OKLab gradient with three combined
> motions**, the separate "glass" effect folds into the blob shading, and the static noise/frost layer is
> **removed**. The renderer *infrastructure* (pipeline, datum texture, playhead interp, bridge) is reused;
> the *art* below is replaced. See the new spec §3–§6. The four-effect text below is retained as the
> record of what the rejected Wave 3 shipped.
Described as **intended look + shader-side approach in conceptual terms**. The exact GLSL is
staff-engineer's. Each effect is a continuous function of its control value, so the whole range from
"off" to "maxed" is reachable by dragging one slider.
@@ -422,6 +433,16 @@ hand).
## 7. Wave 4 — Detail-page polish + controls rework (presentation only)
> **PARTIALLY SUPERSEDED (2026-06-16) by `product-notes/phase-12-mix-visualizer-lava-reframe.md`.**
> **Kept:** the lava-lamp icon-button trigger top-right of the body across from the back link (§7c, §7f
> — `DDIcons.LavaLamp`, landed) and the widened Mix body (`MudContainer MaxWidth="Large"`, §7g, landed).
> **Superseded:** the four-knob **popover** becomes a six-knob **flyout** (the reframe adds two controls —
> lava gravity, blob density/size, collision strength — and drops/recasts others: resolution/zoom is
> removed in favor of scroll speed; bubblyness/detach are replaced by the physical lava model), and the
> popover primitive is reconsidered (`MudDrawer` vs. popover-as-flyout — see the new spec §7b). See the
> new spec §7 for the six controls, the flyout survey, and the NowPlaying-hero aesthetic target. The §7
> text below is retained as the record of what the four-knob popover shipped.
Status: **design-complete, implementation-ready.** Added 2026-06-15. **Depends on Wave 3 being merged**
(the knobs in this wave drive the four effects that Wave 3 makes real). **This wave supersedes the §3
always-visible controls-row design** — the row moves into a popover and the four MudSliders become four