chore: add script to build all examples and improve parcel build process (#223)

- Add a script to build all example projects at once, simplifying the
build process.
- Ensure the "shared" package is built first, as it is required by all
examples.
- The script lists the size of the generated JavaScript files, making it
easier to compare bundle sizes across different maxGraph versions.
- Update the Parcel build to always clean the dist folder before
building, as Parcel does not do this automatically. This prevents
outdated files from previous builds from being included.

Author: tbouffard

README.md

@@ -26,6 +26,11 @@ Build the "shared" package:
 - this package is used in all projects, so it must be built first.
 - for more details, see its [dedicated README](projects/_shared/README.md).
 
+**NOTE**: if you want to build all examples at once, you can run
+```bash
+./build-all-examples.bash
+```
+
 ### Available projects
 
 - [TypeScript with Farm](./projects/farm-ts/README.md)

build-all-examples.bash

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# This script builds all examples in the packages directory.
+# From the root of the repository, run " ./build-all-examples.bash"
+
+
+# Check for command line arguments
+LIST_SIZE_ONLY=false
+if [[ $# -gt 0 && "$1" == "--list-size-only" ]]; then
+  LIST_SIZE_ONLY=true
+fi
+
+if [ "$LIST_SIZE_ONLY" = true ]; then
+  echo "Skip building examples."
+else
+  echo "Building all examples..."
+
+  npm run build -w projects/_shared
+  npm run build --workspaces
+
+
+#  for dir in packages/ts-example* packages/js-example*; do
+#    if [ -d "$dir" ]; then
+#      echo
+#      echo "##################################################"
+#      echo "Building $dir"
+#      echo "##################################################"
+#      (cd "$dir" && npm run build)
+#    fi
+#  done
+
+  echo "All examples built successfully."
+fi
+
+
+for dir in projects/*; do
+  if [ -d "$dir" ]; then
+    echo
+    echo "##################################################"
+    echo "Files in $dir/dist directory:"
+    echo "##################################################"
+
+    if [ -d "$dir/dist" ]; then
+      # Find all JS files and display sizes with 2 decimal places
+      # Use 1000 to match Vite's size display
+      find "$dir/dist" -name "*.js" -type f -exec ls -l {} \; | LC_NUMERIC=C awk '{
+        # Convert bytes to KB with 2 decimal places
+        size_kb = $5 / 1000
+        printf "%.2f kB %s\n", size_kb, $9
+      }'
+    else
+      echo "No dist directory found in $dir"
+    fi
+  fi
+done
+

package-lock.json

@@ -4,9 +4,10 @@
   "type": "module",
   "scripts": {
     "dev": "parcel index.html",
-    "build": "tsc && parcel build --public-url ./ index.html"
+    "build": "tsc && del dist && parcel build --public-url ./ index.html"
   },
   "devDependencies": {
+    "del-cli": "~6.0.0",
     "parcel": "~2.15.0"
   }
 }