#ifndef ZAI_SYMBOLS_H
#define ZAI_SYMBOLS_H
/**
 * zai_symbol_lookup is a single interface for access to Zend symbols:
 *  - classes (global, namespace)
 *  - functions (global, namespace, class, object)
 *  - constants (global, namespace, class, object)
 *  - properties (class, object)
 *  - locals (function static, frame)
 *
 * zai_symbol_call is a single interface for invocation
 *
 * zai_symbol_new is a single interface for object construction
 */
#include <php.h>
#include <stdbool.h>
#include <stdint.h>

#include "../zai_string/string.h"

// clang-format off
typedef enum {
    /* The return type is zend_class_entry* */
    ZAI_SYMBOL_TYPE_CLASS,
    /* The return type is zend_function* */
    ZAI_SYMBOL_TYPE_FUNCTION,
    /* The return type is zval* */
    ZAI_SYMBOL_TYPE_CONSTANT,
    /* The return type is zval* */
    ZAI_SYMBOL_TYPE_PROPERTY,
    /* The return type is zval* */
    ZAI_SYMBOL_TYPE_LOCAL,
} zai_symbol_type_t;

typedef enum {
    /* The next parameter is expected to be zend_class_entry* */
    ZAI_SYMBOL_SCOPE_CLASS,
    /* The next parameter is expected to be zval* and Z_TYPE_P is IS_OBJECT */
    ZAI_SYMBOL_SCOPE_OBJECT,
    /* The next parameter is expected to be null */
    ZAI_SYMBOL_SCOPE_GLOBAL,
    /* The next parameter is zai_str* */
    ZAI_SYMBOL_SCOPE_NAMESPACE,
    /* The next parameter is zend_execute_data* */
    ZAI_SYMBOL_SCOPE_FRAME,
    /* The next symbol is zend_function* with type == ZEND_USER_FUNCTION */
    ZAI_SYMBOL_SCOPE_STATIC,
} zai_symbol_scope_t;

/* LOOKUP */
void* zai_symbol_lookup(
        zai_symbol_type_t symbol_type,
        zai_symbol_scope_t scope_type, void *scope,
        zai_str *name);

#include "api/class.h"
#include "api/function.h"
#include "api/constant.h"
#include "api/property.h"
#include "api/local.h"

/* CALL */
typedef enum {
    /* The function parameter is zend_function* */
    ZAI_SYMBOL_FUNCTION_KNOWN,
    /* The function parameter is zai_str* */
    ZAI_SYMBOL_FUNCTION_NAMED,
    /* The function parameter is zval* Z_TYPE_P IS_OBJECT, instanceof zend_ce_closure */
    ZAI_SYMBOL_FUNCTION_CLOSURE,
} zai_symbol_function_t;

#define ZAI_SYMBOL_SANDBOX (1u << 31)

bool zai_symbol_call_impl(
    zai_symbol_scope_t scope_type, void *scope,
    zai_symbol_function_t function_type, void *function,
    zval *rv,
    uint32_t argc, va_list *args);

#if PHP_VERSION_ID >= 80200
zend_execute_data *zai_set_observed_frame(zend_execute_data *execute_data);
#endif
#if PHP_VERSION_ID >= 80000
void zai_reset_observed_frame_post_bailout(void);
#endif

#include "api/call.h"

bool zai_symbol_new(zval *zv, zend_class_entry *ce, uint32_t argc, ...);
// clang-format on
#endif  // ZAI_SYMBOLS_H