#ifndef ARC_STD_PARSER_H_
#define ARC_STD_PARSER_H_

#ifdef __cplusplus
extern "C" {
#endif

#include "arc/std/array.h"
//#include "arc/std/bool.h"
#include "arc/std/lexer.h"
#include <stdint.h>

/**
 * @brief a parser type
*/
typedef struct ARC_Parser ARC_Parser;

/**
 * @brief TODO: write this
*/
typedef void (* ARC_ParserData_CreateFn)(void **data);

/**
 * @brief TODO: write this
*/
typedef void (* ARC_ParserData_DestroyFn)(void *data);

/**
 * @brief TODO: write this
*/
typedef void (* ARC_ParserLanguageTag_AddDataFn)(void **data, uint32_t tagId, ARC_LexerToken *token);

/**
 * @brief a langue tag type for the parser //TODO: explain this better
*/
typedef struct ARC_ParserLanguageTag {
  uint32_t tagId;

  uint32_t **tokensOrTags;
  uint32_t tokensOrTagsSize;

  ARC_ParserLanguageTag_AddDataFn *addDataFn;
} ARC_ParserLanguageTag;

/**
 * @brief a callback function to initialize the lexer the parser uses with rules
 *
 * @param lexer the lexer used by the parser that rules should be added to
*/
typedef void (* ARC_Parser_InitLexerRulesFn)(ARC_Lexer *lexer);

/**
 * @brief creates an ARC_Parser type
 *
 * @TODO: fix this documentation to reflect changes
 *
 * @TODO: probs want to move the note to another file
 * @note array of tokens for langauge? like 
 * ARC_ParserTag tag = {
 *  VARIABLE_NAME, //tagId
 *  {
 *   { 2, CHAR_OR_NUM, VARIABLE_NAME },
 *   { 1, LAMBDA },
 *  }, //components
 *  2 //componentsSize
 * };
 *
 * @param[out] parser           ARC_Parser to create
 * @param[in]  language         an arry of ARC_ParserLanguageTags defining a langauge
 * @param[in]  initLexerRulesFn a callback used to initalize the token rules the lexer within the parser will use
*/
void ARC_Parser_Create(ARC_Parser **parser, ARC_Array *language, ARC_Parser_InitLexerRulesFn initLexerRulesFn, ARC_ParserData_CreateFn *createDataFn, ARC_ParserData_DestroyFn *destroyDataFn);

/**
 * @brief creates an ARC_Parser type from a string
 *
 * @TODO: probs want to move the note to another file
 * @note the syntax looks like:
 *       <variable>     -> CHAR <variableName> EOF
 *       <variableName> -> <charOrNum> <variableName> | LAMBDA
 *       <charOrNum>    -> CHAR | NUM
 *
 * @param[out] parser           ARC_Parser to create
 * @param[in]  language         an arry of ARC_ParserLanguageTags defining a langauge
 * @param[in]  initLexerRulesFn a callback used to initalize the token rules the lexer within the parser will use
*/
void ARC_Parser_CreateFromString(ARC_Parser **parser, ARC_String *languageString, ARC_Parser_InitLexerRulesFn initLexerRulesFn);

/**
 * @brief destroys an ARC_Parser type
 *
 * @param[in] parser ARC_Parser to free
*/
void ARC_Parser_Destroy(ARC_Parser *parser);

/**
 * @brief 
 *
 * @param[in]     parser 
 * @param[in/out] data   the string to parse, will be freed and set to NULL by the end of this function
*/
void ARC_Parser_Parse(ARC_Parser *parser, ARC_String **data);

/**
 * @brief 
 *
 * @param[in] parser   
 * @param[in] language 
*/
void ARC_Parser_ParseFile(ARC_Parser *parser, ARC_String *path);

/**
 * @brief 
 *
 * @param[in] parser 
*/
void ARC_Parser_ClearData(ARC_Parser *parser);

/**
 * @brief 
 *
 * @param[in] parser 
*/
void *ARC_Parser_GetData(ARC_Parser *parser);

/**
 * @brief basic tag for letting the parser know it is ok to end
*/
#define ARC_PARSER_TAG_LAMBDA 0

#ifdef __cplusplus
}
#endif

#endif // !ARC_STD_PARSER_H_