Struct OpPlan 

pub struct OpPlan {
    pub ops: Vec<Op>,
}

Sequential pipeline of ops. The first op produces an initial state (no input bitmap; ops at position 0 run with a universal “all” state so loaders fold via AND). Build via the fluent API; finalise with optimize() then run().

Fields

ops: Vec<Op>

Ops applied in document order. Public so callers can introspect the optimiser’s output for testing / debugging.

Implementations

impl OpPlan

pub fn new() -> Self

Create an empty plan. Each call appends an op.

pub fn push(self, op: Op) -> Self

Append a raw op. Most callers use the fluent helpers below.

pub fn anchor(self, root: TokenId) -> Self

Anchor the plan at a single token (typically the root or a result from a prior subquery).

pub fn all(self) -> Self

Set state to “every token in the document”.

pub fn by_key(self, name: &str) -> Self

Restrict to tokens that are object keys with the given name.

pub fn at_depth(self, d: u16) -> Self

Restrict to tokens at the given nesting depth.

pub fn within(self, root: TokenId) -> Self

Restrict to tokens inside the subtree rooted at root.

pub fn descend(self) -> Self

Expand each token to its full subtree (descendant operator).

pub fn children(self) -> Self

Expand each container to its immediate child tokens.

pub fn field(self, name: &str) -> Self

Drill into the named field — for each container in state, take the value bound to that key.

pub fn value_eq(self, lit: &[u8]) -> Self

Filter state to tokens whose byte span equals lit (string-aware).

pub fn first(self) -> Self

Reduce to the smallest token id.

pub fn last(self) -> Self

Reduce to the largest token id.

pub fn nth(self, k: u32) -> Self

Reduce to the k-th token id in ascending order.

pub fn count(self) -> Self

Reduce to a singleton bitmap encoding the cardinality of state.

pub fn optimize(self) -> Self

Algebraic optimiser. Fixed-point local rewrites.

pub fn run(&self, idx: &StructuralIndex, bytes: &[u8]) -> Bitmap

Run the plan against a StructuralIndex + bytes.

Trait Implementations

impl Clone for OpPlan

fn clone(&self) -> OpPlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpPlan

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

Formats the value using the given formatter.

impl Default for OpPlan

fn default() -> OpPlan

Returns the “default value” for a type.