Struct SemanticObservation 

pub struct SemanticObservation {
    pub schema_version: u32,
    pub revision: u64,
    pub level: SemanticObservationLevel,
    pub route: SemanticRouteIdentity,
    pub page: SemanticPage,
    pub regions: Vec<SemanticRegion>,
    pub text: Option<String>,
    pub accessibility: Option<Vec<SemanticAccessibilityNode>>,
    pub raw_accessibility: Option<Vec<SemanticAccessibilityNode>>,
    pub changes: Option<SemanticChangeSet>,
    pub limits: SemanticObservationLimits,
}

Versioned semantic page model.

Fields

schema_version: u32

revision: u64

level: SemanticObservationLevel

route: SemanticRouteIdentity

page: SemanticPage

regions: Vec<SemanticRegion>

text: Option<String>

accessibility: Option<Vec<SemanticAccessibilityNode>>

raw_accessibility: Option<Vec<SemanticAccessibilityNode>>

changes: Option<SemanticChangeSet>

limits: SemanticObservationLimits

Implementations

impl SemanticObservation

pub fn from_page_context( context: &PageContext, level: SemanticObservationLevel, ) -> Result<Self, SemanticObservationError>

Build a deterministic semantic summary from an existing fresh page observation. Classification is advisory and never replaces revisioned interactive references from the source observation.

pub fn scoped_region_from_page_context( context: &PageContext, level: SemanticObservationLevel, region_id: &str, ) -> Result<Self, SemanticObservationError>

Build a revision-scoped observation containing one previously named region. The source context is still classified in full so the region ID and its target grouping follow the same deterministic rules as the page-level observation.

pub fn diff_from( &self, previous: &SemanticObservation, ) -> Result<SemanticChangeSet, SemanticObservationError>

Compute bounded changes from an earlier compatible observation.

pub fn with_changes_from( self, previous: &SemanticObservation, ) -> Result<Self, SemanticObservationError>

Attach a revision-aware diff to this observation.

pub fn validate(&self) -> Result<(), SemanticObservationError>

Validate bounds and cross-field identity invariants.

pub fn from_json(input: &str) -> Result<Self, SemanticObservationError>

Parse and validate a semantic observation from JSON.

pub fn to_canonical_json(&self) -> Result<String, SemanticObservationError>

Serialize a validated observation deterministically.

Trait Implementations

impl Clone for SemanticObservation

fn clone(&self) -> SemanticObservation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SemanticObservation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SemanticObservation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SemanticObservation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.