API reference

aster_blueprint::model

Pre-1.0: signatures are not frozen. Generated from rustdoc JSON of the compiled crate; rustdoc JSON format version 60. Only public items are listed.

Experimental authored graph model. Not an application-state or input protocol.

Authoring keys are local to an asset. Source stamps are process-local proof of the exact builder revision, never presentation or backend authority.

Structs

structaster_blueprint::model::GraphSource

pub struct GraphSource { /* see fields */ }

Builder updates are admitted before mutation. The compiler validates node definitions, type compatibility and reachability after forward references have been supplied. This builder intentionally has no Clone implementation.

Methods

  • fn new(asset: Symbol, limits: Limits) -> Result<Self, ModelError>
  • fn asset(&self) -> &Symbol
  • fn stamp(&self) -> SourceStamp
  • fn limits(&self) -> Limits
  • fn usage(&self) -> Usage
  • fn nodes(&self) -> &[NodeSpec]
  • fn parameters(&self) -> &[ParameterSpec]
  • fn outputs(&self) -> &[OutputSpec]
  • fn insert(&mut self, node: NodeSpec) -> Result<(), ModelError>
  • fn parameter(&mut self, parameter: ParameterSpec) -> Result<(), ModelError>
  • fn output(&mut self, output: OutputSpec) -> Result<(), ModelError>

Trait implementations: Debug

structaster_blueprint::model::Limits

pub struct Limits { /* see fields */ }

Public fields

fieldtype
nodesusize
connectionsusize
bindingsusize
literal_bytesusize
parametersusize
outputsusize
expansion_depthusize
instancesusize

Methods

  • fn validate(self) -> Result<Self, ModelError>

Trait implementations: Clone, Copy, Debug, Default, Eq, PartialEq, StructuralPartialEq

structaster_blueprint::model::NodeKey

pub struct NodeKey(..)

Methods

  • fn new(value: u64) -> Result<Self, ModelError>
  • fn get(self) -> u64

Trait implementations: Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd, StructuralPartialEq

structaster_blueprint::model::NodeSpec

pub struct NodeSpec { /* see fields */ }

Public fields

fieldtype
keyNodeKey
definitionSymbol
inputsstd::collections::BTreeMap<Symbol, Binding>

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

structaster_blueprint::model::OutputSpec

pub struct OutputSpec { /* see fields */ }

Public fields

fieldtype
nameSymbol
value_typeValueType
sourcePortRef

Trait implementations: Clone, Debug, Eq, PartialEq, StructuralPartialEq

structaster_blueprint::model::ParameterSpec

pub struct ParameterSpec { /* see fields */ }

Public fields

fieldtype
nameSymbol
value_typeValueType
defaultOption<Literal>

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

structaster_blueprint::model::PortRef

pub struct PortRef { /* see fields */ }

A serialized-style reference within this asset, not a runtime NodeId.

Public fields

fieldtype
nodeNodeKey
portSymbol

Trait implementations: Clone, Debug, Eq, PartialEq, StructuralPartialEq

structaster_blueprint::model::SourceStamp

pub struct SourceStamp { /* see fields */ }

Opaque local source identity. It is not a persisted hash or app snapshot.

Methods

  • fn revision(self) -> u64

Trait implementations: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq

structaster_blueprint::model::Symbol

pub struct Symbol(..)

Methods

  • fn new(value: impl Into<String>) -> Result<Self, ModelError>
  • fn as_str(&self) -> &str

Trait implementations: Clone, Debug, Eq, Hash, Ord, PartialEq, PartialOrd, StructuralPartialEq

structaster_blueprint::model::Usage

pub struct Usage { /* see fields */ }

Public fields

fieldtype
nodesusize
connectionsusize
bindingsusize
literal_bytesusizeAuthored literal payload bytes, excluding container/identifier overhead.
parametersusize
outputsusize

Trait implementations: Clone, Copy, Debug, Default, Eq, PartialEq, StructuralPartialEq

Enums

enumaster_blueprint::model::Binding

pub enum Binding { Literal, Connection, Parameter, Resource }

Variants

  • Literal
  • Connection
  • Parameter
  • Resource

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

enumaster_blueprint::model::Domain

pub enum Domain { Pure, Visual, Layout, Motion, Event, Semantics }

Variants

  • Pure
  • Visual
  • Layout
  • Motion
  • Event
  • Semantics

Trait implementations: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq

enumaster_blueprint::model::Effect

pub enum Effect { Pure, Clock, Temporal, Command }

Variants

  • Pure
  • Clock
  • Temporal
  • Command

Trait implementations: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq

enumaster_blueprint::model::Literal

pub enum Literal { Scalar, Seconds, LogicalLength, Bool, Srgb8, LogicalPoint, LogicalRect, Text }

Nonsecret authored literals only. Runtime secrets must never enter assets.

Methods

  • fn value_type(&self) -> ValueType
  • fn validate(&self) -> Result<(), ModelError>
  • fn payload_bytes(&self) -> usize

Variants

  • Scalar
  • Seconds
  • LogicalLength
  • Bool
  • Srgb8
  • LogicalPoint
  • LogicalRect
  • Text

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

enumaster_blueprint::model::ModelError

pub enum ModelError { InvalidSymbol, InvalidKey, InvalidLiteral, InvalidLimits, DuplicateNode, DuplicateInterface, TypeMismatch, Capacity, Allocation, IdentityExhausted }

Variants

  • InvalidSymbol
  • InvalidKey
  • InvalidLiteral
  • InvalidLimits
  • DuplicateNode
  • DuplicateInterface
  • TypeMismatch
  • Capacity
  • Allocation
  • IdentityExhausted

Trait implementations: Clone, Copy, Debug, Display, Eq, Error, From<ModelError>, PartialEq, StructuralPartialEq

enumaster_blueprint::model::ValueType

pub enum ValueType { Scalar, Seconds, LogicalLength, Bool, Srgb8, LogicalPoint, LogicalRect, Text, Paint, Drawing, Label, Layer, Scene, Event, Intent, Surface, Fluid }

Variants

  • Scalar
  • Seconds
  • LogicalLength
  • Bool
  • Srgb8
  • LogicalPoint
  • LogicalRect
  • Text
  • Paint
  • Drawing
  • Label
  • Layer
  • Scene
  • Event
  • Intent
  • Surface — A caller-provided surface: nothing, an existing paint or an existing painted recording.
  • Fluid — A running fluid simulation (core.fluid.*.v1): a runtime-only family produced by core.fluid.sim.v1 and consumed by the fluid read-out nodes. Like Surface, no Literal maps to it and it cannot be authored, only computed.

Trait implementations: Clone, Copy, Debug, Eq, PartialEq, StructuralPartialEq