(** JSON utility functions for working with Ezjsonm.
    
    This module provides convenience combinators that combine common
    Ezjsonm operations. Most functions are thin wrappers that combine
    find/get operations or provide Option-based error handling. *)

(** {2 Finding values by path}
    
    These combine [Ezjsonm.find] with type extraction functions. *)

val find_string : Ezjsonm.value -> string list -> string
val find_int : Ezjsonm.value -> string list -> int
val find_bool : Ezjsonm.value -> string list -> bool
val find_float : Ezjsonm.value -> string list -> float

val find_string_opt : Ezjsonm.value -> string list -> string option
val find_int_opt : Ezjsonm.value -> string list -> int option
val find_bool_opt : Ezjsonm.value -> string list -> bool option
val find_float_opt : Ezjsonm.value -> string list -> float option

(** {2 Association list operations} *)

val assoc_string : string -> (string * Ezjsonm.value) list -> string
val assoc_int : string -> (string * Ezjsonm.value) list -> int
val assoc_bool : string -> (string * Ezjsonm.value) list -> bool
val assoc_float : string -> (string * Ezjsonm.value) list -> float

val assoc_string_opt : string -> (string * Ezjsonm.value) list -> string option
val assoc_int_opt : string -> (string * Ezjsonm.value) list -> int option
val assoc_bool_opt : string -> (string * Ezjsonm.value) list -> bool option
val assoc_float_opt : string -> (string * Ezjsonm.value) list -> float option

(** {2 Object field operations}
    
    Direct field access without needing to build paths. *)

(** Alias for [Ezjsonm.get_dict] *)
val get_fields : Ezjsonm.value -> (string * Ezjsonm.value) list

val get_field : Ezjsonm.value -> string -> Ezjsonm.value
val get_field_opt : Ezjsonm.value -> string -> Ezjsonm.value option

val get_field_string : Ezjsonm.value -> string -> string
val get_field_int : Ezjsonm.value -> string -> int
val get_field_bool : Ezjsonm.value -> string -> bool
val get_field_float : Ezjsonm.value -> string -> float

val get_field_string_opt : Ezjsonm.value -> string -> string option
val get_field_int_opt : Ezjsonm.value -> string -> int option
val get_field_bool_opt : Ezjsonm.value -> string -> bool option
val get_field_float_opt : Ezjsonm.value -> string -> float option