#moondsp

#Quick start

NEW_MOON_MOD=0 moon check && NEW_MOON_MOD=0 moon test  # type-check + run tests
NEW_MOON_MOD=0 moon build --target wasm-gc            # build for browser
NEW_MOON_MOD=0 moon run cmd/main                       # run CLI entry point
scripts/build-clap-prototype.sh     # build Linux CLAP prototype shared object
scripts/smoke-clap-prototype.sh     # dlopen/process smoke test for the prototype
scripts/validate-clap-prototype.sh  # build + run clap-validator for the prototype

#What moondsp can do today

///|
fn[T : FilterSym] exit_deliverable() -> T {
  let lfo = DspSym::oscillator(ArithSym::constant(2.0), Waveform::Sine)
  let freq = range(lfo, 200.0, 400.0)
  let carrier = DspSym::oscillator(freq, Waveform::Sine)
  let filtered = T::biquad(carrier, BiquadMode::LowPass, 800.0, 1.0)
  DspSym::output(DspSym::gain(filtered, 0.3))
}

// C major triad played twice per cycle
sequence([note_name("c3"), note_name("e3"), note_name("g3")]).fast(Rational::from_int(2))

#How it works

Pattern Engine                    DSP Engine
  Pat.query(arc)                    CompiledDsp.process(ctx, buf)
       |                                  |
       v                                  v
  Array[Event[ControlMap]]         BoundVoicePool.process(ctx, L, R)
       |                                  ^
       +-- { note: 60, cutoff: 800 } -----+
           PatternScheduler.process_block

#Repository layout

./              Library public API facade (`moondsp.mbt` re-exports from dsp/, graph/, voice/, identity/)
dsp/            DSP primitives, tagless algebra, pan math
graph/          Compiled graph runtime, topology editing, hot-swap, control binding
voice/          Polyphonic voice pool with priority stealing
identity/       Stable ID wrappers and revision tokens for incremental editing
pattern/        Pattern engine: rational time, combinators, control maps, authoring docs
mini/           Mini-notation parser: text → Pat[ControlMap]
song/           Long-form section scaffold with identity TimeScope
scheduler/      Pattern scheduler: bridges pattern events to voice pool
browser/        AudioWorklet integration (wasm-gc/js exports)
browser_test/   Browser-integration test wrapper
clap_engine/    Native CLAP synth engine core (MoonBit host-facing wrapper)
clap_host/      Primitive handle bridge for the C CLAP shim
clap_plugin/    CLAP prototype payload package and C ABI shim
web/            Browser demo UI (HTML + AudioWorklet processor)
cmd/main/       CLI entry point
docs/           Architecture blueprint, technical reference, performance snapshots

#Performance

• filter + delay + ADSR) processes in the low-microsecond range, and 32 simultaneous FM voices comfortably fit inside the block. Compilation and hot-swap crossfades are also microsecond-scale, so graphs can be rebuilt or swapped between blocks without audible glitches.

#Development

NEW_MOON_MOD=0 moon check --target all --deny-warn  # type-check all targets, fail on warnings
NEW_MOON_MOD=0 moon test --target all --deny-warn   # run all tests on all targets
NEW_MOON_MOD=0 moon test -p dowdiness/moondsp       # root facade integration tests
NEW_MOON_MOD=0 moon test -p pattern                  # pattern-engine tests
NEW_MOON_MOD=0 moon info && NEW_MOON_MOD=0 moon fmt  # regenerate interfaces + format
NEW_MOON_MOD=0 moon bench --release -p dowdiness/moondsp/graph -f graph_benchmark.mbt
npm run test:browser  # Playwright browser-integration tests (builds wasm-gc first)

#Documentation

• Technical reference — node types, parameter slots, runtime control surface (authoritative for graph runtime-control behavior)
• Next actions — active handoff list for future sessions and API-hardening priorities
• Blueprint — full architecture vision, design principles, roadmap
• Performance snapshots — dated benchmark results (new measurements go in new files)
• Architecture decisions — short ADRs distilling why the codebase looks the way it does (each links to the archived plan/spec)
• CLAUDE.md — project map and conventions for contributors

#Project status

#License