schema.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stddef.h>
#include "../common.h"
#include "../options/options.h"
#include "../options/builder.h"

typedef enum {
  OPTION_CONTEXT_CLI,    
  OPTION_CONTEXT_CONFIG, 
  OPTION_CONTEXT_BOTH,   
} option_context_t;

typedef bool (*builder_validate_fn_t)(const void *options_struct);

typedef struct {
  const char *toml_key;     
  const char *cli_flag;     
  option_type_t type;       
  option_context_t context; 
  const char *category;     
  size_t field_offset;      
  size_t field_size;        
 
  // Validation - uses builder's validate function directly
  builder_validate_fn_t validate_fn; 
 
  // Custom parsing for OPTION_TYPE_CALLBACK
  bool (*parse_fn)(const char *arg, void *dest, char **error_msg); 
 
  // Mode applicability bitmask
  option_mode_bitmask_t mode_bitmask; 
 
  // Documentation
  const char *description; 
 
  // Type-specific constraints (optional)
  union {
    struct {
      int min;
      int max;
    } int_range;
    struct {
      double min;
      double max;
    } float_range;
  } constraints;
 
  // Mode-aware default getter (for options with mode-specific defaults)
  const void *(*mode_default_getter)(
      asciichat_mode_t mode); 
} config_option_metadata_t;

const config_option_metadata_t *config_schema_get_by_toml_key(const char *toml_key);

const config_option_metadata_t **config_schema_get_by_category(const char *category, size_t *count);

const config_option_metadata_t *config_schema_get_all(size_t *count);

asciichat_error_t config_schema_build_from_configs(const options_config_t **configs, size_t num_configs);

void config_schema_destroy(void);