concinnity-world 0.18.64

Authored world source, args schema, validation, and spec builders for Concinnity
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

//! Asset reference-graph extraction: the names an asset references, from the
//! same two sources the cross-reference validator resolves -- the registries'
//! flat `refs:` metadata and the structured `CrossReferenced` impls. Their
//! union is the complete reference set by construction (a hand impl never
//! re-checks a registry-declared field), so consumers (scene partitioning,
//! provenance tooling) get the full edge list without per-type knowledge.

use crate::check::asset_refs::CrossRef;
use crate::check::cross_reference::cross_refs_for;
use crate::registry::RegisteredType;
use crate::world::WorldJsonlAsset;

/// The names of every asset `asset` references, in field/declaration order.
/// Names are returned as authored; callers resolve them against the world's
/// asset list. Unresolvable or empty references are omitted, not errors.
pub fn referenced_names(asset: &WorldJsonlAsset) -> Vec<String> {
    let norm = |t: &str| t.to_lowercase().replace('_', "");
    let type_norm = norm(&asset.asset_type);

    let mut names = Vec::new();

    let flat_refs = RegisteredType::all()
        .iter()
        .map(|t| (t.as_str(), t.ref_fields()))
        .filter(|(ty, _)| norm(ty) == type_norm)
        .flat_map(|(_, refs)| refs.iter());
    for &(field, _target) in flat_refs {
        if let Some(name) = asset
            .args
            .get(field)
            .and_then(|v| v.as_str())
            .filter(|s| !s.is_empty())
        {
            names.push(name.to_string());
        }
    }

    for cross_ref in cross_refs_for(&type_norm, &asset.name, &asset.args) {
        if let CrossRef::Resolve { target, .. } = cross_ref {
            names.push(target);
        }
    }

    names
}

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

    fn asset(name: &str, ty: &str, args: serde_json::Value) -> WorldJsonlAsset {
        WorldJsonlAsset {
            name: name.to_string(),
            asset_type: ty.to_string(),
            args,
        }
    }

    #[test]
    fn prop_flat_and_structured_refs_are_unioned() {
        // `model` is registry-declared; `mesh` is structured (polymorphic
        // MeshSource, kept in the hand impl).
        let refs = referenced_names(&asset(
            "p",
            "Prop",
            serde_json::json!({"mesh":"box","material":"mat"}),
        ));
        assert!(refs.contains(&"box".to_string()));
        assert!(refs.contains(&"mat".to_string()));
    }

    #[test]
    fn material_texture_slots_come_from_the_resource_registry() {
        let refs = referenced_names(&asset(
            "m",
            "Material",
            serde_json::json!({"albedo":"tex_a","normal_map":"tex_n"}),
        ));
        assert_eq!(refs, vec!["tex_a".to_string(), "tex_n".to_string()]);
    }

    #[test]
    fn model_submesh_list_is_structured() {
        let refs = referenced_names(&asset(
            "mdl",
            "Model",
            serde_json::json!({"meshes":[{"mesh":"m0","material":"mat0"},{"mesh":"m1"}]}),
        ));
        assert!(refs.contains(&"m0".to_string()));
        assert!(refs.contains(&"mat0".to_string()));
        assert!(refs.contains(&"m1".to_string()));
    }

    #[test]
    fn empty_and_absent_fields_are_omitted() {
        let refs = referenced_names(&asset("p", "Prop", serde_json::json!({"model":""})));
        assert!(refs.is_empty());
    }

    #[test]
    fn unknown_type_has_no_refs() {
        assert!(referenced_names(&asset("x", "NotAType", serde_json::json!({}))).is_empty());
    }
}