leo-ast 4.0.2

// Copyright (C) 2019-2026 Provable Inc.
// This file is part of the Leo library.

// The Leo library is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.

// The Leo library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.

// You should have received a copy of the GNU General Public License
// along with the Leo library. If not, see <https://www.gnu.org/licenses/>.

//! This module contains a Consumer trait for the AST.
//! Consumers are used to completely transform the AST without any restrictions on the output.

use crate::*;

/// A Consumer trait for expressions in the AST.
pub trait ExpressionConsumer {
    type Output;

    fn consume_expression(&mut self, input: Expression) -> Self::Output {
        match input {
            Expression::Array(array) => self.consume_array(array),
            Expression::ArrayAccess(access) => self.consume_array_access(*access),
            Expression::Async(async_) => self.consume_async(async_),
            Expression::Binary(binary) => self.consume_binary(*binary),
            Expression::Call(call) => self.consume_call(*call),
            Expression::DynamicCall(dc) => self.consume_dynamic_call(*dc),
            Expression::Cast(cast) => self.consume_cast(*cast),
            Expression::Composite(composite_) => self.consume_composite_init(composite_),
            Expression::Err(err) => self.consume_err(err),
            Expression::Path(path) => self.consume_path(path),
            Expression::Literal(value) => self.consume_literal(value),
            Expression::MemberAccess(access) => self.consume_member_access(*access),
            Expression::Repeat(repeat) => self.consume_repeat(*repeat),
            Expression::Ternary(ternary) => self.consume_ternary(*ternary),
            Expression::Tuple(tuple) => self.consume_tuple(tuple),
            Expression::TupleAccess(access) => self.consume_tuple_access(*access),
            Expression::Unary(unary) => self.consume_unary(*unary),
            Expression::Unit(unit) => self.consume_unit(unit),
            Expression::Intrinsic(intrinsic) => self.consume_intrinsic(*intrinsic),
        }
    }

    fn consume_array_access(&mut self, _input: ArrayAccess) -> Self::Output;

    fn consume_member_access(&mut self, _input: MemberAccess) -> Self::Output;

    fn consume_tuple_access(&mut self, _input: TupleAccess) -> Self::Output;

    fn consume_async(&mut self, _input: AsyncExpression) -> Self::Output;

    fn consume_array(&mut self, _input: ArrayExpression) -> Self::Output;

    fn consume_binary(&mut self, _input: BinaryExpression) -> Self::Output;

    fn consume_call(&mut self, _input: CallExpression) -> Self::Output;

    fn consume_dynamic_call(&mut self, _input: DynamicCallExpression) -> Self::Output;

    fn consume_cast(&mut self, _input: CastExpression) -> Self::Output;

    fn consume_composite_init(&mut self, _input: CompositeExpression) -> Self::Output;

    fn consume_err(&mut self, _input: ErrExpression) -> Self::Output {
        panic!("`ErrExpression`s should not be in the AST at this phase of compilation.")
    }

    fn consume_path(&mut self, _input: Path) -> Self::Output;

    fn consume_literal(&mut self, _input: Literal) -> Self::Output;

    fn consume_repeat(&mut self, _input: RepeatExpression) -> Self::Output;

    fn consume_intrinsic(&mut self, _input: IntrinsicExpression) -> Self::Output;

    fn consume_ternary(&mut self, _input: TernaryExpression) -> Self::Output;

    fn consume_tuple(&mut self, _input: TupleExpression) -> Self::Output;

    fn consume_unary(&mut self, _input: UnaryExpression) -> Self::Output;

    fn consume_unit(&mut self, _input: UnitExpression) -> Self::Output;
}

/// A Consumer trait for statements in the AST.
pub trait StatementConsumer {
    type Output;

    fn consume_statement(&mut self, input: Statement) -> Self::Output {
        match input {
            Statement::Assert(assert) => self.consume_assert(assert),
            Statement::Assign(stmt) => self.consume_assign(*stmt),
            Statement::Block(stmt) => self.consume_block(stmt),
            Statement::Conditional(stmt) => self.consume_conditional(stmt),
            Statement::Const(stmt) => self.consume_const(stmt),
            Statement::Definition(stmt) => self.consume_definition(stmt),
            Statement::Expression(stmt) => self.consume_expression_statement(stmt),
            Statement::Iteration(stmt) => self.consume_iteration(*stmt),
            Statement::Return(stmt) => self.consume_return(stmt),
        }
    }

    fn consume_assert(&mut self, input: AssertStatement) -> Self::Output;

    fn consume_assign(&mut self, input: AssignStatement) -> Self::Output;

    fn consume_block(&mut self, input: Block) -> Self::Output;

    fn consume_conditional(&mut self, input: ConditionalStatement) -> Self::Output;

    fn consume_const(&mut self, input: ConstDeclaration) -> Self::Output;

    fn consume_definition(&mut self, input: DefinitionStatement) -> Self::Output;

    fn consume_expression_statement(&mut self, input: ExpressionStatement) -> Self::Output;

    fn consume_iteration(&mut self, input: IterationStatement) -> Self::Output;

    fn consume_return(&mut self, input: ReturnStatement) -> Self::Output;
}

/// A Consumer trait for functions in the AST.
pub trait FunctionConsumer {
    type Output;

    fn consume_function(&mut self, input: Function) -> Self::Output;
}

/// A Consumer trait for interfaces in the AST.
pub trait InterfaceConsumer {
    type Output;

    fn consume_interface(&mut self, input: Interface) -> Self::Output;
}

/// A Consumer trait for constructors in the AST.
pub trait ConstructorConsumer {
    type Output;

    fn consume_constructor(&mut self, input: Constructor) -> Self::Output;
}

/// A Consumer trait for composites in the AST.
pub trait CompositeConsumer {
    type Output;

    fn consume_composite(&mut self, input: Composite) -> Self::Output;
}

/// A Consumer trait for imported programs in the AST.
pub trait ImportConsumer {
    type Output;

    fn consume_import(&mut self, input: Program) -> Self::Output;
}

/// A Consumer trait for mappings in the AST.
pub trait MappingConsumer {
    type Output;

    fn consume_mapping(&mut self, input: Mapping) -> Self::Output;
}

/// A Consumer trait for program scopes in the AST.
pub trait ProgramScopeConsumer {
    type Output;

    fn consume_program_scope(&mut self, input: ProgramScope) -> Self::Output;
}

/// A Consumer trait for the program represented by the AST.
pub trait ProgramConsumer {
    type Output;
    fn consume_program(&mut self, input: Program) -> Self::Output;
}

/// A Consumer trait for a library in the AST.
pub trait LibraryConsumer {
    type Output;
    fn consume_library(&mut self, input: Library) -> Self::Output;
}

/// A Consumer trait for a stub in the AST.
pub trait StubConsumer {
    type Output;
    fn consume_stub(&mut self, input: Stub) -> Self::Output;
}

/// A Consumer trait for modules in the AST.
pub trait ModuleConsumer {
    type Output;
    fn consume_module(&mut self, input: Module) -> Self::Output;
}