Struct Loom 

pub struct Loom<L: WorldLoader> { /* private fields */ }

A ready-to-pump browser core: a Navigator wired to an owned WorldLoader.

Implementations

impl<L: WorldLoader> Loom<L>

pub fn new(worlds_root: impl Into<PathBuf>, loader: L) -> Self

Build a browser core over loader. worlds_root is the local dev-resolver root (where thread://host/path falls back to <root>/<path>/world.json).

pub fn open(&mut self, locator: &str, anchor: Vec3)

Open a world by Locator (the entry to the live Thread). The world loads on a subsequent update once the async resolve+fetch lands.

pub fn load_file(&mut self, path: &Path, anchor: Vec3) -> Option<Vec3>

Load a local world.json directly (the offline / startup path). Returns the spawn to place the player at.

pub fn update(&mut self, dt: f32, player_pos: Vec3) -> Option<Vec3>

Advance one frame: finish an in-flight veilwalk, or begin one if the player stepped into a veil. Returns Some(spawn) when the player should be moved.

pub fn title(&self) -> Option<&str>

Title of the active world.

pub fn description(&self) -> Option<&str>

The active world’s one-line description (may be empty) — arrival cards.

pub fn world_id(&self) -> &str

The active world’s stable id (its presence room key).

pub fn sky(&self) -> Option<SkyNav>

The active world’s sky/atmosphere.

pub fn portals(&self) -> &[PortalNav]

The veils in the active world (render as doorways / minimap / walk toward).

pub fn presence_relays(&self) -> &[String]

The active world’s presence relays (primary first, then fallbacks).

pub fn focused(&self, player_pos: Vec3) -> Option<Focus>

The inspectable placement the player is standing at, if any.

pub fn near_portal(&self, player_pos: Vec3) -> Option<(&str, &str)>

The veil the player is standing in front of, as (label, destination).

pub fn is_traveling(&self) -> bool

Whether a veilwalk is in flight (show a spinner).

pub fn armed(&self) -> bool

Whether the engine is idle + armed (a veil will fire on contact).

pub fn last_error(&self) -> Option<&str>

The most recent veilwalk failure, if any.

pub fn locator(&self) -> Option<&str>

The active world’s Locator (the address bar), if it arrived by one.

pub fn world_source(&self) -> Option<&str>

The active world’s raw manifest text (view-source).

pub fn interact(&mut self, player_pos: Vec3) -> Vec<Action>

The player interacted with whatever they’re standing at → the [Action]s (see crate::behavior) its bound behavior module asks the browser to perform. Empty when nothing is bound (fall back to Codex/web focus).

pub fn tick_behaviors(&mut self, dt: f32) -> Vec<Action>

Advance the active world’s ticking behavior modules — the heartbeat. Returns the Actions ticking Weft behaviors request.

pub fn back(&mut self, anchor: Vec3) -> bool

Veilwalk back to the previous world. Returns whether a walk began.

pub fn forward(&mut self, anchor: Vec3) -> bool

Veilwalk forward again after back().

pub fn go_home(&mut self, anchor: Vec3) -> bool

Veilwalk to the session’s home world (by default, where it opened).

pub fn loader(&self) -> &L

Borrow the loader (e.g. to read what it recorded) …

pub fn navigator(&self) -> &Navigator

… or the navigator, for the full read API.