build-emscripten.sh

#!/bin/bash
set -eux

function assert_env_nonempty() {
  if [ "$#" -ne 2 ]; then
    echo "assert_env_nonempty: expected 2 arguments, got $#: $*"
    return 1
  fi

  if [ ".$1" = "." ]; then
    echo "shell env is empty"; echo $2
    return 1
  fi
}

assert_env_nonempty "$IMPLISOLID" "repo root"
assert_env_nonempty "$BUILD_LOCATION" "BUILD_LOCATION where compiled file wil be stored."
assert_env_nonempty "$LIB_FOLDER" "where to find C++ libraries"
# optional args:
    #  $MAIN_SOURCE_CPP_FILE "source.cpp path/filename"
    #  $TARGET_FILENAME "filename.compiled.js"
# pwd is not used

# sources:
#     LIB_FOLDER, MAIN_SOURCE_FOLDER
# targets:
#     BUILD_LOCATION

# See changelog docs/change-log.md , the Apr 18-19 2025 section.

function old_pattern() {
    IMPLISOLID=$IMPLISOLID source ./scripts/build_configuration.sh
    # output: BUILD_LOCATION,LIB_FOLDER
    assert_env_nonempty "$BUILD_LOCATION" "env-argument BUILD_LOCATION ..."
    assert_env_nonempty "$LIB_FOLDER" "env-argument LIB_FOLDER ..."
}

source $IMPLISOLID/scripts/bash-utils.sh

# Does not give you the folder, it tells you the name, that it wuol dbe in: found in, put in, etc.
mkdir -p $BUILD_LOCATION; ls $BUILD_LOCATION >/dev/null

export DEFAULT_MAIN_SOURCE_CPP_FILE="js_iteration_1/mcc2.cpp"
export DEFAULT_TARGET_FILENAME="mcc2.compiled.js"

#unfortunately it has to be one folder higher, becaausee both js_iteration_1 & ../js_iteration_2 are used.
export MAIN_SOURCE_FOLDER=$IMPLISOLID
# Main file is: at $MAIN_SOURCE_FOLDER/js_iteration_1/mcc2.cpp
export MAIN_SOURCE_CPP_FILE="${MAIN_SOURCE_CPP_FILE:-$DEFAULT_MAIN_SOURCE_CPP_FILE}"
export TARGET_FILENAME="${TARGET_FILENAME:-$DEFAULT_TARGET_FILENAME}"

echo "source file: $MAIN_SOURCE_CPP_FILE"
echo "target file: $TARGET_FILENAME"

expect_file  "$MAIN_SOURCE_FOLDER/$MAIN_SOURCE_CPP_FILE"

# Expect the following in $LIB_FOLDER
BOOST_SUBFOLDER="boost_1_75_0"
# old: boost_1_61_0
EIGEN_SUBFOLDER="eigen"
AUTODIFF_LIB_SUBFOLDER="autodiff"
# $LIB_FOLDER/autodiff/autodiff/forward/dual.hpp
# todo: rename: BOOST_SUBFOLDER -> BOOST_LIB_SUBFOLDER

expect_file  "$LIB_FOLDER/$BOOST_SUBFOLDER/boost/array.hpp"
expect_file  "$LIB_FOLDER/$EIGEN_SUBFOLDER/Eigen/src/Core/MatrixBase.h"
#expect_file "$LIB_FOLDER/$AUTODIFF_LIB_SUBFOLDER/autodiff/forward/dual.hpp"

# Mistake:
# Current state of source-code inclusion etc, expects a file `svd.cpp` here
# SVD_CPP="$LIB_VM/$EIGEN_SUBFOLDER/lapack/svd.cpp"
# SVD_CPP="$LIB_FOLDER/$EIGEN_SUBFOLDER/lapack/svd.cpp"
# echo $SVD_CPP
# Which is (exists) here!
 # NOT!
