From 05ea338255e6c2d26416ac8de99f0e2c905ace1a Mon Sep 17 00:00:00 2001 From: Vance Ingalls Date: Sun, 9 Aug 2026 20:08:01 -0700 Subject: [PATCH] docs(design): bring the family lettering back into the schematic MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The first rack pass carried module identity in per-family type — filters as tracked-out caps, dynamics heavy and tight, nonlinear an italic serif, time light and airy, smart monospace. Moving to the schematic direction lost it: everything ended up lettered in the same condensed caps, with family shown only by the node ring. It is back, inside the schematic skeleton rather than instead of it, so the drawing still carries order and routing while the type carries kind. You can tell what sort of module you are looking at with the label out of focus. Two faces, as budgeted. The condensed sans separates four families by weight, case, tracking and size; the serif is spent on the one family that is generative rather than corrective, because it is the one that behaves differently. Adds a tint step per module WITHIN its family, derived from position in the registry so adding an effect never re-colours its siblings by hand. Seventeen distinct module hues across the rack, and two filters read as different modules without reading as different families. The Broadcast preset is the test: seven nodes across three families in one rack, each identifiable before it is read. Co-Authored-By: Claude Opus 5 (1M context) --- plans/audio-fx-ux/README.md | 28 +++++++++++++ plans/audio-fx-ux/build-preview.mts | 65 +++++++++++++++++++++++++---- 2 files changed, 85 insertions(+), 8 deletions(-) diff --git a/plans/audio-fx-ux/README.md b/plans/audio-fx-ux/README.md index 1c5c0e6d7a..90335f3c09 100644 --- a/plans/audio-fx-ux/README.md +++ b/plans/audio-fx-ux/README.md @@ -46,6 +46,34 @@ So one plain name per *effect* is not enough: a preset's node needs its own preset node as well as on the effect. This is invisible in a catalogue of cards and obvious the moment every preset is drawn as the chain it actually builds. +## Family lettering, carried over from the first round + +The identity device from the first rack pass — different type per family — was +lost when the direction moved to schematic, which lettered everything in the +same condensed caps. It is back, inside the schematic skeleton rather than +instead of it. You can tell what KIND of module you are looking at with the +label out of focus, before the word registers. + +| Family | Treatment | Why | +| --- | --- | --- | +| Filter | condensed caps, wide tracking, light | measuring instruments | +| Dynamics | condensed caps, tight, heavy | grips the signal | +| Nonlinear | **italic serif** | the only generative family — it should not look like the others | +| Time | condensed caps, very wide, thin | atmosphere, not control | +| Smart | monospace, medium | it measures; it reads as a readout | + +Two faces, as budgeted. The condensed sans carries four families apart by +weight, case, tracking and size; the serif is spent on the single family that +behaves differently from the rest. + +Alongside it, a **tint step per module inside its family** — derived from +position in the registry, so adding an effect never re-colours its siblings by +hand. Two filters are visibly different modules without reading as two +different families. + +The `Broadcast` preset is the test case: seven nodes across three families in +one rack, and each one is identifiable before it is read. + ## The collapsed state is a sentence Collapsed is the most-seen state by a distance: a rack of six modules is six diff --git a/plans/audio-fx-ux/build-preview.mts b/plans/audio-fx-ux/build-preview.mts index 4f0e912953..163f8fde8b 100644 --- a/plans/audio-fx-ux/build-preview.mts +++ b/plans/audio-fx-ux/build-preview.mts @@ -33,6 +33,26 @@ const esc = (s: string) => s.replace(/&/g, "&").replace(/ = { filter: "var(--f-filter)", dynamics: "var(--f-dyn)", nonlinear: "var(--f-non)", time: "var(--f-time)", }; +/** + * A tint STEP per module inside its family — so two filters are visibly + * different modules without reading as two different families. Derived from + * position in the registry, so adding an effect never re-colours its siblings + * by hand. + */ +const FAMILY_BASE: Record = { + filter: [72, 0.15, 240], dynamics: [82, 0.14, 72], nonlinear: [70, 0.17, 26], time: [73, 0.15, 305], +}; +function moduleHue(id: string): string { + const def = getAudioFxDef(id); + if (!def) return "var(--f-filter)"; + const family = HF_AUDIO_FX.filter((d) => d.group === def.group); + const i = family.findIndex((d) => d.id === id); + const [l, c, h] = FAMILY_BASE[def.group] ?? FAMILY_BASE.filter!; + const span = Math.max(1, family.length - 1); + const t = i / span; + // Walk lightness and hue a little, keep chroma — the family stays obvious. + return `oklch(${(l - 6 + t * 12).toFixed(1)}% ${c} ${(h - 14 + t * 28).toFixed(0)})`; +} const PRESET_FAMILY_LABEL: Record = { voice: "Voice", repair: "Fix", character: "Character", space: "Space", }; @@ -52,7 +72,7 @@ const ruler = BANDS.map((b) => { /* ---- one module, in both faces ------------------------------------------ */ function moduleCard(def: (typeof HF_AUDIO_FX)[number]) { const c = EFFECT_COPY[def.id]!; - const hue = FAMILY_HUE[def.group] ?? "var(--f-filter)"; + const hue = moduleHue(def.id); const defaults = defaultAudioFxParams(def.id); const profile = PROFILES[def.id]; @@ -84,7 +104,7 @@ function moduleCard(def: (typeof HF_AUDIO_FX)[number]) { return `
-
+
${esc(c.title)}${esc(def.label)}
@@ -126,7 +146,7 @@ type StateOpts = { function stateSpecimen(effectId: string, params: Record, o: StateOpts) { const def = getAudioFxDef(effectId)!; const c = EFFECT_COPY[effectId]!; - const hue = o.smart ? "var(--mark)" : FAMILY_HUE[def.group] ?? "var(--f-filter)"; + const hue = o.smart ? "var(--mark)" : moduleHue(effectId); const profile = PROFILES[effectId]; const primaryLabel = c.primary === "strength" ? (profile?.label ?? "Amount") : (c.params[c.primary]?.label ?? c.primary); const summary = SUMMARY[effectId] ? SUMMARY[effectId]!(params) : ""; @@ -151,7 +171,7 @@ function stateSpecimen(effectId: string, params: Record, o: Sta ${rows}` : `
${esc(summary)}
`; - const body = `
+ const body = `
03
${esc(c.title)} @@ -195,7 +215,7 @@ function presetCard(p: (typeof HF_AUDIO_FX_PRESETS)[number]) { const nodes = p.nodes .map((n, i) => { const def = getAudioFxDef(n.type); - const hue = FAMILY_HUE[def?.group ?? "filter"]; + const hue = moduleHue(n.type); const c = EFFECT_COPY[n.type]!; // The one value that says what this stage is doing, in its own units — // the plain name carries the meaning, the number keeps it honest. @@ -206,7 +226,7 @@ function presetCard(p: (typeof HF_AUDIO_FX_PRESETS)[number]) { const pd = def?.params.find((x) => x.key === k); return `${v}${pd && "unit" in pd && pd.unit ? " " + pd.unit : ""}`; })[0] ?? ""; - return `
+ return `
${String(i + 1).padStart(2, "0")}
${esc(c.title)}${esc(shown)}
`; @@ -317,8 +337,37 @@ const html = `FX rack — the casual author's view border-radius:50%; background:oklch(12% .004 265); font-family:Monaco,monospace; font-size:9px; color:var(--h); display:grid; place-items:center; z-index:1; } .nmrow { display:flex; align-items:baseline; gap:7px; } - .nm { font-family:"DIN Alternate","Oswald",sans-serif; font-size:13px; text-transform:uppercase; - letter-spacing:.13em; color:oklch(92% .006 250); } + .nm { font-size:13px; color:oklch(92% .006 250); } + + /* ---- family lettering ------------------------------------------------ + The identity device from the first round, brought into the schematic. You + can tell what KIND of module you are looking at with the label out of + focus, before the word registers. + + Two faces, as budgeted: a condensed sans carries four families apart by + weight, case, tracking and size; a serif is spent on the one family that + is generative rather than corrective, because it is the one that behaves + differently. */ + .fam-filter .nm { + font-family:"DIN Alternate","Oswald",sans-serif; text-transform:uppercase; + letter-spacing:.18em; font-size:12px; font-weight:400; + } + .fam-dynamics .nm { + font-family:"DIN Alternate","Oswald",sans-serif; text-transform:uppercase; + letter-spacing:.04em; font-size:14px; font-weight:700; + } + .fam-nonlinear .nm { + font-family:"Superclarendon",Georgia,serif; font-style:italic; font-weight:700; + font-size:14.5px; letter-spacing:-.005em; text-transform:none; + } + .fam-time .nm { + font-family:"DIN Alternate","Oswald",sans-serif; text-transform:uppercase; + letter-spacing:.24em; font-size:12px; font-weight:300; opacity:.94; + } + .fam-smart .nm { + font-family:Monaco,ui-monospace,monospace; text-transform:uppercase; + letter-spacing:.05em; font-size:11.5px; font-weight:600; + } .tag { margin-left:auto; font-family:Monaco,monospace; font-size:8.5px; color:oklch(56% .012 250); white-space:nowrap; font-variant-numeric:tabular-nums; }