Struct ProjectVfs 

pub struct ProjectVfs {
    pub root: PathBuf,
    pub assets_root: PathBuf,
    pub asset_service: AssetService,
    pub watcher: AssetWatcher,
    file_loader: FileLoader,
    registry: AssetIdRegistry,
}

All project I/O, in one place.

open performs a recursive scan of <root>/assets/, builds an in-memory VFS index (UUIDs derived from forward-slash relative paths via AssetUUID::new_v5), constructs the AssetService with every default decoder registered, and arms a recursive filesystem watcher for hot reload. UUIDs match what a future pack-builder would produce, so the dev/release transparency promise of the VFS is preserved.

Fields

root: PathBuf

assets_root: PathBuf

asset_service: AssetService

watcher: AssetWatcher

file_loader: FileLoader

registry: AssetIdRegistry

Stable-identity registry (<root>/.khora/asset-registry.ron). The editor is the sole writer: file operations freeze/rename/remove entries so an asset keeps its UUID across renames and every reference keeps resolving.

Implementations

impl ProjectVfs

pub fn open(root: PathBuf, metrics: Arc<MetricsRegistry>) -> Result<Self>

Opens (or creates) <root>/assets/, builds the VFS, and arms the watcher. Tolerates fresh projects whose assets/ directory hasn’t been populated yet — the resulting service has zero indexed assets, which is exactly what the asset browser will show.

pub fn rebuild_index(&mut self) -> Result<()>

Re-walks <root>/assets/ and atomically swaps the VFS index. Called after a scene save (so the new file shows up) and from the hot-reload pump on Created/Removed events.

pub fn read_project_json(&self) -> Result<Value>

Reads <root>/project.json as untyped JSON. Project metadata isn’t an asset (lives outside assets/) so it deliberately bypasses the VFS.

pub fn write_asset(&self, rel_path: &Path, bytes: &[u8]) -> Result<()>

Writes bytes to <root>/assets/<rel_path>. Creates intermediate directories as needed. Caller is responsible for calling Self::rebuild_index afterwards if the new path needs to be resolvable through the VFS in the same frame.

pub fn uuid_for_rel_path(rel_path_fwd_slash: &str) -> AssetUUID

Returns the UUID for a relative-path-with-forward-slashes string, regardless of whether the path currently exists on disk. Used by scene_io to look up scenes by canonical path even before a save has triggered a reindex.

This is the raw path-derived default and ignores the identity registry. Prefer Self::resolve_uuid whenever the asset may have been renamed (frozen identity); use this only for paths that cannot have a frozen entry (e.g. a file being written for the very first time).

pub fn resolve_uuid(&self, rel_path_fwd_slash: &str) -> AssetUUID

Resolves a forward-slash relative path to its UUID through the identity registry: the frozen identity if the asset has been renamed, otherwise the new_v5 default. This is the registry-aware counterpart to Self::uuid_for_rel_path and must be used whenever an asset the user could have renamed is looked up by path (scene / prefab / material load).

fn abs_of(&self, rel_fwd: &str) -> PathBuf

Absolute path of an asset given its forward-slash relative path.

pub fn create_folder(&mut self, rel_dir: &str) -> Result<()>

Creates an (empty) folder under assets/ at rel_dir (forward-slash). Empty folders are surfaced by Self::list_dirs since the VFS itself only indexes files.

pub fn rename_asset(&mut self, old_rel: &str, new_rel: &str) -> Result<()>

Renames/moves an asset from old_rel to new_rel (both forward-slash, under assets/), freezing its UUID so every existing reference keeps resolving. Fails if the destination already exists. Rebuilds the index.

pub fn move_asset(&mut self, src_rel: &str, dest_dir: &str) -> Result<()>

Moves an asset into dest_dir (forward-slash folder, "" = assets root), keeping its file name. Thin wrapper over Self::rename_asset.

pub fn delete_to_trash(&mut self, rel: &str) -> Result<()>

Sends an asset to the OS recycle bin (reversible), drops its registry entry, and rebuilds the index.

pub fn duplicate_asset(&mut self, rel: &str) -> Result<String>

Duplicates an asset next to itself with a unique copy suffix. The copy is a new asset (no registry entry → fresh new_v5 identity). Returns the new forward-slash relative path.

pub fn list_dirs(&self) -> Vec<String>

Lists every directory under assets/ as forward-slash relative paths (sorted, excluding the root). The VFS only indexes files, so empty folders — including freshly created ones — are only visible through this.

pub fn poll_changes(&self) -> Vec<AssetChangeEvent>

Drains pending hot-reload events. Convenience wrapper so callers don’t need to reach through pvfs.watcher.