Enum Selector 

pub enum Selector {
    Document,
    Page(u32),
    Object(u32),
    Stream(u32),
    Revision(u32),
    Member(u32),
    PackagePart(String),
    Relationship(String),
    ByteRange {
        offset: u64,
        len: u64,
    },
    TextMatch(String),
    Metadata,
    Text,
    Heading(u32),
    Block(u32),
    Table(u32),
    Cell {
        table: u32,
        row: u32,
        col: u32,
    },
    Resource(u32),
    Link(u32),
    SearchMatch(String),
}

A typed observation selector.

Variants

Document

The whole document.

Page(u32)

A page, by 1-based page number (as recovered by ingest).

Object(u32)

An indirect object, by object number.

Stream(u32)

An encoded stream, by owning object number.

Revision(u32)

A physical revision, by 0-based index.

Member(u32)

A package (ZIP/OCF/OPC) member, by central-directory ordinal. The ordinal is the physical identity; duplicate names stay distinct (Phase 12.2).

PackagePart(String)

A generic OPC package part, by absolute part name (Phase 12.3). Part-name equivalence is case-insensitive. Resolution is by the OPC relationship graph, never by a hardcoded path.

Relationship(String)

A generic OPC relationship, by id (Phase 12.3). Ids are only unique within one .rels part, so a duplicated id across owners is a typed ambiguity decline.

ByteRange

A half-open exact source byte range.

Fields

offset: u64

Start offset.

len: u64

Length in bytes.

TextMatch(String)

Every text line containing a pattern (case-sensitive).

Metadata

Common document-level metadata projection (format-neutral). Only the detected format’s native metadata is projected; the answer names the format and its native provenance (Phase 12.7, ADR-0031).

Text

Common whole-document reading-text projection.

Heading(u32)

Common the n-th heading in reading order (0-based).

Block(u32)

Common the n-th block (paragraph or table) in reading order (0-based).

Table(u32)

Common the n-th top-level table in reading order (0-based).

Cell

Common a table cell by 0-based table, row, and physical grid col.

Fields

table: u32

0-based table index in reading order.

row: u32

0-based row index.

col: u32

0-based physical column index (a DOCX grid column; an EPUB cell position).

Resource(u32)

Common the n-th embedded resource (image/embedded object) in reading order (0-based).

Link(u32)

Common the n-th hyperlink in reading order (0-based).

SearchMatch(String)

Common a deterministic, case-sensitive lexical search over the document’s reading text. Never an embedding or a model call.

Implementations

impl Selector

pub fn canonical(&self) -> String

Canonical selector text, e.g. page:1 or byte-range:10:4.

pub fn is_common(&self) -> bool

Whether this selector belongs to the format-neutral common vocabulary (Phase 12.7). Common selectors dispatch through the detected format’s adapter; native selectors are first-class peers, never fallbacks.

Trait Implementations

impl Clone for Selector

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 Selector

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

Formats the value using the given formatter.

impl Eq for Selector

impl PartialEq for Selector

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Selector