convert to external and add deprecated attr

Author: aspeddro

lib/es6/Stdlib.js

@@ -3,10 +3,6 @@
 import * as Stdlib_Error from "./Stdlib_Error.js";
 import * as Primitive_object from "./Primitive_object.js";
 
-function $$throw(prim) {
-  throw prim;
-}
-
 function assertEqual(a, b) {
   if (!Primitive_object.notequal(a, b)) {
     return;
@@ -15,7 +11,7 @@ function assertEqual(a, b) {
     RE_EXN_ID: "Assert_failure",
     _1: [
       "Stdlib.res",
-      118,
+      134,
       4
     ],
     Error: new Error()
@@ -158,7 +154,6 @@ export {
   $$BigInt64Array,
   $$BigUint64Array,
   panic,
-  $$throw,
   assertEqual,
 }
 /* No side effect */

lib/js/Stdlib.js

@@ -3,10 +3,6 @@
 let Stdlib_Error = require("./Stdlib_Error.js");
 let Primitive_object = require("./Primitive_object.js");
 
-function $$throw(prim) {
-  throw prim;
-}
-
 function assertEqual(a, b) {
   if (!Primitive_object.notequal(a, b)) {
     return;
@@ -15,7 +11,7 @@ function assertEqual(a, b) {
     RE_EXN_ID: "Assert_failure",
     _1: [
       "Stdlib.res",
-      118,
+      134,
       4
     ],
     Error: new Error()
@@ -157,6 +153,5 @@ exports.$$Uint8ClampedArray = $$Uint8ClampedArray;
 exports.$$BigInt64Array = $$BigInt64Array;
 exports.$$BigUint64Array = $$BigUint64Array;
 exports.panic = panic;
-exports.$$throw = $$throw;
 exports.assertEqual = assertEqual;
 /* No side effect */

runtime/Pervasives.res

@@ -12,7 +12,9 @@ external /* Internal */
 __unsafe_cast: 'a => 'b = "%identity"
 
 /* Exceptions */
-
+@deprecated(
+  "`raise` has been renamed to `throw` to align with JavaScript vocabulary. Please use `throw`"
+)
 external raise: exn => 'a = "%raise"
 
 @deprecated("Use custom exception instead")

runtime/Stdlib.res

@@ -100,7 +100,23 @@ async function main() {
 external import: 'a => promise<'a> = "%import"
 
 let panic = Error.panic
-let throw = Error.throw
+
+/**
+Throw and exception which will stop execution.
+
+## Examples
+
+```rescript
+let error = Error.make("Everything is upside down.")
+
+if 5 > 10 {
+  error->throw
+} else {
+  Console.log("Phew, sanity still rules.")
+}
+```
+*/
+external throw: Error.t => 'a = "%raise"
 
 /**
 `assertEqual(a, b)` check if `a` is equal `b`. If not raise a panic exception

runtime/Stdlib_Error.resi

@@ -155,7 +155,9 @@ if 5 > 10 {
 }
 ```
 */
-@deprecated("Use `Error.throw` instead.")
+@deprecated(
+  "`raise` has been renamed to `throw` to align with JavaScript vocabulary. Please use `throw`"
+)
 external raise: t => 'a = "%raise"
 
 /**