API reference

aster_blueprint::compiler

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.

Deterministic type/effect validation and lowering into immutable slot plans.

This compiler does not execute kernels, render, authorize actions, or invent presentation receipts. Node definitions are trusted host/library contracts; assets can connect only their declared ports and required capabilities.

Structs

structaster_blueprint::compiler::Catalog

pub struct Catalog { /* see fields */ }

Methods

  • fn new(limits: CatalogLimits) -> Self
  • fn register(&mut self, definition: Definition) -> Result<(), CompileError>
  • fn definition(&self, name: &Symbol) -> Option<&Definition>
  • fn definitions(&self) -> impl ExactSizeIterator<Item = &Definition> + '_ — Borrows every registered definition in Symbol order, cloning no payloads.

Trait implementations: Debug

structaster_blueprint::compiler::CatalogLimits

pub struct CatalogLimits { /* see fields */ }

Public fields

fieldtype
definitionsusize
ports_per_definitionusize

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

structaster_blueprint::compiler::CompileError

pub struct CompileError { /* see fields */ }

Public fields

fieldtype
kindRefusal
nodeOption<model::NodeKey>
portOption<model::Symbol>

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

structaster_blueprint::compiler::CompileLimits

pub struct CompileLimits { /* see fields */ }

Public fields

fieldtype
nodesusize
connectionsusize
slotsusize
dependency_depthusize
literal_bytesusize

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

structaster_blueprint::compiler::Definition

pub struct Definition { /* see fields */ }

Public fields

fieldtype
namemodel::SymbolIncludes an explicit library version, e.g. math.add.v1.
domainmodel::Domain
effectmodel::Effect
inputsVec<InputPort>
outputsVec<OutputPort>
capabilitiesstd::collections::BTreeSet<model::Symbol>

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

structaster_blueprint::compiler::Environment

pub struct Environment { /* see fields */ }

Describes supported resources/backend operations, not security authorization.

Public fields

fieldtype
resourcesstd::collections::BTreeMap<model::Symbol, model::ValueType>
capabilitiesstd::collections::BTreeSet<model::Symbol>

Trait implementations: Clone, Debug, Default

structaster_blueprint::compiler::InputPort

pub struct InputPort { /* see fields */ }

Public fields

fieldtype
namemodel::Symbol
value_typemodel::ValueType
defaultOption<model::Literal>

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

structaster_blueprint::compiler::Instruction

pub struct Instruction { /* see fields */ }

Public fields

fieldtype
keymodel::NodeKey
definitionDefinition
inputsVec<PlanBinding>Definition-declared input order, with names already resolved.
output_slotsVec<Slot>
dependenciesVec<usize>Unique upstream instruction indices, sorted in execution order.

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

structaster_blueprint::compiler::OutputPort

pub struct OutputPort { /* see fields */ }

Public fields

fieldtype
namemodel::Symbol
value_typemodel::ValueType

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

structaster_blueprint::compiler::Plan

pub struct Plan { /* see fields */ }

Immutable compilation artifact. Identical assets may have distinct PlanIds.

Methods

  • fn id(&self) -> PlanId
  • fn source(&self) -> SourceStamp
  • fn asset(&self) -> &Symbol
  • fn matches(&self, source: &GraphSource) -> bool
  • fn instructions(&self) -> &[Instruction]
  • fn parameters(&self) -> &[ParameterSpec]
  • fn resources(&self) -> &[ResourceSlot]
  • fn outputs(&self) -> &[PlanOutput]
  • fn event_outputs(&self) -> &[PlanOutput] — Typed event/intent interface metadata, separate from retained values. These ports do not prove an activation or execute an application action.
  • fn slot_count(&self) -> usize
  • fn uses_clock(&self) -> bool — This says only that a retained visual/data output needs time. Command scheduling still requires an actual event, never an automatic frame tick.

Trait implementations: Debug

structaster_blueprint::compiler::PlanId

pub struct PlanId(..)

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

structaster_blueprint::compiler::PlanOutput

pub struct PlanOutput { /* see fields */ }

Public fields

fieldtype
namemodel::Symbol
value_typemodel::ValueType
slotSlot

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

structaster_blueprint::compiler::ResourceSlot

pub struct ResourceSlot { /* see fields */ }

Public fields

fieldtype
namemodel::Symbol
value_typemodel::ValueType

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

structaster_blueprint::compiler::Slot

pub struct Slot(..)

Slot numbers are local to this compiled plan, never app or scene identities.

Methods

  • fn index(self) -> usize

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

Enums

enumaster_blueprint::compiler::PlanBinding

pub enum PlanBinding { Literal, Slot, Parameter, Resource }

Variants

  • Literal
  • Slot
  • Parameter
  • Resource

Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq

enumaster_blueprint::compiler::Refusal

pub enum Refusal { Capacity, Allocation, IdentityExhausted, NoOutputs, DuplicateDefinition, DuplicatePort, InvalidDefault, InvalidEffect, UnknownDefinition, UnknownInput, MissingInput, UnknownNode, UnknownOutput, UnknownParameter, UnknownResource, UnsupportedCapability, TypeMismatch, AuthorityAsData, Cycle, DependencyDepth }

Methods

  • fn hint(self) -> &'static str — What this refusal means and how to fix the asset.

Variants

  • Capacity
  • Allocation
  • IdentityExhausted
  • NoOutputs
  • DuplicateDefinition
  • DuplicatePort
  • InvalidDefault
  • InvalidEffect
  • UnknownDefinition
  • UnknownInput
  • MissingInput
  • UnknownNode
  • UnknownOutput
  • UnknownParameter
  • UnknownResource
  • UnsupportedCapability
  • TypeMismatch
  • AuthorityAsData
  • Cycle
  • DependencyDepth

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

Functions

fnaster_blueprint::compiler::compile

pub fn compile(source: &model::GraphSource, catalog: &Catalog, env: &Environment, limits: CompileLimits) -> Result<Plan, CompileError>

Validate all authored nodes, including unused nodes, then prune unused pure work. Catalog effect nodes are preserved, but never executed by compilation. Immediate cycles are rejected; explicit temporal feedback zones are future lowering work, not silently accepted as an acyclic graph.

Constants

constaster_blueprint::compiler::MAX_CAPABILITIES_PER_DEFINITION

pub const MAX_CAPABILITIES_PER_DEFINITION: usize

A single definition may not require more host capabilities than this.

constaster_blueprint::compiler::MAX_DEFINITION_DEFAULT_BYTES

pub const MAX_DEFINITION_DEFAULT_BYTES: usize

Total authored default payload bytes a single definition may carry.