#expect_file "$LIB_FOLDER/$EIGEN_SUBFOLDER/lapack/svd.cpp"
# BTW, this bypasses Eigen? and uses directly the LAPACK?
# No!
# do not add to compiler flags:
#```bash
#        -I $LIB_VM/$EIGEN_SUBFOLDER/lapack \
#        # dont'!
#```
# Instead, we can use this:
# `js_iteration_2/svd.hpp`
# But this is an external file , so I moved it to:
# `lib-external/svd.hpp`
# and the #include "svd.cpp" Was replaced by #include <lib-external/svd.hpp>

# CMake-like shenanigans for explusiely adding to icnlcudes
# SHENANIGAN_INLCLUDES=
# I_SHENANIGANS="shenanigans"
# a build-local, not temp-local, and, not e2e-clone-local:
#
# Aiming at: /dataneura/3d/mp5-revival/mp5-private/implisolid/e2e-sandbox-temp/implisolid/build/lib/shenanigans
# "$LIB_FOLDER/$BOOST_SUBFOLDER/boost/array.hpp"
# an empty place for shenanigans:
export INLCLUDE_SHENANIGANS="shenanigans"
# create a view for a neat `#include <lib-external/svd.hpp>`

: || '
# absoute:
DIR3="$LIB_FOLDER/$INLCLUDE_SHENANIGANS/svd_hpp_view/lib-external"
mkdir -p "$DIR3"
ln -s "./lib-external/svd.hpp" "$DIR3/svd.hpp"
expect_file "$LIB_FOLDER/$INLCLUDE_SHENANIGANS/svd_hpp_view/lib-external/svd.hpp"
# relative to both $LIB_VM and $LIB_FOLDER, and redy for `-I` ing (compiler-flag):
RELATIVE_INCLUDE3="$INLCLUDE_SHENANIGANS/svd_hpp_view/lib-external"
#         -I $LIB_VM/$INLCLUDE_SHENANIGANS/svd_hpp_view/ \
expect_file "$LIB_FOLDER/$RELATIVE_INCLUDE3/lib-external/svd.hpp"
'

# Third `-I` flag: (-I's view)
# Does not have the `/lib_external` part.
export INCLUDE3_RELATIVE="$INLCLUDE_SHENANIGANS/svd.hpp__view"
mkdir -p "$LIB_FOLDER/$INCLUDE3_RELATIVE"

# filling contents:
mkdir -p "$LIB_FOLDER/$INCLUDE3_RELATIVE/lib_external"
# forced:
ln -s --force "$MAIN_SOURCE_FOLDER/lib_external/svd.hpp" "$LIB_FOLDER/$INCLUDE3_RELATIVE/lib_external/svd.hpp"
test -e "$MAIN_SOURCE_FOLDER/lib_external/svd.hpp"

# Ready for : `#include <lib_external/svd.hpp>`
expect_file "$LIB_FOLDER/$INCLUDE3_RELATIVE/lib_external/svd.hpp"

# LIB_FOLDER_VM
LIB_VM="/src-lib"
# MAIN_SOURCE_FOLDER_VM
MAIN_SRC_VM=/src
# BUILD_LOCATION_VM
BUILD_VM=/build




export OPTIM=1
export DEV=2
#export WORKER=3
#export BITCODE=4

# MODE=$DEV
MODE=$OPTIM

export WASM=0


if [ $MODE -eq $OPTIM ]
then

    echo "** optimised mode **"

#         -I $LIB_VM/$AUTODIFF_LIB_SUBFOLDER \

    export CLI_ARGS=" \
        -I $LIB_VM/$BOOST_SUBFOLDER \
        -I $LIB_VM/$EIGEN_SUBFOLDER \
        -I $LIB_VM/$INCLUDE3_RELATIVE \
        -O3   \
        -Oz \
        -DNDEBUG -DBOOST_UBLAS_NDEBUG -DBOOST_DISABLE_ASSERTS  \
        -s NO_EXIT_RUNTIME=1          \
        -Winline         \
        -s TOTAL_MEMORY=30146560    \
        -s ABORTING_MALLOC=0 \
        -s ALLOW_MEMORY_GROWTH=1 \
        -s DISABLE_EXCEPTION_CATCHING=0  \
        -s DEMANGLE_SUPPORT=1 \
        -Wno-dollar-in-identifier-extension \
        -pedantic -std=c++14 \
        -s WASM=0 \
        "

        # -s AGGRESSIVE_VARIABLE_ELIMINATION=1
        # -s OUTLINING_LIMIT=100000 \
