rill-patchbay 0.5.0-beta.1

The world where Automata live - control system for Rill
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167

//! # Rill Patchbay — Маршрутизация событий и автоматизация
//!
//! `rill-patchbay` является эволюцией `rill-automation` из версии 0.2.0,
//! объединённой с функциональностью маппинга из `rill-control`.
//!
//! ## Основные компоненты
//!
//! - **Автоматы** — генеративные источники сигналов (LFO, огибающие, секвенсоры)
//! - **Сервоприводы** (в модуле `control`) — связь автоматов с параметрами узлов
//! - **Маппинги** — связь внешних событий (MIDI/OSC) с параметрами
//! - **Сенсоры** — источники событий из внешнего мира
//! - **Менеджер** — центральный координатор для двухпоточной архитектуры
//!
//! ## Архитектура
//!
//! ```text
//! ┌─────────────────────────────────────────────────────────────┐
//! │                     ПОТОК УПРАВЛЕНИЯ                         │
//! │                                                              │
//! │  ┌─────────────────────────────────────────────────────┐   │
//! │  │               PatchbayManager                         │   │
//! │  │  ┌────────────┐  ┌────────────┐  ┌────────────┐     │   │
//! │  │  │  Automata  │  │  Servos    │  │  Mappings  │     │   │
//! │  │  └────────────┘  └────────────┘  └────────────┘     │   │
//! │  │                    │                │                │   │
//! │  │                    ▼                ▼                │   │
//! │  │              ┌──────────────────────────┐           │   │
//! │  │              │   RtQueue<ParameterCommand>│         │   │
//! │  │              └──────────────────────────┘           │   │
//! │  └─────────────────────────────────────────────────────┘   │
//! │                              │                               │
//! │                              │ неблокирующая очередь         │
//! │                              ▼                               │
//! │  ┌─────────────────────────────────────────────────────┐   │
//! │  │                  АУДИОПОТОК                          │   │
//! │  │              (rill-graph / rill-io)                  │   │
//! │  └─────────────────────────────────────────────────────┘   │
//! └─────────────────────────────────────────────────────────────┘
//! ```

#![warn(missing_docs)]
#![deny(unsafe_code)]

// =============================================================================
// Внешние зависимости
// =============================================================================

// Реэкспорты из rill-core
pub use rill_core::prelude::*;
pub use rill_core::queues::RtQueue;
pub use rill_core::{NodeId, ParamValue, ParameterId, PortId};

// =============================================================================
// Публичные модули
// =============================================================================

/// Автоматы — генеративные источники управления
pub mod automaton;

/// Управление и маппинг событий
pub mod control;

/// Менеджер патчбэя — центральный координатор
pub mod manager;

/// Сенсоры — источники событий из внешнего мира
pub mod sensor;

/// Утилиты и вспомогательные функции
pub mod utils;

/// Реестр именованных функций для сериализации
pub mod function_registry;

/// Стратегии управления автоматами
pub mod strategy;

/// PortCombiner — комбинирование автомата и UI на порт
pub mod port_combiner;

/// Обёртка Automaton в green thread (tokio task)
pub mod automaton_task;

/// Референсный оркестратор — high-level API над green threads
pub mod engine;

/// Parameter-lock step sequencer
pub mod sequencer;

/// DOT patchbay visualization (Graphviz)
#[cfg(feature = "serde")]
pub mod dot;

/// Сериализация конфигурации управления
#[cfg(feature = "serde")]
pub mod document;

#[cfg(feature = "serde")]
pub use document::PatchbayDocument;

// =============================================================================
// Реэкспорты для удобства
// =============================================================================

// Selective re-exports
pub use automaton::{
    EnvelopeAutomaton, EnvelopeStage, EnvelopeType, FunctionAutomaton, LfoAutomaton, LfoWaveform,
    PlayMode, Range, SequencerAutomaton, StatefulFunctionAutomaton, Step, SyncMode,
};
pub use control::{
    midi_cc, osc_address, AnyServo, Automaton, BoxedServo, ControlEvent, EventPattern, Mapping,
    NoAction, OscSurface, OscSurfaceEntry, ParameterCommand, ParameterMapping, PatchbayControl,
    Servo, Target, Transform,
};
pub use manager::PatchbayManager;
pub use strategy::{ConflictStrategy, ControlStrategy, UiCommand};
pub use port_combiner::{PortCombinerHandle, spawn_combiner};
pub use automaton_task::spawn_automaton_task;
pub use engine::PatchbayEngine;

// Sequencer re-exports
pub use sequencer::{
    ParameterTarget, Pattern, SequenceStep, SequencerHandle, Snapshot, SnapshotSequencer,
    StepPlayMode,
};
#[cfg(feature = "serde")]
pub use sequencer::SequencerDocument;

// =============================================================================
// Прелюдия для удобного импорта
// =============================================================================

/// Прелюдия для удобного импорта основных типов
pub mod prelude {
    // Основные типы
    pub use crate::automaton::*;
    pub use crate::control::*;
    pub use crate::manager::*;
    pub use crate::strategy::*;
    pub use crate::port_combiner::*;
    pub use crate::automaton_task::*;
    pub use crate::engine::*;
    pub use crate::sequencer::*;
    pub use crate::utils::*;

    // Реэкспорты из rill-core
    pub use rill_core::prelude::*;
    pub use rill_core::queues::RtQueue;
    pub use rill_core::{NodeId, ParameterId, PortId};
}

// =============================================================================
// Тесты
// =============================================================================

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_basic_imports() {
        // Просто проверяем, что всё импортируется
        let _ = automaton::LfoWaveform::Sine;
        let _ = control::Transform::Linear;
        let _ = manager::PatchbayConfig::default();
    }
}