parser.h

#ifndef PARSER_H
#define PARSER_H

#include "ast.h"            // Defines the Abstract Syntax Tree (AST) structures used during parsing
#include "tokenizer.h"      // Provides token definitions and token list used as input for the parser

// Global flag set to 1 if a parsing error is encountered
extern int parseErrorFlag;

// Structure representing the parser state.
typedef struct {
    Token* tokens;      // tokens: list of tokens to be parsed
    int count;          // count: total number of tokens
    int pos;            // pos: current parsing position (index in the token list)
} Parser;

// Creates and initializes a parser with a given list of tokens and their count.
Parser* createParser(Token* tokens, int count);

// Frees memory allocated for the parser structure.
void freeParser(Parser* parser);

// Parses the a single statement from token list. 
AST* parseStatement(Parser* parser);

// Parses an entire Plus++ program starting from the top-level token.
AST* parseProgram(Parser* parser); 

// Frees memory allocated for the AST structure.
void freeAst(AST* ast);

#endif