Showcase Library

vivid-wavetable uses a curated preset library instead of carrying every expansion experiment forward.

The current production wavetable path is WavetableLayer / LayerPad. WavetableOsc remains in the library for advanced legacy interaction and feedback-style warp patches.

The family map below covers the retained self-playing showcase library. The browseable MIDI instrument layer is listed separately under Instrument Library.

The goal of this set is simple:

• every retained graph has a clear role
• every major retained engine capability is audible in at least one hero patch
• every important feature also has a simpler reference patch nearby

Family Map

Pads and Beds

• Hero: moving_vocal_pad.json
• Reference: warm_dual_pad.json
• Also retained: ambient_air_bed.json, cinematic_haze_bed.json, rooted_sub_pad.json, supersaw_fabric_pad.json

Keys and Brass

• Hero: fm_glass_keys.json
• Reference: airy_keys.json
• Also retained: aurora_hybrid_keys.json, dream_keys.json, halo_hybrid_brass.json, low_brass_pad.json

Plucks and Bells

• Hero: noisy_pluck.json
• Reference: mirror_bells.json
• Also retained: animated_neon_pluck.json, metallic_pluck.json, resin_mallet.json

Leads

• Hero: controlled_metallic_lead.json
• Reference: analog_stack_lead.json
• Also retained: supersaw_lead.json, sync_sweep_lead.json

Basses

• Hero: growl_crossmod_bass.json
• Reference: rooted_sub_bass.json
• Also retained: driven_hybrid_bass.json, sub_bass.json

Textures and Drones

• Hero: spectral_interaction_texture.json
• Reference: single_osc_motion_reference.json
• Also retained: orbit_drone.json, texture_tide_bed.json

Arp and Sequence

• Hero: hybrid_motion_arp.json
• Reference: crystal_pattern_arp.json

Cinematic Hybrids

• Hero: cinematic_haze_bed.json
• Reference: ambient_air_bed.json
• Also retained: formant_choir.json

DualFilter Recipe Anchors

The April 4 Pass 2 adoption establishes DualFilter as the package's advanced tone-shaping primitive. These graphs serve as the canonical filter recipe anchors:

• Warm body: warm_dual_pad.json, dual_wavetable_pad_module_demo.json
• Bright keys / brass contour: airy_keys.json, halo_hybrid_brass.json, hybrid_keys_module_demo.json
• Bass bite: driven_hybrid_bass.json
• Vocal / formant-adjacent: moving_vocal_pad.json, formant_choir.json

Performance Anchors

The package performance-surface convention is anchored by these module demos and expressive examples:

• Motion headline: dual_wavetable_pad_module_demo.json
• Brightness + body headline: hybrid_keys_module_demo.json
• Air headline: sub_air_pad_module_demo.json
• Interaction headline: glass_interaction_keys_module_demo.json
• Expressive play: expressive_glass_keys.json (scalar pressure/slide control)

Those role labels are the live-control vocabulary. The shipped module param names stay on their stable compatibility surface, including filter_cutoff, drive, air_level, filter_tone, motion_amount, and interaction_depth.

Feature Coverage

Baseline, Leveling, Unison

• Hero: supersaw_fabric_pad.json
• Reference: warm_dual_pad.json

Wavetable Families, Motion, and DualFilter

• Hero: moving_vocal_pad.json
• Reference: single_osc_motion_reference.json
• DualFilter anchors: warm_dual_pad.json, airy_keys.json, halo_hybrid_brass.json, driven_hybrid_bass.json, formant_choir.json

Character Layers and Per-Voice Reduction

• Hero: driven_hybrid_bass.json
• Reference: airy_keys.json

Advanced Legacy Interaction

• Hero: spectral_interaction_texture.json
• Reference: fm_glass_keys.json
• Additional keepers: controlled_metallic_lead.json, growl_crossmod_bass.json, hybrid_motion_arp.json

Retained Preset Set

The final retained preset library is:

• airy_keys.json
• ambient_air_bed.json
• analog_stack_lead.json
• animated_neon_pluck.json
• aurora_hybrid_keys.json
• cinematic_haze_bed.json
• controlled_metallic_lead.json
• crystal_pattern_arp.json
• dream_keys.json
• driven_hybrid_bass.json
• fm_glass_keys.json
• formant_choir.json
• growl_crossmod_bass.json
• halo_hybrid_brass.json
• hybrid_motion_arp.json
• low_brass_pad.json
• metallic_pluck.json
• mirror_bells.json
• moving_vocal_pad.json
• noisy_pluck.json
• orbit_drone.json
• resin_mallet.json
• rooted_sub_bass.json
• rooted_sub_pad.json
• single_osc_motion_reference.json
• spectral_interaction_texture.json
• sub_bass.json
• supersaw_fabric_pad.json
• supersaw_lead.json
• sync_sweep_lead.json
• texture_tide_bed.json
• warm_dual_pad.json

Everything else in the old expansion library was retired because it was redundant, weaker than a nearby patch, or no longer necessary after the engine work settled.

Instrument Library

WavetableLayer / LayerPad is the canonical production wavetable path for the browseable instrument library. Instrument graphs use MidiInput, carry content_kind: instrument metadata, and are intended as the "play this instrument" layer.

Keys

• Reference: hybrid_keys_instrument.json — Layer-based wavetable + analog keys
• Advanced legacy: glass_interaction_instrument.json — interactive glass keys with pressure mapping and WavetableOsc interaction

Pads

• Hero: layer_pad_instrument.json — canonical WavetableLayer pad with motion and unison
• Reference: dual_wavetable_pad_instrument.json — Layer-based dual-wavetable pad with shared motion
• Reference: sub_air_pad_instrument.json — Layer-based wavetable + sub + air pad

Bass

• Hero: rooted_sub_bass_instrument.json — grounded sub-layered bass

Pluck

• Hero: bright_pluck_instrument.json — crisp bell-adjacent pluck with a short spatial tail

Lead

• Hero: metallic_hollow_lead_instrument.json — focused metallic lead with controlled edge

Texture

• Utility: motion_texture_instrument.json — LFO-driven motion texture bed