Struct AssetIdRegistry 

pub struct AssetIdRegistry { /* private fields */ }

Maps forward-slash relative asset paths to their frozen [AssetUUID].

See the module documentation for the lazy-freeze semantics and the engine/editor read/write split.

Implementations

impl AssetIdRegistry

pub fn load(project_root: impl Into<PathBuf>) -> Self

Loads the registry for project_root.

A missing or unreadable file yields an empty registry (every path then resolves to its new_v5 default) — fresh projects and the pre-registry world both behave exactly as before. A malformed file is logged and treated as empty rather than failing the whole project open.

pub fn resolve(&self, rel_fwd: &str) -> AssetUUID

Resolves the UUID for a forward-slash relative path: the frozen entry if one exists, otherwise the default AssetUUID::new_v5(rel).

This is the read primitive used by the index builder, the runtime, and the pack builder.

pub fn len(&self) -> usize

Number of frozen entries (assets whose path has diverged from identity).

pub fn is_empty(&self) -> bool

true when no asset has been frozen yet.

pub fn freeze(&mut self, rel_fwd: &str, uuid: AssetUUID)

Explicitly freezes rel_fwd’s identity to uuid.

Authoring-only. Rarely needed directly — Self::rename freezes as part of the move.

pub fn rename(&mut self, old_rel: &str, new_rel: &str)

Moves the identity of old_rel to new_rel, freezing it in the process.

The new path resolves to the same UUID the old path resolved to (whether it was already frozen or still on its new_v5 default), so every existing reference keeps pointing at the asset. Authoring-only.

pub fn remove(&mut self, rel_fwd: &str)

Drops any frozen entry for rel_fwd (e.g. after the asset is deleted). Authoring-only.

pub fn file_path(&self) -> PathBuf

Absolute path of the on-disk registry file (<project_root>/.khora/asset-registry.ron).

pub fn ensure_file(&self) -> Result<()>

Writes the registry file if it does not exist yet, so a project has a visible .khora/asset-registry.ron from first open (confirming that persistence is wired). No-op when the file already exists. Authoring-only.

pub fn save(&self) -> Result<()>

Persists the registry to <project_root>/.khora/asset-registry.ron.

Entries are sorted by UUID for deterministic, merge-friendly output, and the write is atomic (a sibling *.tmp file is written then renamed over the target) so a crash mid-write cannot corrupt the catalog. Authoring-only.

Trait Implementations

impl Clone for AssetIdRegistry

fn clone(&self) -> AssetIdRegistry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AssetIdRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.