Struct Scene 

pub struct Scene {
    pub prs_version: String,
    pub metadata: SceneMetadata,
    pub resources: Resources,
    pub layout: SceneLayout,
    pub widgets: Vec<SceneWidget>,
    pub bindings: Vec<Binding>,
    pub theme: Option<SceneTheme>,
    pub permissions: Permissions,
    pub header: Option<HeaderFooter>,
    pub footer: Option<HeaderFooter>,
    pub key_bindings: Option<KeyBindings>,
}

Presentar Scene - top-level structure for .prs files.

A Scene is a declarative manifest that references external resources (models, datasets) and defines widget layout and interactions.

Fields

prs_version: String

Format version (semver, e.g., “1.0”)

metadata: SceneMetadata

Scene metadata

resources: Resources

External resources (models, datasets)

layout: SceneLayout

Widget layout configuration

widgets: Vec<SceneWidget>

Widget definitions

bindings: Vec<Binding>

Event → action bindings

theme: Option<SceneTheme>

Theme configuration

permissions: Permissions

Security permissions

header: Option<HeaderFooter>

Header bar configuration (for tmux layout)

footer: Option<HeaderFooter>

Footer bar configuration (for tmux layout)

key_bindings: Option<KeyBindings>

Keyboard sequence bindings (for tmux layout)

Implementations

impl Scene

pub fn from_yaml(yaml: &str) -> Result<Self, SceneError>

Parse a scene from YAML string.

Errors

Returns an error if the YAML is invalid or fails validation.

pub fn to_yaml(&self) -> Result<String, Error>

Serialize scene to YAML string.

Errors

Returns an error if serialization fails.

pub fn validate(&self) -> Result<(), SceneError>

Validate the scene structure.

Checks:

1. prs_version format (semver)
2. metadata.name is kebab-case
3. Widget IDs are unique
4. Binding targets reference valid widgets/resources
5. Remote resources have hashes
6. Hash formats are valid (blake3:)

Errors

Returns the first validation error found.

pub fn widget_ids(&self) -> Vec<&str>

Get all widget IDs.

pub fn get_widget(&self, id: &str) -> Option<&SceneWidget>

Get a widget by ID.

pub fn get_model(&self, name: &str) -> Option<&ModelResource>

Get a model resource by name.

pub fn get_dataset(&self, name: &str) -> Option<&DatasetResource>

Get a dataset resource by name.

Trait Implementations

impl Clone for Scene

fn clone(&self) -> Scene

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scene

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Scene

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Scene

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.