typedef enum json_type {
	JSON_HASH, JSON_ARRAY, JSON_NUMBER, JSON_STRING, JSON_TRUE, JSON_FALSE, JSON_NULL,
	JSON_COMMA, JSON_COLON, JSON_ITEM, JSON_KEY, JSON_VALUE,
} json_type;

typedef struct json_object {
	json_type type;
	struct json_object *parent;

	char *string;
	double number;

	struct json_object **array;
	struct json_object **keys;
	struct json_object **values;
	int length;

	int expect;
} json_object;

struct json_pull {
	json_object *root;
	char *error;

	int (*read)(struct json_pull *);
	int (*peek)(struct json_pull *);
	void *source;
	int line;

	json_object *container;
};
typedef struct json_pull json_pull;

typedef void (*json_separator_callback)(json_type type, json_pull *j, void *state);

json_pull *json_begin_file(FILE *f);
json_pull *json_begin_string(char *s);
json_object *json_parse(json_pull *j);
json_object *json_parse_with_separators(json_pull *j, json_separator_callback cb, void *state);
void json_free(json_object *j);

json_object *json_hash_get(json_object *o, char *s);

typedef enum json_type {
	// These types can be returned by json_parse()
	JSON_HASH, JSON_ARRAY, JSON_NUMBER, JSON_STRING, JSON_TRUE, JSON_FALSE, JSON_NULL,

	// These and JSON_HASH and JSON_ARRAY can be called back by json_parse_with_separators()
	JSON_COMMA, JSON_COLON,

	// These are only used internally as expectations of what comes next
	JSON_ITEM, JSON_KEY, JSON_VALUE,
} json_type;

typedef struct json_object {
	json_type type;
	struct json_object *parent;

	char *string;
	double number;

	struct json_object **array;
	struct json_object **keys;
	struct json_object **values;
	int length;

	int expect;
} json_object;

struct json_pull {
	json_object *root;
	char *error;

	int (*read)(struct json_pull *);
	int (*peek)(struct json_pull *);
	void *source;
	int line;

	json_object *container;
};
typedef struct json_pull json_pull;

typedef void (*json_separator_callback)(json_type type, json_pull *j, void *state);

json_pull *json_begin_file(FILE *f);
json_pull *json_begin_string(char *s);
json_object *json_parse(json_pull *j);
json_object *json_parse_with_separators(json_pull *j, json_separator_callback cb, void *state);
void json_free(json_object *j);

json_object *json_hash_get(json_object *o, char *s);

Clarify what types are used where
Clarify what types are used where
