Struct IndexBuilder 

pub struct IndexBuilder<'a> { /* private fields */ }

Recursive scanner that turns a project’s assets/ directory into an AssetMetadata list ready for the VFS.

See module documentation for determinism and UUID stability guarantees.

Implementations

impl<'a> IndexBuilder<'a>

pub fn new(assets_root: &'a Path) -> Self

Creates a new builder rooted at assets_root.

assets_root must be the assets directory of a project, not the project root — the relative paths recorded in AssetMetadata (and hence the UUIDs) are computed relative to it.

Without Self::with_registry, UUIDs are the path-derived new_v5 default (the pre-registry behaviour).

pub fn with_registry(self, registry: &'a AssetIdRegistry) -> Self

Resolves each asset’s UUID through registry (frozen identities win; unfrozen paths still fall back to new_v5). Supply the same registry in dev (editor VFS) and release (pack builder) so UUIDs match by construction.

pub fn build_metadata(&self) -> Result<Vec<AssetMetadata>>

Walks the assets root and produces a sorted, deterministic Vec<AssetMetadata>.

Returns an empty vector if assets_root doesn’t exist — the editor tolerates fresh projects whose assets/ directory hasn’t been populated yet.

pub fn build_index_bytes(&self) -> Result<Vec<u8>>

Convenience: builds metadata and bincode-encodes it into the byte vector that crate::vfs::VirtualFileSystem::new expects.