Document "build/ts" scripts

Author: Shigoto-dev19

scripts/build/ts/build-dev.sh

@@ -1,6 +1,21 @@
 #!/usr/bin/env bash
 set -Eeuo pipefail
 
+# Description:
+#   Builds the o1js TypeScript project for development. This script:
+#     - Compiles the TypeScript source files and outputs the compiled JavaScript to the `dist/` directory.
+#     - Copies prebuilt Node bindings from `src/bindings/compiled/node_bindings/`
+#       into `dist/node/bindings/compiled/node_bindings/`.
+#     - Copies the top-level TypeScript declaration file (`src/bindings.d.ts`)
+#       to `dist/node/` for type support.
+#
+# Notes:
+#   - Expects node bindings to be prebuilt(compiled by earlier build steps).
+#
+# Usage:
+#   npm run build:dev
+
+
 # shared ux library
 source ./scripts/lib/ux.sh
 

scripts/build/ts/build-node.sh

@@ -1,6 +1,20 @@
 #!/usr/bin/env bash
 set -Eeuo pipefail
 
+# Description:
+#   Builds the o1js project for Node.js usage. This script:
+#     - Ensures that the Node bindings are available:
+#         1. Checks for precompiled bindings locally.
+#         2. Attempts to download CI-built bindings via `npm run check:bindings` if missing.
+#         3. Falls back to building bindings locally via `npm run build:bindings-node` if necessary.
+#     - Cleans the `dist/node` directory to ensure a fresh build output.
+#     - Runs the development TypeScript build (`npm run build:dev`) to produce compiled JS in `dist/`.
+#     - Builds the final Node bundle via `src/build/build-node.js`.
+#
+# Usage:
+#   npm run build
+
+
 # shared libraries
 source ./scripts/lib/ux.sh
 

scripts/build/ts/build-web.sh

@@ -1,6 +1,16 @@
 #!/usr/bin/env bash
 set -Eeuo pipefail
 
+# Description:
+#   Builds the o1js project for Web (browser) usage. This script:
+#     - Cleans the existing `dist/web` directory to ensure a fresh build output.
+#     - Runs the web build process via `src/build/build-web.js`, generating the
+#       browser-compatible bundle and associated artifacts.
+#
+# Usage:
+#   npm run build:web
+
+
 # logging lib
 source ./scripts/lib/ux.sh
 setup_script "${BASH_SOURCE[0]}" "Web build"