Skip to content
YosoiDocs

yosoi.outcomes

yosoi.outcomes

Typed locator outcomes preserve Rust evidence and terminal distinctions.

Source: python/yosoi/outcomes.py:1

Name Summary
AccessibilityCoordinate Accessibility node identity scoped to an immutable snapshot epoch.
AccessibilityLocation Tagged accessibility node evidence within a snapshot epoch.
Attribute One projected attribute name and decoded value.
AttributeValue Tagged attribute projection retaining its name as well as its value.
ByteRange Half-open byte offsets in an owned source payload, allowing empty ranges.
CapturedText Projected text and named regular-expression capture values.
Complete Evidence supports complete coverage of the requested locator scope.
DecodedTextCoordinate Paired source-byte and decoded-text scalar offsets for a match.
DecodedTextLocation Tagged byte and Unicode-scalar evidence for a decoded-text match.
DomCoordinate Rendered DOM node identity scoped to one immutable snapshot epoch.
ExpandedNamePathSegment Namespace-qualified XML element identity within a tree path.
Failure Typed terminal locator failure without hostile document excerpts.
Finding An ordered locator finding with projection and completeness evidence.
Indeterminate No match was established and incomplete evidence prevents absence claims.
JsonLocation Tagged JSON Pointer evidence, without proving document resolution.
JsonValueProjection Tagged JSON projection using Rust JSON value equality.
LocateFailed Execution ended with a typed failure instead of a match or absence claim.
LocateResult Nonempty matched regions or findings in deterministic global order.
Matched At least one region or finding matched, possibly with partial evidence.
NoMatch Complete locator execution found no match within the requested scope.
NodeReference Document-bound native location, without retaining document contents.
NodeValue Tagged document-bound node reference rather than a content copy.
Partial Known evidence loss prevents an unqualified complete absence claim.
RegionLineage Parent repeated-region identity and location for a finding.
RenderedDomLocation Tagged rendered-DOM node evidence within a snapshot epoch.
SourceTreeLocation Tagged HTML/XML tree evidence for a native finding coordinate.
TextRange Half-open Unicode-scalar offsets in decoded text, allowing empty ranges.
TextValue Owned decoded text emitted by a text projection.
TextWithCaptures Tagged text projection with named regular-expression captures.
TreeCoordinate Source-tree location with optional byte and expanded-name evidence.
Unknown Evidence completeness could not be established for the requested scope.
Name Summary
projected_values_equal Compare complete projection values with the Rust SDK’s equality rules.
projected_values_not_equal Return the complementary Rust projection comparison.
Name Summary
Completeness Tagged complete, partial, or unknown coverage of requested evidence. Complete coverage is scoped to the operation, not an exhaustive claim about a site.
DocumentClassName Serialized document capability names. Source HTML/XML/JSON/text, rendered DOM, and accessibility-tree evidence remain distinct.
IncompleteEvidence Partial or unknown evidence that cannot establish complete absence. Known loss and unestablished coverage remain distinct.
LocateFailure Alias for typed structural locator failure details, separate from match, complete absence, or indeterminate evidence.
LocateOutcome Tagged matches, complete no-match, indeterminate evidence, or typed failure. An empty convenience list alone cannot distinguish these states.
NativeCoordinate Tagged representation-native location: source tree, JSON Pointer, rendered DOM, accessibility node, or decoded-text ranges. Interpret it with its document identity and epoch.
PositiveU32 Strict positive u32 integer. Zero and numeric coercions are rejected; units belong to the consuming field.
ProjectedValue Tagged text, captured text, attribute, JSON, or document-bound node value. Projection identity retains information omitted by convenience value accessors.
ResourceLimit Locator resource classifications for byte, node, visit, query, region, match, capture, depth, and output accounting. Each named counter has its own units.
Name Summary
U32 Strict integer from zero through the u32 maximum. Booleans, floating-point values, and numeric strings are not coerced.
U64 Strict integer from zero through the u64 maximum, without numeric coercion. Units and evidence meaning belong to the consuming field.