Common.throw() Function

.changeset/smooth-fireants-flash.md

@@ -0,0 +1,5 @@
+---
+"@quri/squiggle-lang": patch
+---
+
+Added Common.throw

packages/squiggle-lang/src/fr/builtin.ts → packages/squiggle-lang/src/fr/common.ts

@@ -55,4 +55,22 @@ export const library = [
       ),
     ],
   }),
+  maker.make({
+    name: "throw",
+    description:
+      "Throws a fatal error. There is no way in the language to catch this error.",
+    definitions: [
+      makeDefinition(
+        [frOptional(frNamed("message", frString))],
+        frAny(),
+        ([value]) => {
+          if (value) {
+            throw new Error(value);
+          } else {
+            throw new Error("Common.throw() was called");
+          }
+        }
+      ),
+    ],
+  }),
 ];

packages/squiggle-lang/src/library/registry/index.ts

@@ -1,5 +1,5 @@
 import { library as booleanLibrary } from "../../fr/boolean.js";
-import { library as builtinLibrary } from "../../fr/builtin.js";
+import { library as commonLibrary } from "../../fr/common.js";
 import { library as calculatorLibrary } from "../../fr/calculator.js";
 import { library as dangerLibrary } from "../../fr/danger.js";
 import { library as dateLibrary } from "../../fr/date.js";
@@ -54,7 +54,7 @@ const fnList: FRFunction[] = [
   ...unitsLibrary,
   ...calculatorLibrary,
   ...inputLibrary,
-  ...builtinLibrary, // should go last, because has some catch-all functions
+  ...commonLibrary, // should go last, because has some catch-all functions
 ];
 
 export const registry = Registry.make(fnList);