fi

# Custom flags:
#    BUILD_AS_WORKER is defined by me.

if [ $MODE -eq $DEV ]
then

    echo "** dev compiling mode **"

#         -I $LIB_VM/$AUTODIFF_LIB_SUBFOLDER \

    export CLI_ARGS=" \
        -I $LIB_VM/$BOOST_SUBFOLDER  \
        -I $LIB_VM/$EIGEN_SUBFOLDER \
        -I $LIB_VM/$INCLUDE3_RELATIVE \
        -s TOTAL_MEMORY=30146560 \
        -s ABORTING_MALLOC=0 \
        -s NO_EXIT_RUNTIME=1 \
        -s DEMANGLE_SUPPORT=1 \
        -s ASSERTIONS=1 \
        -s BUILD_AS_WORKER=0 -DNOT_BUILD_AS_WORKER  \
        -DMORE_ABOUT_INFO='\"DEV\"'   \
        -Wno-dollar-in-identifier-extension \
        -pedantic -std=c++14 \
        -s WASM=0 \
        -s NO_DISABLE_EXCEPTION_CATCHING \
        "
        # -fexceptions \
fi

set -e

# tested on emscripten/emsdk:2.0.22
# tested on emscripten/emsdk:3.1.8  # detected a flaw
# tested on emscripten/emsdk:3.1.10
# tested on emscripten/emsdk:3.1.14 ( in 2025, for backwards)

DOCKERTAG="3.1.14"

EXPORTED_FUNCTIONS="['_main', '_build_geometry', '_get_v_size', '_get_f_size', '_get_f', '_get_v', '_finish_geometry', '_get_f_ptr', '_get_v_ptr',   '_set_object', '_unset_object', '_set_x', '_unset_x', '_calculate_implicit_values', '_get_values_ptr', '_get_values_size', '_calculate_implicit_gradients', '_get_gradients_ptr', '_get_gradients_size', '_get_pointset_ptr', '_get_pointset_size', '_build_geometry_u', '_about' ]"
#EXPORTED_FUNCTIONS="['_main', '_about', '_about2'  ]"
#EXPORTED_FUNCTIONS="['_main', '_about2'  ]"

docker run \
  --rm \
  -v $MAIN_SOURCE_FOLDER:$MAIN_SRC_VM \
  -v $LIB_FOLDER:$LIB_VM \
  -v $BUILD_LOCATION:$BUILD_VM \
  -u $(id -u):$(id -g) \
  emscripten/emsdk:$DOCKERTAG \
    emcc \
      $CLI_ARGS \
      -s EXPORTED_FUNCTIONS="$EXPORTED_FUNCTIONS" \
      -s EXTRA_EXPORTED_RUNTIME_METHODS='["ccall","cwrap"]' \
      $MAIN_SRC_VM/$MAIN_SOURCE_CPP_FILE \
      -o $BUILD_VM/$TARGET_FILENAME

# The compiled file can be found here:
ls "$BUILD_LOCATION/$TARGET_FILENAME"
expect_file  "$BUILD_LOCATION/$TARGET_FILENAME"

# todo:
# emcc: warning: EXTRA_EXPORTED_RUNTIME_METHODS is deprecated, please use EXPORTED_RUNTIME_METHODS instead [-Wdeprecated]

#
# More notes on usage of compiler
#
# docker run \
#  --rm \
#  -v $MAIN_SOURCE_FOLDER:$MAIN_SRC_VM \
#  -v $BUILD_LOCATION:$BUILD_VM \
#  -u $(id -u):$(id -g) \
#  emscripten/emsdk:$DOCKERTAG \
#
# emcc helloworld.cpp -o helloworld.js
# emcc mcc2.cpp  -o  ..$BUILD_VM/mcc2.compiled.js

# emcc?
# em++?
#emsdk list
#emsdk list --old
#   --profiling
# emar