Document "build/jsoo" scripts

Author: Shigoto-dev19

scripts/build/jsoo/build-node.sh

@@ -1,7 +1,21 @@
 #!/usr/bin/env bash
-
 set -Eeuo pipefail
 
+# Description:
+#   Builds the Js_of_OCaml (JSOO) Node bindings for o1js. This script:
+#     - Compiles the OCaml `jsoo_exports` target using Dune to produce the
+#       `o1js_node.bc.js` JavaScript output.
+#     - Copies the generated artifact to `src/bindings/compiled/node_bindings/`
+#       for use by the Node.js runtime (after getting copied again later to dist/node/).
+#     - Creates a placeholder TypeScript declaration file (`.d.cts`) for type resolution.
+#     - Renames the output to CommonJS format (`.cjs`) and fixes internal references:
+#         - Updates WASM import paths.
+#         - Adjusts error-handling functions for Node compatibility.
+#
+# Usage:
+#   npm run build:jsoo:node
+
+
 source ./scripts/lib/ux.sh
 
 JSOO_PATH=./src/bindings/ocaml/jsoo_exports/

scripts/build/jsoo/build-web.sh

@@ -1,6 +1,20 @@
 #!/usr/bin/env bash
 set -Eeuo pipefail
 
+# Description:
+#   Builds the Js_of_OCaml (JSOO) Web bindings for o1js. This script:
+#     - Compiles the OCaml `jsoo_exports` target using Dune via Js_of_OCaml,
+#       producing the `o1js_web.bc.js` JavaScript output for browser environments.
+#     - Copies the generated artifact to `src/bindings/compiled/web_bindings/`
+#       for inclusion in the o1js web distribution (after getting copied again later to dist/web/).
+#     - Transforms OCaml-style exceptions into standard JavaScript `Error` objects
+#       to improve debugging and runtime compatibility.
+#     - Minifies the resulting JavaScript using `esbuild` for smaller bundle size.
+#
+# Usage:
+#   npm run build:jsoo:web
+
+
 source ./scripts/lib/ux.sh
 
 JSOO_PATH=./src/bindings/ocaml/jsoo_exports/