Struct BasisArchive 

pub struct BasisArchive { /* private fields */ }

Portable, versioned manifest of ordered physical basis states.

A basis archive stores stable state identifiers, their logical bit width, public row ordering, and scalar metadata. It intentionally does not serialize executable callbacks. Built-in frontends may store their language-neutral constructor request in metadata and rebuild local operator semantics after loading, while every consumer can use the state manifest to align vectors, projectors, and operator archives safely.

Implementations

impl BasisArchive

pub fn new( width_bits: usize, states: impl IntoIterator<Item = ErasedState>, ) -> Result<Self>

Construct an archive from ordered, unique physical state identifiers.

pub fn from_basis<B>(basis: &B, width_bits: usize) -> Result<Self>

where B: Basis, B::State: Display,

Snapshot any integer-labelled basis without changing its public order.

pub const fn width_bits(&self) -> usize

Logical bit width of every archived state.

pub fn states(&self) -> &[ErasedState]

Ordered physical states, one per public basis row.

pub fn insert_metadata( &mut self, key: impl Into<String>, value: impl Into<String>, ) -> Result<()>

Attach a small language-neutral reconstruction hint or provenance item.

pub fn metadata(&self) -> impl Iterator<Item = (&str, &str)>

Iterate over archived scalar metadata.

pub fn metadata_value(&self, key: &str) -> Option<&str>

Read one archived metadata value.

Trait Implementations

impl Clone for BasisArchive

fn clone(&self) -> BasisArchive

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BasisArchive

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

Formats the value using the given formatter.