capability_tables.hpp

Go to the documentation of this file.

// Generated by core/interchange/tools/capability_emit.py -- do not edit.
// Source of truth: core/interchange/capabilities/*.json
#pragma once
 
#include <pulp/interchange/concept.hpp>
 
#include <cstddef>
#include <cstdint>
#include <string_view>
 
namespace pulp::interchange {

enum class ImportLevel : std::uint8_t {
    None = 0,
    PreserveOpaque = 1,
    Partial = 2,
    Full = 3,
};

enum class ExportLevel : std::uint8_t {
    Drop = 0,
    RoundtripOnly = 1,
    Degrade = 2,
    Full = 3,
};

enum class LossClass : std::uint8_t {
    Dropped = 0,
    Degraded = 1,
    Flattened = 2,
    Approximated = 3,
};

enum class Format : std::uint8_t {
    DawProject = 0,
    Smf = 1,
};
 
inline constexpr std::size_t kFormatCount = 2;
 
struct ImportRow {
    ImportLevel level;
    std::string_view notes;
    std::string_view refusal;
};
 
struct ExportRow {
    ExportLevel level;
    Concept degrade_to;
    LossClass loss_class;
    std::string_view loss;
};
 
namespace detail {
struct FormatRecord {
    std::string_view id;
    std::string_view display_name;
    bool has_writer;
};
 
inline constexpr FormatRecord kFormatRecords[kFormatCount] = {
    {"dawproject", "DAWproject", true},
    {"smf", "Standard MIDI File", true},
};
 
inline constexpr ImportRow kImportRows[kFormatCount][kConceptCount] = {
    // dawproject
    {
        {ImportLevel::None, "", ""}, // unknown
        {ImportLevel::Full, "", ""}, // track.flat
        {ImportLevel::None, "", "nested group tracks"}, // track.group
        {ImportLevel::None, "", ""}, // track.video
        {ImportLevel::Full, "", ""}, // clip.musical
        {ImportLevel::None, "", "seconds-timed lanes, clips, and notes"}, // clip.absolute
        {ImportLevel::Full, "", ""}, // clip.note
        {ImportLevel::Full, "", ""}, // clip.media
        {ImportLevel::None, "", "per-clip gain"}, // clip.gain
        {ImportLevel::None, "", "per-clip fades"}, // clip.fades
        {ImportLevel::None, "", ""}, // clip.crossfade
        {ImportLevel::None, "", "warped clip content"}, // clip.warp
        {ImportLevel::None, "", "scenes and clip-launcher content"}, // clip.launch
        {ImportLevel::None, "", ""}, // gap.explicit
        {ImportLevel::Full, "", ""}, // tempo.single
        {ImportLevel::None, "", "tempo changing after bar 1"}, // tempo.map
        {ImportLevel::Full, "", ""}, // meter.single
        {ImportLevel::None, "", "time signature changing after bar 1"}, // meter.map
        {ImportLevel::None, "", "arrangement markers"}, // marker
        {ImportLevel::None, "", ""}, // timecode.origin
        {ImportLevel::None, "", ""}, // media.provenance
        {ImportLevel::None, "", "channel volume"}, // mixer.track-gain
        {ImportLevel::None, "", "channel pan"}, // mixer.track-pan
        {ImportLevel::None, "", ""}, // mixer.sends
        {ImportLevel::None, "", "automation lanes"}, // automation.device-param
        {ImportLevel::None, "", "volume automation lanes"}, // automation.track-gain
        {ImportLevel::None, "", "pan automation lanes"}, // automation.track-pan
        {ImportLevel::None, "", "device chains"}, // device.placement
        {ImportLevel::None, "", "plugin state"}, // device.payload
        {ImportLevel::None, "", ""}, // effect.timewarp
        {ImportLevel::None, "", ""}, // take.lane
        {ImportLevel::None, "", ""}, // take.comp
        {ImportLevel::None, "", ""}, // track.freeze
        {ImportLevel::Full, "", ""}, // asset.sealed-hash
        {ImportLevel::None, "", ""}, // asset.embedded-media
        {ImportLevel::Full, "package-relative locator retained verbatim; identity sealed to the resolved bytes", ""}, // asset.referenced-media
        {ImportLevel::None, "", ""}, // sequence.multiple
        {ImportLevel::None, "", ""}, // sequence.nested
        {ImportLevel::None, "", ""}, // content.registered
        {ImportLevel::None, "", ""}, // content.opaque
        {ImportLevel::None, "", ""}, // edit-rate.non-audio
        {ImportLevel::None, "", "chord and scale context lanes"}, // context.chord-scale
        {ImportLevel::None, "", "groove templates and swing"}, // context.groove
        {ImportLevel::None, "", "per-note probability, conditions, and ratchets"}, // clip.note-modifier
        {ImportLevel::Full, "", ""}, // clip.empty
        {ImportLevel::None, "", ""}, // tempo.ramp
        {ImportLevel::None, "", ""}, // clip.note-velocity-quantized
        {ImportLevel::None, "", ""}, // tempo.value-quantized
        {ImportLevel::None, "", ""}, // clip.media-window
        {ImportLevel::None, "", ""}, // clip.fade-shape
        {ImportLevel::None, "", "per-clip controller and expression streams"}, // clip.midi-expression-lane
        {ImportLevel::None, "", ""}, // sequence.section-role
        {ImportLevel::None, "", ""}, // context.chord-bass
        {ImportLevel::None, "", ""}, // context.chord-extension
        {ImportLevel::None, "", ""}, // context.chord-voicing
        {ImportLevel::None, "", ""}, // tuning.project
        {ImportLevel::None, "", ""}, // tuning.instrument
        {ImportLevel::None, "", ""}, // modulation.modulator
        {ImportLevel::None, "", ""}, // modulation.macro
        {ImportLevel::None, "", ""}, // modulation.route-device-param
        {ImportLevel::None, "", ""}, // modulation.route-track-mixer
    },
    // smf
    {
        {ImportLevel::None, "", ""}, // unknown
        {ImportLevel::Full, "", ""}, // track.flat
        {ImportLevel::None, "", ""}, // track.group
        {ImportLevel::None, "", ""}, // track.video
        {ImportLevel::Partial, "positions are exact when the file division divides the canonical tick grid; otherwise import reports bounded nearest-tick rounding", ""}, // clip.musical
        {ImportLevel::None, "", "sample-anchored clips"}, // clip.absolute
        {ImportLevel::Full, "", ""}, // clip.note
        {ImportLevel::None, "", "media clips"}, // clip.media
        {ImportLevel::None, "", ""}, // clip.gain
        {ImportLevel::None, "", ""}, // clip.fades
        {ImportLevel::None, "", ""}, // clip.crossfade
        {ImportLevel::None, "", ""}, // clip.warp
        {ImportLevel::None, "", ""}, // clip.launch
        {ImportLevel::None, "", ""}, // gap.explicit
        {ImportLevel::Partial, "tempo periods are represented as integer microseconds and may round on import", ""}, // tempo.single
        {ImportLevel::Partial, "tempo positions may use bounded nearest-tick rounding on non-dividing file grids, and periods are integer microseconds", ""}, // tempo.map
        {ImportLevel::Partial, "meter positions may use bounded nearest-tick rounding on non-dividing file grids", ""}, // meter.single
        {ImportLevel::Partial, "time-signature changes are admitted only when they land on canonical bar boundaries", ""}, // meter.map
        {ImportLevel::None, "", "arrangement markers"}, // marker
        {ImportLevel::None, "", ""}, // timecode.origin
        {ImportLevel::None, "", ""}, // media.provenance
        {ImportLevel::None, "", ""}, // mixer.track-gain
        {ImportLevel::None, "", ""}, // mixer.track-pan
        {ImportLevel::None, "", ""}, // mixer.sends
        {ImportLevel::None, "", "automation lanes"}, // automation.device-param
        {ImportLevel::None, "", ""}, // automation.track-gain
        {ImportLevel::None, "", ""}, // automation.track-pan
        {ImportLevel::None, "", "device chains"}, // device.placement
        {ImportLevel::None, "", ""}, // device.payload
        {ImportLevel::None, "", ""}, // effect.timewarp
        {ImportLevel::None, "", "takes and comp lanes"}, // take.lane
        {ImportLevel::None, "", ""}, // take.comp
        {ImportLevel::None, "", ""}, // track.freeze
        {ImportLevel::None, "", ""}, // asset.sealed-hash
        {ImportLevel::None, "", ""}, // asset.embedded-media
        {ImportLevel::None, "", ""}, // asset.referenced-media
        {ImportLevel::None, "", ""}, // sequence.multiple
        {ImportLevel::None, "", ""}, // sequence.nested
        {ImportLevel::None, "", ""}, // content.registered
        {ImportLevel::None, "", ""}, // content.opaque
        {ImportLevel::None, "", ""}, // edit-rate.non-audio
        {ImportLevel::None, "", ""}, // context.chord-scale
        {ImportLevel::None, "", ""}, // context.groove
        {ImportLevel::None, "", "per-note probability, conditions, and ratchets"}, // clip.note-modifier
        {ImportLevel::None, "", "empty positioned clips"}, // clip.empty
        {ImportLevel::None, "", "continuous tempo ramps"}, // tempo.ramp
        {ImportLevel::None, "", ""}, // clip.note-velocity-quantized
        {ImportLevel::None, "", ""}, // tempo.value-quantized
        {ImportLevel::None, "", ""}, // clip.media-window
        {ImportLevel::None, "", ""}, // clip.fade-shape
        {ImportLevel::None, "", "per-clip controller and expression streams"}, // clip.midi-expression-lane
        {ImportLevel::None, "", ""}, // sequence.section-role
        {ImportLevel::None, "", ""}, // context.chord-bass
        {ImportLevel::None, "", ""}, // context.chord-extension
        {ImportLevel::None, "", ""}, // context.chord-voicing
        {ImportLevel::None, "", ""}, // tuning.project
        {ImportLevel::None, "", ""}, // tuning.instrument
        {ImportLevel::None, "", ""}, // modulation.modulator
        {ImportLevel::None, "", ""}, // modulation.macro
        {ImportLevel::None, "", ""}, // modulation.route-device-param
        {ImportLevel::None, "", ""}, // modulation.route-track-mixer
    },
};
 
inline constexpr ExportRow kExportRows[kFormatCount][kConceptCount] = {
    // dawproject
    {
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for unknown"}, // unknown
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // track.flat
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for track.group"}, // track.group
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for track.video"}, // track.video
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // clip.musical
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer cannot place sample-anchored clips on its beats-only lane, so the clip and its content are omitted"}, // clip.absolute
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // clip.note
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // clip.media
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not emit a clip gain, so an authored clip gain is dropped and the clip exports at unity"}, // clip.gain
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not emit clip fades, so authored fade-in and fade-out durations are dropped and the clip exports with hard edges"}, // clip.fades
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for clip.crossfade"}, // clip.crossfade
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for clip.warp"}, // clip.warp
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for clip.launch"}, // clip.launch
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for gap.explicit"}, // gap.explicit
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // tempo.single
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for tempo.map"}, // tempo.map
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // meter.single
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for meter.map"}, // meter.map
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not emit markers or regions, so every named point and range on the timeline is dropped"}, // marker
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not emit a session timecode origin, so the exported document starts at zero and every timecode reference shifts"}, // timecode.origin
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for media.provenance"}, // media.provenance
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not emit a channel volume, so an authored track gain is dropped and the track exports at unity"}, // mixer.track-gain
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not emit a channel pan, so an authored track pan is dropped and the track exports centred"}, // mixer.track-pan
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for mixer.sends"}, // mixer.sends
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "device identity does not survive without a device payload, so its automation has no target"}, // automation.device-param
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "a volume automation lane has no export target while channel volume itself is dropped"}, // automation.track-gain
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "a pan automation lane has no export target while channel pan itself is dropped"}, // automation.track-pan
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "devices are identity-only in the document; DAWproject requires a device type to place one"}, // device.placement
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for device.payload"}, // device.payload
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for effect.timewarp"}, // effect.timewarp
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not inspect take lanes, so alternate takes are omitted"}, // take.lane
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not flatten comp selections, so comp segment choices are omitted"}, // take.comp
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject has no freeze concept; the authored track is exported and the sealed render is dropped"}, // track.freeze
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // asset.sealed-hash
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer does not emit embedded media bytes, so an embedded asset is omitted"}, // asset.embedded-media
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // asset.referenced-media
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "only the root sequence is written; other sequences are dropped"}, // sequence.multiple
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for sequence.nested"}, // sequence.nested
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer cannot preserve registered extension payloads, so the clip content is omitted"}, // content.registered
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer cannot preserve opaque extension payloads, so the clip content is omitted"}, // content.opaque
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for edit-rate.non-audio"}, // edit-rate.non-audio
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for context.chord-scale"}, // context.chord-scale
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for context.groove"}, // context.groove
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject notes carry no probability, pass condition, or ratchet; the notes are written and play unconditionally once"}, // clip.note-modifier
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // clip.empty
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer emits only its first constant tempo, so continuous tempo curves are dropped with the rest of the tempo map"}, // tempo.ramp
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // clip.note-velocity-quantized
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // tempo.value-quantized
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer references the complete media asset, so a nonzero source start or partial frame count is dropped"}, // clip.media-window
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer emits no fade at all, so a non-linear fade curve goes with the fade it shaped"}, // clip.fade-shape
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the writer emits clip notes without their controller streams, so authored control change, pitch bend, pressure, program change, and parameter movement are omitted"}, // clip.midi-expression-lane
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject arrangement markers carry a name and span but no typed structural role"}, // sequence.section-role
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the DAWproject chord representation carries quality and root but no bass"}, // context.chord-bass
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the DAWproject chord representation carries no added scale degrees"}, // context.chord-extension
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the DAWproject chord representation carries no voicing hint"}, // context.chord-voicing
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject has no document-wide tuning statement"}, // tuning.project
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject has no per-instrument tuning statement"}, // tuning.instrument
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for modulation.modulator"}, // modulation.modulator
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for modulation.macro"}, // modulation.macro
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for modulation.route-device-param"}, // modulation.route-device-param
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "DAWproject declares no support for modulation.route-track-mixer"}, // modulation.route-track-mixer
    },
    // smf
    {
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for unknown"}, // unknown
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // track.flat
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for track.group"}, // track.group
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for track.video"}, // track.video
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // clip.musical
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "sample-anchored clips cannot be placed on the Standard MIDI File tick grid, so the clip and its content are omitted"}, // clip.absolute
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // clip.note
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files carry MIDI events rather than audio media, so media clips are omitted"}, // clip.media
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files have no per-clip gain, so authored clip gain is omitted"}, // clip.gain
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files have no per-clip fades, so authored fade-in and fade-out durations are omitted"}, // clip.fades
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for clip.crossfade"}, // clip.crossfade
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for clip.warp"}, // clip.warp
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files describe a linear arrangement, so launcher scenes are omitted"}, // clip.launch
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for gap.explicit"}, // gap.explicit
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // tempo.single
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // tempo.map
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // meter.single
        {ExportLevel::Full, Concept::Unknown, LossClass::Dropped, ""}, // meter.map
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not emit marker meta-events, so markers and regions are omitted"}, // marker
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not emit a session timecode origin, so the document opens at zero"}, // timecode.origin
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for media.provenance"}, // media.provenance
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not lower authored track gain to MIDI controller events"}, // mixer.track-gain
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not lower authored track pan to MIDI controller events"}, // mixer.track-pan
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for mixer.sends"}, // mixer.sends
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not lower device automation to MIDI controller events"}, // automation.device-param
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not lower track-gain automation to MIDI controller events"}, // automation.track-gain
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not lower track-pan automation to MIDI controller events"}, // automation.track-pan
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "device chains have no Standard MIDI File representation and are omitted"}, // device.placement
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for device.payload"}, // device.payload
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for effect.timewarp"}, // effect.timewarp
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "takes and comp lanes have no Standard MIDI File representation and are omitted"}, // take.lane
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "take comp selections have no Standard MIDI File representation and are omitted"}, // take.comp
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "frozen audio renders have no Standard MIDI File representation and are omitted"}, // track.freeze
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files do not carry Pulp media identity hashes"}, // asset.sealed-hash
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files do not embed authored media assets"}, // asset.embedded-media
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files do not retain external media locators"}, // asset.referenced-media
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "only the root sequence is written; other sequences are omitted"}, // sequence.multiple
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "nested sequence placements have no Standard MIDI File representation and are omitted"}, // sequence.nested
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "registered extension clip content has no Standard MIDI File representation and is omitted"}, // content.registered
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "opaque extension clip content has no Standard MIDI File representation and is omitted"}, // content.opaque
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for edit-rate.non-audio"}, // edit-rate.non-audio
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not emit chord or scale context"}, // context.chord-scale
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not apply or serialize authored groove context"}, // context.groove
        {ExportLevel::Degrade, Concept::ClipNote, LossClass::Degraded, "Standard MIDI notes carry no probability, pass condition, or ratchet, so the notes play unconditionally once"}, // clip.note-modifier
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files have no positioned empty-clip object, so the clip is omitted"}, // clip.empty
        {ExportLevel::Degrade, Concept::TempoMap, LossClass::Approximated, "continuous tempo curves become discrete Set Tempo steps at the authored tempo points"}, // tempo.ramp
        {ExportLevel::Degrade, Concept::ClipNote, LossClass::Approximated, "16-bit note velocities are quantized to the nearest nonzero 7-bit Standard MIDI velocity"}, // clip.note-velocity-quantized
        {ExportLevel::Degrade, Concept::TempoMap, LossClass::Approximated, "tempo values are rounded to the nearest representable integer microseconds per quarter note"}, // tempo.value-quantized
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for clip.media-window"}, // clip.media-window
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files have no per-clip fades, so a non-linear fade curve is omitted with the fade it shaped"}, // clip.fade-shape
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Pulp's Standard MIDI File writer emits note, tempo, and meter events only, so an authored controller stream is omitted and the file plays with every controller left wherever the receiving instrument already had it"}, // clip.midi-expression-lane
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer emits a region's name and span but not the part it names"}, // sequence.section-role
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not emit chord or scale context"}, // context.chord-bass
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not emit chord or scale context"}, // context.chord-extension
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "the bounded writer does not emit chord or scale context"}, // context.chord-voicing
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files have no document-wide tuning statement"}, // tuning.project
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI Files have no per-instrument tuning statement"}, // tuning.instrument
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for modulation.modulator"}, // modulation.modulator
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for modulation.macro"}, // modulation.macro
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for modulation.route-device-param"}, // modulation.route-device-param
        {ExportLevel::Drop, Concept::Unknown, LossClass::Dropped, "Standard MIDI File declares no support for modulation.route-track-mixer"}, // modulation.route-track-mixer
    },
};
} // namespace detail

