docs(design): bring the family lettering back into the schematic

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) <noreply@anthropic.com>
This commit is contained in:
Vance Ingalls
2026-08-09 20:08:01 -07:00
co-authored by Claude Opus 5
parent 2757b08ce2
commit 05ea338255
2 changed files with 85 additions and 8 deletions
+28
View File
@@ -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
+57 -8
View File
@@ -33,6 +33,26 @@ const esc = (s: string) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replac
const FAMILY_HUE: Record<string, string> = {
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<string, [number, number, number]> = {
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<string, string> = {
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 `<figure class="specimen">
<div class="rack" style="--h:${hue}">
<div class="flow">
<div class="node">
<div class="node fam-${def.group}">
<span class="n"></span>
<div class="nmrow"><span class="nm">${esc(c.title)}</span><span class="tag">${esc(def.label)}</span></div>
<div class="knob-row">
@@ -126,7 +146,7 @@ type StateOpts = {
function stateSpecimen(effectId: string, params: Record<string, unknown>, 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<string, unknown>, o: Sta
${rows}`
: `<div class="says">${esc(summary)}</div>`;
const body = `<div class="node${o.bypass ? " bypass" : ""}${o.smart ? " smart" : ""}" style="--h:${hue}">
const body = `<div class="node fam-${o.smart ? "smart" : def.group}${o.bypass ? " bypass" : ""}${o.smart ? " smart" : ""}" style="--h:${hue}">
<span class="n">03</span>
<div class="nmrow">
<span class="nm">${esc(c.title)}</span>
@@ -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 `<div class="node" style="--h:${hue}">
return `<div class="node fam-${def?.group ?? "filter"}" style="--h:${hue}">
<span class="n">${String(i + 1).padStart(2, "0")}</span>
<div class="nmrow"><span class="nm">${esc(c.title)}</span><span class="tag">${esc(shown)}</span></div>
</div>`;
@@ -317,8 +337,37 @@ const html = `<title>FX rack — the casual author's view</title>
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; }