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) -> Selffn 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 inSymbolorder, cloning no payloads.
Trait implementations: Debug
structaster_blueprint::compiler::CatalogLimits
pub struct CatalogLimits { /* see fields */ }Public fields
| field | type | |
|---|---|---|
definitions | usize | |
ports_per_definition | usize |
Trait implementations: Clone, Copy, Debug, Default, Eq, PartialEq, StructuralPartialEq
structaster_blueprint::compiler::CompileError
pub struct CompileError { /* see fields */ }Public fields
| field | type | |
|---|---|---|
kind | Refusal | |
node | Option<model::NodeKey> | |
port | Option<model::Symbol> |
Trait implementations: Clone, Debug, Display, Eq, Error, From<CompileError>, PartialEq, StructuralPartialEq
structaster_blueprint::compiler::CompileLimits
pub struct CompileLimits { /* see fields */ }Public fields
| field | type | |
|---|---|---|
nodes | usize | |
connections | usize | |
slots | usize | |
dependency_depth | usize | |
literal_bytes | usize |
Trait implementations: Clone, Copy, Debug, Default, Eq, PartialEq, StructuralPartialEq
structaster_blueprint::compiler::Definition
pub struct Definition { /* see fields */ }Public fields
| field | type | |
|---|---|---|
name | model::Symbol | Includes an explicit library version, e.g. math.add.v1. |
domain | model::Domain | |
effect | model::Effect | |
inputs | Vec<InputPort> | |
outputs | Vec<OutputPort> | |
capabilities | std::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
| field | type | |
|---|---|---|
resources | std::collections::BTreeMap<model::Symbol, model::ValueType> | |
capabilities | std::collections::BTreeSet<model::Symbol> |
Trait implementations: Clone, Debug, Default
structaster_blueprint::compiler::InputPort
pub struct InputPort { /* see fields */ }Public fields
| field | type | |
|---|---|---|
name | model::Symbol | |
value_type | model::ValueType | |
default | Option<model::Literal> |
Trait implementations: Clone, Debug, PartialEq, StructuralPartialEq
structaster_blueprint::compiler::Instruction
pub struct Instruction { /* see fields */ }Public fields
| field | type | |
|---|---|---|
key | model::NodeKey | |
definition | Definition | |
inputs | Vec<PlanBinding> | Definition-declared input order, with names already resolved. |
output_slots | Vec<Slot> | |
dependencies | Vec<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
| field | type | |
|---|---|---|
name | model::Symbol | |
value_type | model::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) -> PlanIdfn source(&self) -> SourceStampfn asset(&self) -> &Symbolfn matches(&self, source: &GraphSource) -> boolfn 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) -> usizefn 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
| field | type | |
|---|---|---|
name | model::Symbol | |
value_type | model::ValueType | |
slot | Slot |
Trait implementations: Clone, Debug, Eq, PartialEq, StructuralPartialEq
structaster_blueprint::compiler::ResourceSlot
pub struct ResourceSlot { /* see fields */ }Public fields
| field | type | |
|---|---|---|
name | model::Symbol | |
value_type | model::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
LiteralSlotParameterResource
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
CapacityAllocationIdentityExhaustedNoOutputsDuplicateDefinitionDuplicatePortInvalidDefaultInvalidEffectUnknownDefinitionUnknownInputMissingInputUnknownNodeUnknownOutputUnknownParameterUnknownResourceUnsupportedCapabilityTypeMismatchAuthorityAsDataCycleDependencyDepth
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: usizeA single definition may not require more host capabilities than this.
constaster_blueprint::compiler::MAX_DEFINITION_DEFAULT_BYTES
pub const MAX_DEFINITION_DEFAULT_BYTES: usizeTotal authored default payload bytes a single definition may carry.