vyre-libs 0.6.2

vyre Category A library ecosystem - pure-IR compositions over vyre-ops hardware primitives
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

//! Deterministic buffer naming for generic Cat-A builder aliases.
//!
//! Some vyre-libs builders historically accepted generic names such as
//! `"input"`, `"output"`, `"decoded"`, or `"out"`. When multiple Programs were
//! fused into one rule kernel, those aliases could collide with unrelated
//! buffers across families. This module rewrites only the generic aliases into
//! stable family-scoped names while preserving caller-specified explicit names.

/// Stable internal buffer name for a family-local role.
#[must_use]
pub(crate) fn fixed_name(family_prefix: &str, role: &str) -> String {
    format!("__vyre_{family_prefix}_{role}")
}

/// Rewrite a generic buffer name into a stable family-local name.
///
/// Explicit caller-provided names are preserved so intentional composition can
/// still route buffers by name.
#[must_use]
pub fn scoped_generic_name(
    family_prefix: &str,
    role: &str,
    requested: &str,
    generic_aliases: &[&str],
) -> String {
    if generic_aliases.iter().any(|alias| *alias == requested) {
        fixed_name(family_prefix, role)
    } else {
        requested.to_string()
    }
}