Enum CompiledNode 

pub enum CompiledNode {
    Value {
        value: Value,
    },
    Array {
        nodes: Box<[CompiledNode]>,
    },
    BuiltinOperator {
        opcode: OpCode,
        args: Box<[CompiledNode]>,
    },
    CustomOperator(Box<CustomOperatorData>),
    StructuredObject(Box<StructuredObjectData>),
    CompiledVar {
        scope_level: u32,
        segments: Box<[PathSegment]>,
        reduce_hint: ReduceHint,
        metadata_hint: MetadataHint,
        default_value: Option<Box<CompiledNode>>,
    },
    CompiledExists(Box<CompiledExistsData>),
    CompiledSplitRegex(Box<CompiledSplitRegexData>),
    CompiledThrow(Box<Value>),
}

A compiled node representing a single operation or value in the logic tree.

Nodes are created during the compilation phase and evaluated during execution. Each node type is optimized for its specific purpose:

• Value: Static JSON values that don’t require evaluation
• Array: Collections of nodes evaluated sequentially
• BuiltinOperator: Fast OpCode-based dispatch for built-in operators
• CustomOperator: User-defined operators with dynamic dispatch
• StructuredObject: Template objects for structure preservation

Variants

Value

A static JSON value that requires no evaluation.

Used for literals like numbers, strings, booleans, and null.

Fields

value: Value

Array

An array of compiled nodes.

Each node is evaluated in sequence, and the results are collected into a JSON array. Uses Box<[CompiledNode]> for memory efficiency.

Fields

nodes: Box<[CompiledNode]>

BuiltinOperator

A built-in operator optimized with OpCode dispatch.

The OpCode enum enables direct dispatch without string lookups, significantly improving performance for the 50+ built-in operators.

Fields

opcode: OpCode

args: Box<[CompiledNode]>

CustomOperator(Box<CustomOperatorData>)

A custom operator registered via DataLogic::add_operator. Boxed to reduce enum size (rare variant).

StructuredObject(Box<StructuredObjectData>)

A structured object template for preserve_structure mode. Boxed to reduce enum size (rare variant).

CompiledVar

A pre-compiled variable access (unified var/val).

scope_level 0 = current context (var-style), N = go up N levels (val with [[N], …]). Segments are pre-parsed at compile time to avoid runtime string splitting.

Fields

scope_level: u32

segments: Box<[PathSegment]>

reduce_hint: ReduceHint

metadata_hint: MetadataHint

default_value: Option<Box<CompiledNode>>

CompiledExists(Box<CompiledExistsData>)

A pre-compiled exists check. Boxed to reduce enum size (rare variant).

CompiledSplitRegex(Box<CompiledSplitRegexData>)

A pre-compiled split with regex pattern. Boxed to reduce enum size (rare variant).

CompiledThrow(Box<Value>)

A pre-compiled throw with a static error object. Boxed to reduce enum size (rare variant).

Trait Implementations

impl Clone for CompiledNode

fn clone(&self) -> CompiledNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompiledNode

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

Formats the value using the given formatter.