constexpr std::string_view format_id(Format format) noexcept {
    return detail::kFormatRecords[static_cast<std::size_t>(format)].id;
}

constexpr std::string_view format_display_name(Format format) noexcept {
    return detail::kFormatRecords[static_cast<std::size_t>(format)].display_name;
}

constexpr bool format_has_writer(Format format) noexcept {
    return detail::kFormatRecords[static_cast<std::size_t>(format)].has_writer;
}

constexpr bool format_from_id(std::string_view id, Format& out) noexcept {
    for (std::size_t index = 0; index < kFormatCount; ++index) {
        if (detail::kFormatRecords[index].id == id) {
            out = static_cast<Format>(index);
            return true;
        }
    }
    return false;
}

constexpr const ImportRow& import_capability(Format format,
                                             Concept concept_value) noexcept {
    return detail::kImportRows[static_cast<std::size_t>(format)]
                             [static_cast<std::size_t>(concept_value)];
}

constexpr const ExportRow& export_capability(Format format,
                                             Concept concept_value) noexcept {
    return detail::kExportRows[static_cast<std::size_t>(format)]
                             [static_cast<std::size_t>(concept_value)];
}

constexpr bool import_supports(Format format, Concept concept_value) noexcept {
    return import_capability(format, concept_value).level != ImportLevel::None;
}

constexpr bool export_is_lossless(Format format, Concept concept_value) noexcept {
    const ExportLevel level = export_capability(format, concept_value).level;
    return level == ExportLevel::Full || level == ExportLevel::RoundtripOnly;
}
 
static_assert(static_cast<std::size_t>(Concept::Unknown) == 0,
              "Concept::Unknown must be the zero value so a reader that cannot"
              " classify a construct refuses by default");
 
} // namespace pulp::interchange