Files
hyperframes/packages
Vance Ingalls 42c64819de feat(studio): make the rack speak the author's language
Wires `audioFxCopy` into the panel, to the three decisions recorded in
`plans/audio-fx-ux/README.md` §Decided.

**The plain name replaces the DSP name, which moves inside.** A module
reads "Remove Rumble" with "Cutting everything below 80 Hz" under it, and
opening it shows "Details — High-pass" above the knobs. Every knob is
renamed too — `plainDef` writes the copy over the registry's labels and
hints while leaving range, step, unit and automatability alone, because
those are facts and only the words were ever the problem. A preset's own
job name still wins where it has one: it is the most specific truth
available.

**Presets read as the complaint they answer.** "My voice sounds boomy",
with `Boom Tame` underneath in small type — which is also how the name
gets learned. The four shelves stay: eighteen sentences in a column is a
wall, and Voice/Fix/Character/Space is already the author's grouping
rather than the registry's. The effect list is untouched and stays in
signal order, per the same decision.

**Everything auditions on hover, and on focus — the keyboard reaches it
too.** Hovering a preset or an offered effect plays it through the same
preview channel a slider drag already uses, so it costs no new machinery
and never touches the document. Three things this has to get right, each
with a test that fails without it:

- Leaving puts the stored chain back — captured when the audition starts,
  because the preview channel does not persist and the prop never changes.
- Applying does NOT put it back. The audition *was* the preset, and
  reverting over the write that just landed is a race the author hears as
  it arriving and then leaving again.
- The panel going away mid-audition reverts too. Deselecting a clip is
  not a decision, and a preview left playing is audible, absent from the
  document, and gone on the next reload.

Tone does not audition: its bands arrive at 0 dB, so there is nothing to
hear, and a hover that changes nothing teaches that hovering does nothing.

**Even Out Levels auditions by measuring first**, which is the expensive
answer of the three — it decodes the track and analyses it before there
is anything to play. So it says "measuring…" while it works, the decode
is cached per `src` (a hover that re-fetched a several-minute voiceover
would be slower than the thing it previews), and a run counter drops any
result that arrives after the pointer has left. Reverting puts both the
chain and the automation back, because levelling is a node AND the lane
that drives it — restoring only the chain leaves an envelope writing to a
gain stage that is no longer there.

Tests that addressed rows by their registry labels now look them up
through `EFFECT_COPY`, and the preset buttons by preset id. Those tests
are about which row carries the automate button, not about how it reads,
and hard-coding the words would make every copy edit a test edit.

Falsified: dropping the phase of each of the three audition invariants
fails its own test, and removing the stale-run guard fails the levelling
one.

studio 3683 passing, 18 todo (was 3674); section file 510 lines, under the
600 cap.
2026-08-10 15:38:58 -07:00
..
2026-08-03 22:48:00 -07:00
2026-08-03 22:48:00 -07:00
2026-08-03 22:48:00 -07:00
2026-08-03 22:48:00 -07:00
2026-08-03 22:48:00 -07:00
2026-08-03 22:48:00 -07:00