sim-lib-serial-core 0.1.0

Finite symbolic alphabets, aggregate rules, and certified total series transforms for SIM.
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

# sim-lib-serial-core

`sim-lib-serial-core` is SIM's pitch-independent finite serial calculus. It
stores alphabet symbols in ordered series, validates explicit aggregate rules,
retains count evidence, supplies total certified transforms, and delegates
permutation rank to `sim-discrete`.

The crate deliberately has no pitch, score, runtime, search, or enumeration
dependency. A five-symbol gesture alphabet is as native as a later chromatic
pitch-class adapter.

```rust
use sim_lib_serial_core::{AggregateRule, AlphabetId, FiniteAlphabet, Series};

let alphabet = FiniteAlphabet::try_new(
    AlphabetId::try_new("gesture/five-v1")?,
    vec!["rise", "fall", "hold", "turn", "rest"],
)?;
let series = Series::try_new(
    alphabet,
    AggregateRule::exhaustive_exactly_once(),
    vec!["turn", "rise", "rest", "fall", "hold"],
)?;
assert!(series.ledger().is_exhaustive_exactly_once());

let transformed = series.apply(&sim_lib_serial_core::SeriesTransform::retrograde(5))?;
let restored = transformed.series.apply(
    transformed.certificate.inverse.as_ref().expect("retrograde has an inverse"),
)?;
assert_eq!(restored.series, series);
assert!(transformed.certificate.aggregate_preserved);
# Ok::<(), Box<dyn std::error::Error>>(())
```

See the embedded `custom-alphabet` cookbook recipe for the matching Lisp
validation surface in `sim-lib-music-shapes`, and `certified-transforms` for a
checked Rust composition and inverse law.