(************************************************************************)
(*         *   The Coq Proof Assistant / The Coq Development Team       *)
(*  v      *   INRIA, CNRS and contributors - Copyright 1999-2019       *)
(* <O___,, *       (see CREDITS file for the list of authors)           *)
(*   \VV/  **************************************************************)
(*    //   *    This file is distributed under the terms of the         *)
(*         *     GNU Lesser General Public License Version 2.1          *)
(*         *     (see LICENSE file for the text of the license)         *)
(************************************************************************)

open Names
open Decl_kinds

type locality = Discharge | Global of Declare.import_status

(** Declaration hooks *)
module Hook : sig
  type t

  (** Hooks allow users of the API to perform arbitrary actions at
     proof/definition saving time. For example, to register a constant
     as a Coercion, perform some cleanup, update the search database,
     etc...  *)
  module S : sig
    (** [S.t] passes to the client: *)
    type t
      =  UState.t
      (** [ustate]: universe constraints obtained when the term was closed *)
      -> (Id.t * Constr.t) list
      (** [(n1,t1),...(nm,tm)]: association list between obligation
          name and the corresponding defined term (might be a constant,
          but also an arbitrary term in the Expand case of obligations) *)
      -> locality
      (**  [locality]: Locality of the original declaration *)
      -> GlobRef.t
      (** [ref]: identifier of the original declaration *)
      -> unit
  end

  val make : S.t -> t
  val call : ?hook:t -> ?fix_exn:Future.fix_exn -> S.t
end

val declare_definition
  :  name:Id.t
  -> scope:locality
  -> kind:definition_object_kind
  -> ?hook_data:(Hook.t * UState.t * (Id.t * Constr.t) list)
  -> UnivNames.universe_binders
  -> Evd.side_effects Proof_global.proof_entry
  -> Impargs.manual_implicits
  -> GlobRef.t

val declare_fix
  :  ?opaque:bool
  -> ?hook_data:(Hook.t * UState.t * (Id.t * Constr.t) list)
  -> name:Id.t
  -> scope:locality
  -> kind:definition_object_kind
  -> UnivNames.universe_binders
  -> Entries.universes_entry
  -> Evd.side_effects Entries.proof_output
  -> Constr.types
  -> Impargs.manual_implicits
  -> GlobRef.t

val prepare_definition : allow_evars:bool ->
  ?opaque:bool -> ?inline:bool -> poly:bool ->
  Evd.evar_map -> UState.universe_decl ->
  types:EConstr.t option -> body:EConstr.t ->
  Evd.evar_map * Evd.side_effects Proof_global.proof_entry

val prepare_parameter : allow_evars:bool ->
  poly:bool -> Evd.evar_map -> UState.universe_decl -> EConstr.types ->
  Evd.evar_map * Entries.parameter_entry