Struct QuadletSource 

pub struct QuadletSource { /* private fields */ }

A named Quadlet document set and caller-owned source identities.

Implementations

impl QuadletSource

pub fn parse( application_name: Identifier, inputs: impl IntoIterator<Item = QuadletDocumentInput>, ) -> Result<QuadletParseResult, QuadletParseError>

Parses explicit in-memory unit files while retaining every recoverable native diagnostic.

Diagnostics are collected in caller input order: syntax diagnostics followed by typed-model diagnostics for each input, then document-set diagnostics. Recoverable document-set diagnostics retain an incomplete graph in the successful result. Syntax/model errors and non-recoverable metadata failures return QuadletParseError.

The parse DTOs contain static diagnostic messages, numeric source identities, and byte spans only; source text, filenames, protected values, and native terminal renderings are deliberately excluded.

Errors

Returns QuadletParseError when a syntax/model error-severity diagnostic or a non-recoverable native or neutral-model construction failure prevents a usable source.

pub fn from_validated_documents( application_name: Identifier, documents: QuadletDocumentSet, ) -> Result<Self, ModelError>

Creates an explicit source without reading a Quadlet search path or installed units.

Every document initially receives the stable neutral identity quadlet-source-<numeric-id>. Call Self::with_source_id to replace it with a caller-owned path, URI, or other display identity.

Errors

Returns ModelError if a generated source identity violates the neutral-model invariant. The current generated spelling is always valid.

pub fn with_source_id(self, quadlet: QuadletSourceId, neutral: SourceId) -> Self

Assigns a caller-owned neutral identity to one Quadlet source document.

pub const fn application_name(&self) -> &Identifier

Returns the caller-selected neutral application name.

pub const fn documents(&self) -> &QuadletDocumentSet

Returns the complete named native document set.

pub fn source_id(&self, quadlet: QuadletSourceId) -> &SourceId

Resolves a Quadlet source identity into its neutral-model identity.

pub fn native_findings(&self) -> &[NativeFinding]

Returns every recoverable native finding retained by the source boundary.

The findings contain stable native codes and value-free source metadata, but never source contents or filenames. Importing this source forwards the same findings to embedded callers.

Trait Implementations

impl Clone for QuadletSource

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QuadletSource

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

Formats the value using the given formatter.

impl Eq for QuadletSource

impl PartialEq for QuadletSource

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for QuadletSource