add doc strings for json module (#75)

* add doc strings for json module

* changed type of the reviver function

* add @raises annotation also in res file

* remove parseToAnyExn and parseToAnyExnWithReviver

* change type of replacer

* add stringifyWithFilter functions

* fix formatting

* fix wording

* remove JSON.Encode.any and changed JSON.parseExnWithReviver accordingly

* examples: change Js.Exn to Exn, remove whitespace in comment

* add exceptions block to functions which will throw errors

* Update src/Core__JSON.resi

Co-authored-by: Gabriel Nordeborn <[email protected]>

* Update src/Core__JSON.resi

Co-authored-by: Gabriel Nordeborn <[email protected]>

* Update src/Core__JSON.resi

Co-authored-by: Gabriel Nordeborn <[email protected]>

* Update src/Core__JSON.resi

Co-authored-by: Gabriel Nordeborn <[email protected]>

* Update src/Core__JSON.resi

Co-authored-by: Gabriel Nordeborn <[email protected]>

* Update src/Core__JSON.resi

Co-authored-by: Gabriel Nordeborn <[email protected]>

* Update src/Core__JSON.resi

Co-authored-by: Gabriel Nordeborn <[email protected]>

* fix: change Exn.Error to Exn.t

---------

Co-authored-by: Gabriel Nordeborn <[email protected]>

Author: dkirchhof

src/Core__JSON.res

@@ -1,27 +1,25 @@
 type t = Js.Json.t
 
-type jsonReviver
-external asJsonReviver: 'a => jsonReviver = "%identity"
-type jsonReplacer
-external asJsonReplacer: 'a => jsonReplacer = "%identity"
-
-@val external parseExn: string => t = "JSON.parse"
-@val external parseExnWithReviver: (string, jsonReviver) => t = "JSON.parse"
+@raises @val external parseExn: string => t = "JSON.parse"
+@raises @val external parseExnWithReviver: (string, (string, t) => t) => t = "JSON.parse"
 @val external stringify: t => string = "JSON.stringify"
 @val external stringifyWithIndent: (t, @as(json`null`) _, int) => string = "JSON.stringify"
-@val external stringifyWithReplacer: (t, jsonReplacer) => string = "JSON.stringify"
-@val external stringifyWithReplacerAndIndent: (t, jsonReplacer, int) => string = "JSON.stringify"
-
-@val external parseToAnyExn: string => 'a = "JSON.parse"
-@val external parseToAnyExnWithReviver: (string, jsonReviver) => 'a = "JSON.parse"
-@val external stringifyAny: 'a => option<string> = "JSON.stringify"
+@val external stringifyWithReplacer: (t, (string, t) => t) => string = "JSON.stringify"
 @val
+external stringifyWithReplacerAndIndent: (t, (string, t) => t, int) => string = "JSON.stringify"
+@val external stringifyWithFilter: (t, array<string>) => string = "JSON.stringify"
+@val external stringifyWithFilterAndIndent: (t, array<string>, int) => string = "JSON.stringify"
+@raises @val external stringifyAny: 'a => option<string> = "JSON.stringify"
+@raises @val
 external stringifyAnyWithIndent: ('a, @as(json`null`) _, int) => option<string> = "JSON.stringify"
-@val
-external stringifyAnyWithReplacer: ('a, jsonReplacer) => option<string> = "JSON.stringify"
-@val
-external stringifyAnyWithReplacerAndIndent: ('a, jsonReplacer, int) => option<string> =
+@raises @val
+external stringifyAnyWithReplacer: ('a, (string, t) => t) => option<string> = "JSON.stringify"
+@raises @val
+external stringifyAnyWithReplacerAndIndent: ('a, (string, t) => t, int) => option<string> =
   "JSON.stringify"
+@raises @val external stringifyAnyWithFilter: ('a, array<string>) => string = "JSON.stringify"
+@raises @val
+external stringifyAnyWithFilterAndIndent: ('a, array<string>, int) => string = "JSON.stringify"
 
 module Classify = {
   type t =