Struct RootDatabase 

pub struct RootDatabase { /* private fields */ }

The concrete analyzer database — a salsa Storage plus the Files side table.

Implementations

impl RootDatabase

pub fn set_file_text( &mut self, file: FileId, text: &str, durability: Durability, )

Create/update file’s text input (the single input-mutation primitive apply_change drives). Clones the Arc-backed Files handle first so self is free to pass as the &mut dyn Db the salsa setter needs.

pub fn set_file_path(&mut self, file: FileId, path: &str)

Set file’s res:// path (the loader supplies it on add; M3 preload/extends resolve through it). Guarded against no-op re-sets — see Files::set_file_path.

pub fn remove_file(&mut self, file: FileId)

Remove file’s entry from the side table.

pub fn set_project_config(&mut self, text: &str)

Set the project’s project.godot text (the loader supplies it on project open / when it changes — M4 autoloads). No-op if unchanged: salsa bumps an input field’s revision on every set even for an identical value, so a redundant push would needlessly invalidate the autoload registry. Held at MEDIUM durability, so a .gd keystroke never touches it.

pub fn set_engine_api(&mut self, api: EngineApi)

Install a runtime-loaded engine model (the wasm path: a fetched extension_api blob decoded via EngineApi::from_bytes). Leaked to &'static (one per session, process lifetime). Load-once before any query — the engine model is not a salsa input, so a later set would not invalidate cached reads; first-wins (a redundant install is ignored, so the leak happens at most once). Native builds normally never call this (they fall back to the bundled blob); it is the seam the wasm/wasip1 binding uses.

pub fn sync_source_root(&mut self)

Rebuild the project file-set input from the current side table. Call this from apply_change only when a file was added or removed — never on a body edit — so the MEDIUM-durability project input (and everything derived from it) stays stable across keystrokes.

Trait Implementations

impl Clone for RootDatabase

fn clone(&self) -> RootDatabase

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Database for RootDatabase

fn trigger_lru_eviction(&mut self)

Enforces current LRU limits, evicting entries if necessary.

fn synthetic_write(&mut self, durability: Durability)

A “synthetic write” causes the system to act as though some input of durability durability has changed, triggering a new revision. This is mostly useful for profiling scenarios.

fn trigger_cancellation(&mut self)

This method cancels all outstanding computations. If you invoke it while a snapshot exists, it will block until that snapshot is dropped – if that snapshot is owned by the current thread, this could trigger deadlock.

fn cancellation_token(&self) -> CancellationToken

Retrieves a CancellationToken for the current database handle.

fn report_untracked_read(&self)

Reports that the query depends on some state unknown to salsa.

fn ingredient_debug_name( &self, ingredient_index: IngredientIndex, ) -> Cow<'_, str>

Return the “debug name” (i.e., the struct name, etc) for an “ingredient”, which are the fine-grained components we use to track data. This is intended for debugging and the contents of the returned string are not semver-guaranteed.

fn unwind_if_revision_cancelled(&self)

Starts unwinding the stack if the current revision is cancelled.

fn attach<R>(&self, op: impl FnOnce(&Self) -> R) -> R

where Self: Sized,

Execute op with the database in thread-local storage for debug print-outs.

impl Db for RootDatabase

fn file_text(&self, file: FileId) -> Option<FileText>

The text input for file, or None if no text has been set for it.

fn engine(&self) -> Option<&'static EngineApi>

The bundled engine model, or None on wasm32 (no embedded blob — the host wires the fetched blob in via EngineApi::from_bytes in Phase 5).

fn source_root(&self) -> Option<SourceRoot>

The project’s file set, or None before any file has been applied. Project-wide queries (the global class_name registry) take this as their salsa-tracked input.

fn project_config(&self) -> Option<ProjectConfig>

The project’s project.godot config, or None in single-file mode. The autoload registry (M4) takes this as its salsa-tracked input.

impl Debug for RootDatabase

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

Formats the value using the given formatter.

impl Default for RootDatabase

fn default() -> RootDatabase

Returns the “default value” for a type.

impl HasStorage for RootDatabase

fn storage(&self) -> &Storage<Self>

fn storage_mut(&mut self) -> &mut Storage<Self>