stoolap 0.4.0

// Copyright 2025 Stoolap Contributors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

// Compiled Expression VM - Complete Replacement for AST Evaluator
//
// This module provides a high-performance expression evaluation system that
// completely replaces the recursive AST evaluator with a compiled, stack-based VM.
//
// Design Goals:
// 1. ZERO RECURSION - All expressions compile to linear instruction sequences
// 2. MINIMAL ALLOCATION - Reuse stack, pre-allocate everything possible
// 3. FAST DISPATCH - Direct enum match, no string comparisons
// 4. COMPLETE COVERAGE - Handle ALL expression types including subqueries
//
// Architecture:
//
//   ┌─────────────┐     ┌──────────────┐     ┌─────────────┐
//   │ Expression  │ ──► │ ExprCompiler │ ──► │   Program   │
//   │    (AST)    │     │              │     │  (bytecode) │
//   └─────────────┘     └──────────────┘     └─────────────┘
//                                                   │
//                                                   ▼
//   ┌─────────────┐     ┌──────────────┐     ┌─────────────┐
//   │   Result    │ ◄── │    ExprVM    │ ◄── │  Row Data   │
//   │   (Value)   │     │              │     │             │
//   └─────────────┘     └──────────────┘     └─────────────┘

mod compiler;
mod evaluator_bridge;
mod ops;
mod program;
mod vm;

pub use compiler::{is_non_foldable_function, CompileContext, CompileError, ExprCompiler};
pub use evaluator_bridge::{
    clear_program_cache, compile_expression, compile_expression_with_context,
    compute_expression_hash, try_eval_constant_expr, CompiledEvaluator, ExpressionEval, JoinFilter,
    MultiExpressionEval, RowFilter, SharedProgram,
};
pub use ops::Op;
pub use program::{Constant, Program};
pub use vm::{ExecuteContext, ExprVM, SubqueryExecutor};

#[cfg(test)]
mod tests;