# truce-core
Core traits and types for the truce audio plugin framework.
## Overview
This crate defines the fundamental abstractions that all truce crates build on.
Plugin authors should depend on the `truce` crate instead, which re-exports
everything from here. This crate is intended for internal use and for authors of
format wrappers or GUI backends.
## Key types and traits
- **`Plugin`** -- the wrapper-facing format-export trait. Plugin
authors don't implement this directly - the `truce::plugin!`
macro emits the impl. `Plugin::Sample` is the audio buffer's
element type (`f32` / `f64`).
- **`PluginExport`** -- wraps a `Plugin` for format-specific export
- **`AudioBuffer<'a, S>`** -- deinterleaved sample buffer, generic over
the plugin's sample type (defaults to `f32`)
- **`Editor`** / **`PluginContext<P>`** -- editor lifecycle and the
bridge handle the GUI uses to talk to the host
- **`ProcessContext` / `ProcessStatus`** -- audio callback context and return status
- **`Event` / `TransportInfo`** -- MIDI events and DAW transport state
- **`BusConfig` / `BusLayout`** -- I/O channel configuration
- **`PluginInfo` / `PluginCategory`** -- plugin metadata (name, ID, vendor, category)
- **`PluginContextReadF32` / `PluginContextReadF64`** -- extension
traits that route `state.get_param(...)` to the prelude's
chosen precision (mirror of `FloatParamReadF{32,64}` for the
audio thread)
## Utilities
- `db_to_linear` / `linear_to_db` -- gain conversion helpers (re-exported from `truce-params::sample::Float`)
- `midi_note_to_freq` -- MIDI note number to frequency in Hz
Part of [truce](https://github.com/truce-audio/truce).