Skip to main content

qualia_core_db/render/portal_qac/
model.rs

1use crate::audio::qac::{
2    metadata::Transform,
3    signal::{self, Scalar, Timing},
4};
5use crate::q42::{field_envelope as env, field_semantics as sem};
6
7#[derive(Clone, Copy, Debug, PartialEq, Eq)]
8pub enum Error {
9    Envelope(env::Error),
10    Signal(signal::Error),
11    Limit,
12    Overflow,
13    Index,
14    Unsupported,
15    Invariant,
16}
17impl From<env::Error> for Error {
18    fn from(e: env::Error) -> Self {
19        Self::Envelope(e)
20    }
21}
22impl From<signal::Error> for Error {
23    fn from(e: signal::Error) -> Self {
24        Self::Signal(e)
25    }
26}
27
28/// Explicit source, cold scratch/metadata and hot-window budgets.
29#[derive(Clone, Copy, Debug)]
30pub struct Limits {
31    pub envelope: env::Limits,
32    pub shared: sem::Limits,
33    pub signal: signal::Limits,
34    /// Includes the retained source, temporary graph states, and copied metadata.
35    pub memory_bytes: usize,
36    pub window_records: u64,
37    pub window_samples: u64,
38}
39impl Default for Limits {
40    fn default() -> Self {
41        Self {
42            envelope: env::Limits::default(),
43            shared: sem::Limits::default(),
44            signal: signal::Limits::default(),
45            memory_bytes: 320 << 20,
46            window_records: 65536,
47            window_samples: 1_048_576,
48        }
49    }
50}
51
52/// Scientific declarations, retained exactly before any JS number conversion.
53/// Scale/offset are declarations, never automatically applied to stored samples.
54#[derive(Clone, Debug)]
55pub struct Metadata {
56    pub selected_entry: u32,
57    pub descriptor_id: u32,
58    pub clock_id: u32,
59    pub provenance_id: u32,
60    pub epistemic_role: &'static str,
61    pub stream_id: u32,
62    pub frame_id: u32,
63    pub mode: u16,
64    pub scalar: Scalar,
65    pub channels: u32,
66    pub bins: u32,
67    pub records: u64,
68    pub timing: Timing,
69    pub transform: Option<Transform>,
70    pub window_coefficients_le: Option<Box<[u8]>>,
71    pub channel_order: Box<str>,
72    pub purpose: Box<str>,
73    pub relation: Box<str>,
74    pub quantity: Box<str>,
75    pub units: Box<str>,
76    pub model_uri: Box<str>,
77    pub units_per_stored_sample: f64,
78    pub stored_offset: f64,
79    pub index_digest: [u8; 32],
80}
81
82pub const fn provenance_role_str(code: u32) -> Option<&'static str> {
83    match code {
84        0 => Some("measured"),
85        1 => Some("model"),
86        2 => Some("derived"),
87        3 => Some("command"),
88        4 => Some("opaque-preserved"),
89        _ => None,
90    }
91}