Struct Program 

pub struct Program { /* private fields */ }

A linked, ready-to-execute program.

Created from StoryData via link(). Immutable after creation — mutable per-instance state lives in Story.

Implementations

impl Program

pub fn resolve_address(&self, id: DefinitionId) -> Option<(u32, usize)>

Resolve a definition ID to (container_idx, byte_offset).

pub fn container_bytecode(&self, idx: u32) -> &[u8]

Get a container’s bytecode by index.

pub fn container_count(&self) -> u32

Number of containers.

pub fn source_checksum(&self) -> u32

CRC-32 checksum from the source .inkb, used for transcript validation.

pub fn find_address(&self, path: &str) -> Option<(u32, usize)>

Resolve a qualified ink path to its (container_idx, byte_offset).

Supports knot names (intro), qualified stitches (knot.stitch), and, for programs compiled by brink-compiler, author labels (knot.label, knot.stitch.label). Programs without the compiler’s address_paths table (legacy .inkb or converter output) resolve knot/stitch scope paths only. Use this to spawn flows at named entry points:

if let Some((idx, _)) = program.find_address("intro_scene") {
    let (flow, ctx) = FlowInstance::new_at(program, idx);
}

pub fn global_defaults(&self) -> Vec<Value>

Build the initial globals vector from slot defaults.

pub fn global_index(&self, name: &str) -> Option<u32>

Find the global variable slot index for a variable name, if declared. Used by host-facing variable get/set (Story::variable/set_variable).

pub fn global_name(&self, idx: u32) -> Option<&str>

Resolve a global slot index to its variable name.

pub fn global_count(&self) -> u32

Number of global variable slots.