Enum ReasonCode 

#[non_exhaustive]
pub enum ReasonCode {
    Ok,
    NativeTextHighConfidence,
    NoTextLayerPresent,
    TextLayerBelowThreshold,
    GlyphMappingMissing,
    EncryptedNoExtractPermission,
    ImageTableReconstructed,
    ImageTableNoStructure,
    ChartNotTranscribed,
    OcrRequestedButUnavailable,
    OcrLowConfidenceFallback,
    Empty,
}

Machine-readable why for a region/page result — the #1 cross-tool user-pain fix. A non-degraded result is Ok; any degraded one must name the cause. #[non_exhaustive], frozen snake_case wire tokens (append-only — never renumber/rename, the PadesLevel lesson).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Ok

Extracted cleanly.

NativeTextHighConfidence

Native text present and high-confidence.

NoTextLayerPresent

No text layer on the page at all.

TextLayerBelowThreshold

Text layer present but below the usable-quality threshold.

GlyphMappingMissing

Glyphs without usable ToUnicode/(cid:NN)/garbled mapping.

EncryptedNoExtractPermission

Encrypted and not authorised to extract.

ImageTableReconstructed

An image-table was reconstructed into TableData.

ImageTableNoStructure

A table region was detected but structure could not be recovered (graceful — heuristic fallback used, not fail-loud).

ChartNotTranscribed

A chart/figure was detected; its internal data is not transcribed (honest scope boundary — placeholder emitted).

OcrRequestedButUnavailable

OCR was needed but unavailable (feature off / models absent / mode = TextOnly) → fell back to native text + warned.

OcrLowConfidenceFallback

OCR ran but confidence was low → native used/merged.

Empty

Region/page yielded no recoverable content.

Trait Implementations

impl Clone for ReasonCode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReasonCode

impl Debug for ReasonCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ReasonCode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ReasonCode

impl PartialEq for ReasonCode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ReasonCode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ReasonCode